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

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

Požadavky

• Předplatné Azure – vytvořte si ho zdarma.

• Java Development Kit (JDK), verze 8 nebo vyšší.

• Apache Maven.

• Azure CLI.

• Klient Gitu .

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 web Azure Portal na https://portal.azure.com/ a přihlaste se.

2. Vyberte Vytvořit prostředek, poté Databáze, poté Azure Cosmos DB.

3. Na obrazovce Vyberte rozhraní API vyberte Azure Cosmos DB for MongoDB .

   

4. Zadejte následující informace:

   • předplatné: Zadejte své předplatné Azure, které chcete použít.
   • skupina prostředků: Určete, jestli se má vytvořit nová skupina prostředků, nebo zvolit 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 tutoriál.
   • 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 revize vypadá všechno správně, klikněte na Vytvořit.

   

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

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

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

3. Klikněte na Připojovací řetězcea zkopírujte hodnotu pro pole primárního připojovacího řetězce; Tuto hodnotu použijete k pozdější konfiguraci aplikace.

   

Konfigurace ukázkové aplikace

1. Otevřete příkazové prostředí a naklonujte ukázkový projekt pomocí příkazu Git, například v následujícím příkladu:

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

2. V kořenovémadresáři projektu /complete/src/main ukázkového projektu vytvořte adresář prostředků a v adresáři zdroje vytvořte soubor application.properties.

3. Otevřete soubor application.properties v textovém editoru a přidejte do souboru následující řádky a nahraďte ukázkové hodnoty příslušnými hodnotami z dřívějších hodnot:

   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 uvedený dříve v tomto článku.

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

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

Aplikaci sestavíte tak, že přejdete 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čí 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
   

   Aplikace by měla vracet hodnoty jako následující:

   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čistěte prostředky

Pokud už je nepotřebujete, pomocí webu Azure Portal odstraňte prostředky vytvořené v tomto článku, abyste se vyhnuli neočekávaným poplatkům.

Další kroky

Další informace o Springu a Azure najdete v centru dokumentace Spring on Azure.

Spring na Azure

Viz také

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