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í služby Azure Cosmos DB pro MongoDB.

Požadavky

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

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

• Apache Maven

• Rozhraní příkazového řádku Azure.

• Klient Git

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.

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

   

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.

   

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.

   

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.