Spring Data gebruiken met Azure Cosmos DB voor MongoDB-API

  • Artikel

Dit artikel laat zien hoe u een voorbeeldtoepassing maakt die Spring Data gebruikt om informatie op te slaan en op te halen met behulp van Azure Cosmos DB voor MongoDB.

Vereisten

  • Een Git-client.

Een Azure Cosmos DB-account maken

Een Azure Cosmos DB-account maken in Azure Portal

Notitie

Meer gedetailleerde informatie over het maken van accounts vindt u in de Documentatie van Azure Cosmos DB.

  1. Ga naar de Azure-portal op https://portal.azure.com/ en meld u aan.

  2. Selecteer Een resource maken en vervolgens Databases en vervolgens Azure Cosmos DB.

  3. Selecteer Azure Cosmos DB voor MongoDB in het scherm API-optie selecteren.

    Azure Portal, maak een resource, selecteer API-optie, Azure Cosmos DB voor MongoDB geselecteerd.

  4. Geef de volgende informatie op:

    • Abonnement: geef uw Azure-abonnement op dat u wilt gebruiken.
    • Resourcegroep: geef op of u een nieuwe resourcegroep wilt maken of een bestaande resourcegroep wilt kiezen.
    • Accountnaam: Kies een unieke naam voor uw Azure Cosmos DB-account. Dit wordt gebruikt om een volledig gekwalificeerde domeinnaam te maken, zoals wingtiptoysmongodb.documents.azure.com.
    • API: Geef Azure Cosmos DB for MongoDB API op voor deze zelfstudie.
    • Locatie: Geef de dichtstbijzijnde geografische regio voor uw database op.

  5. Wanneer u alle bovenstaande gegevens hebt ingevoerd, klikt u op Controleren en maken.

  6. Als alles er goed uitziet op de beoordelingspagina, klikt u op Maken.

    Controleer de instellingen van uw Azure Cosmos DB-account.

De verbindingsreeksen voor uw Azure Cosmos DB-account ophalen

  1. Ga naar de Azure-portal op https://portal.azure.com/ en meld u aan.

  2. Klik op Alle resources en klik vervolgens op het Azure Cosmos DB-account dat u zojuist hebt gemaakt.

  3. Klik op Verbinding maken iontekenreeksen en kopieer de waarde voor het veld Primaire Verbinding maken iontekenreeks. U gebruikt deze waarde om de toepassing later te configureren.

    Haal uw Azure Cosmos DB-verbindingsreeks op.

De voorbeeldtoepassing configureren

  1. Open een opdrachtshell en kloon het voorbeeldproject met een Git-opdracht zoals in het volgende voorbeeld:

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

  2. Maak een resources-directory in de directory <hoofdmap project>/complete/src/main van het voorbeeldproject, en maak een bestand met de naam application.properties in de resources-directory.

  3. Open het bestand application.properties in een teksteditor en voeg de volgende regels in het bestand toe, waarbij u de voorbeeldwaarden vervangt door de eerder genoemde juiste waarden:

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

    Hierin:

    Parameter Description
    spring.data.mongodb.database Hiermee geeft u de naam van uw Azure Cosmos DB-account op van eerder in dit artikel.
    spring.data.mongodb.uri Hiermee geeft u de primaire verbindingsreeks van eerder in dit artikel op.

  4. Sla het bestand application.properties op en sluit het.

De voorbeeldtoepassing inpakken en testen

Als u de toepassing wilt bouwen, bladert u naar de map /gs-accessing-data-mongodb/complete, die het pom.xml-bestand bevat.

  1. Bouw de voorbeeldtoepassing met Maven, en configureer Maven om tests over te slaan. Bijvoorbeeld:

    mvn clean package -DskipTests

  2. Start de voorbeeldtoepassing, bijvoorbeeld:

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

    Uw toepassing moet waarden als volgt retourneren:

    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']

Samenvatting

In deze zelfstudie hebt u een Java-voorbeeldtoepassing gemaakt die Spring Data gebruikt om informatie op te slaan en op te halen met behulp van Azure Cosmos DB voor MongoDB.

Resources opschonen

Als u de resources die in dit artikel zijn gemaakt niet meer nodig hebt, gebruikt u Azure Portal om deze te verwijderen om onverwachte kosten te voorkomen.

Volgende stappen

Voor meer informatie over Spring en Azure gaat u door naar het documentatiecentrum van Spring op Azure.

Spring in Azure

Zie ook

Voor meer informatie over het gebruik van Azure met Java raadpleegt u de artikelen Azure voor Java-ontwikkelaars en de Werken met Azure DevOps en Java.