Spring Data gebruiken met Azure Cosmos DB voor MongoDB-API

Artikel
08/28/2024

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 Azure-abonnement (u kunt een gratis abonnement maken).
Java Development Kit (JDK), versie 8 of hoger.
Apache Maven.
Azure CLI.

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.

Ga naar de Azure-portal op https://portal.azure.com/ en meld u aan.
Selecteer Een resource maken en vervolgens Databases en vervolgens Azure Cosmos DB.
Selecteer Azure Cosmos DB voor MongoDB in het scherm API-optie selecteren.
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.
Wanneer u alle bovenstaande gegevens hebt ingevoerd, klikt u op Controleren en maken.
Als alles er goed uitziet op de beoordelingspagina, klikt u op Maken.

De verbindingsreeksen voor uw Azure Cosmos DB-account ophalen

Ga naar de Azure-portal op https://portal.azure.com/ en meld u aan.
Klik op Alle resources en klik vervolgens op het Azure Cosmos DB-account dat u zojuist hebt gemaakt.
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.

De voorbeeldtoepassing configureren

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
```
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.

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.

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.

Bouw de voorbeeldtoepassing met Maven, en configureer Maven om tests over te slaan. Bijvoorbeeld:
```
mvn clean package -DskipTests
```

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.

Delen via