Použití Spring Data se službou Azure Cosmos DB pro rozhraní MongoDB API

  • Článek

Tento článek ukazuje vytvoření ukázkové aplikace, která používá Spring Data k ukládání a načítání informací pomocí služby Azure Cosmos DB pro MongoDB.

Požadavky

Vytvoření účtu služby Azure Cosmos DB

Vytvoření účtu služby Azure Cosmos DB pomocí webu Azure Portal

Poznámka:

Podrobnější informace o vytváření účtů najdete v dokumentaci ke službě Azure Cosmos DB.

  1. Přejděte na Azure Portal na adrese https://portal.azure.com/ a přihlaste se.

  2. Vyberte Vytvořit prostředek a potom Databáze a Pak Azure Cosmos DB.

    Azure portal, create a resource, search for Azure Cosmos DB.

  3. Na obrazovce Vybrat rozhraní API vyberte Azure Cosmos DB pro MongoDB.

    Azure portal, create a resource, select API option, Azure Cosmos DB for MongoDB selected.

  4. Zadejte tyto informace:

    • Předplatné: Zadejte své předplatné Azure, které se má použít.
    • Skupina prostředků: Určete, jestli chcete vytvořit novou skupinu prostředků, nebo zvolte existující skupinu prostředků.
    • Název účtu: Zvolte jedinečný název účtu služby Azure Cosmos DB. Použije se k vytvoření plně kvalifikovaného názvu domény, jako je wingtiptoysmongodb.documents.azure.com.
    • Rozhraní API: Zadejte Azure Cosmos DB for MongoDB API pro tento kurz.
    • Umístění: Zadejte nejbližší geografickou oblast pro vaši databázi.

  5. Po zadání všech výše uvedených informací klikněte na Zkontrolovat a vytvořit.

  6. Pokud na stránce Kontrola vypadá vše správně, klikněte na Vytvořit.

    Review your Azure Cosmos DB account settings.

Načtení připojovacího řetězce pro váš účet služby Azure Cosmos DB

  1. Přejděte na Azure Portal na adrese https://portal.azure.com/ a přihlaste se.

  2. Klikněte na Všechny prostředky a pak na účet služby Azure Cosmos DB, který jste právě vytvořili.

  3. Klikněte na Připojení ionové řetězce a zkopírujte hodnotu pole Primary Připojení ion String. Tuto hodnotu použijete ke konfiguraci aplikace později.

    Retrieve your Azure Cosmos DB connection string.

Konfigurace ukázkové aplikace

  1. Otevřete příkazové prostředí a naklonujte ukázkový projekt pomocí příkazu git, který se bude podobat následujícímu příkladu:

    git clone https://github.com/spring-guides/gs-accessing-data-mongodb.git

  2. V adresáři <kořenový_adresář_projektu>/complete/src/main ukázkového projektu vytvořte adresář resources a v adresáři resources vytvořte soubor application.properties.

  3. Otevřete soubor application.properties v textovém editoru a přidejte do něj následující řádky, přičemž nahraďte ukázkové hodnoty odpovídajícími hodnotami z předchozího postupu:

    spring.data.mongodb.database=wingtiptoysmongodb
spring.data.mongodb.uri=mongodb://wingtiptoysmongodb:AbCdEfGhIjKlMnOpQrStUvWxYz==@wingtiptoysmongodb.documents.azure.com:10255/?ssl=true&replicaSet=globaldb

    Kde:

    Parametr Popis
    spring.data.mongodb.database Určuje název účtu služby Azure Cosmos DB z dřívější části tohoto článku.
    spring.data.mongodb.uri Určuje Primární připojovací řetězec z dřívější části tohoto článku.

  4. Uložte a zavřete soubor application.properties.

Zabalení a otestování ukázkové aplikace

Pokud chcete sestavit aplikaci, přejděte do adresáře /gs-accessing-data-mongodb/complete, který obsahuje soubor pom.xml .

  1. Sestavte ukázkovou aplikaci pomocí Mavenu a nakonfigurujte Maven tak, aby přeskočil testy. Například:

    mvn clean package -DskipTests

  2. Spusťte ukázkovou aplikaci. Například:

    
java -jar target/accessing-data-mongodb-complete-0.0.1-SNAPSHOT.jar

    Vaše aplikace by měla vrátit hodnoty podobné následujícím:

    Customers found with findAll():
-------------------------------
Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']

Customer found with findByFirstName('Alice'):
--------------------------------
Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
Customers found with findByLastName('Smith'):
--------------------------------
Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']

Shrnutí

V tomto kurzu jste vytvořili ukázkovou aplikaci Java, která používá Spring Data k ukládání a načítání informací pomocí služby Azure Cosmos DB pro MongoDB.

Vyčištění prostředků

Až už je nebudete potřebovat, odstraňte na webu Azure Portal prostředky vytvořené v tomto článku, aby se vám neúčtovaly poplatky.

Další kroky

Pokud se chcete dozvědět více o architektuře Spring a Azure, přejděte do centra dokumentace Spring v Azure.

Spring v Azure

Viz také

Další informace o používání Javy v Azure najdete na webech Azure pro vývojáře v Javě a Práce s Azure DevOps a Javou.