Verwenden von Spring Data mit Azure Cosmos DB für die MongoDB-API

In diesem Artikel wird gezeigt, wie Sie eine Beispielanwendung erstellen, die Spring Data verwendet, um Informationen mithilfe von Azure Cosmos DB für MongoDB zu speichern und abzurufen.

Voraussetzungen

• Azure-Abonnement (kostenloses Abonnement erstellen)

• Java Development Kit (JDK), Version 8 oder höher.

• Apache Maven

• Azure-Befehlszeilenschnittstelle.

• Einen Git-Client

Erstellen eines Azure Cosmos DB-Kontos

Erstellen eines Azure Cosmos DB Kontos mithilfe des Azure Portals

1. Navigieren Sie zum Azure-Portal unter https://portal.azure.com/, und melden Sie sich an.

2. Wählen Sie "Ressource erstellen", wählen Sie "Datenbanken" und dann Azure Cosmos DB aus.

3. Wählen Sie auf dem Bildschirm API-Option auswählen die Option Azure Cosmos DB für MongoDB aus.

   

4. Geben Sie die folgenden Informationen an:

   • Abonnement: Geben Sie das Azure-Abonnement an, das Sie verwenden möchten.
   • Ressourcengruppe: Geben Sie an, ob eine neue Ressourcengruppe erstellt oder eine vorhandene Ressourcengruppe ausgewählt werden soll.
   • Kontoname: Wählen Sie einen eindeutigen Namen für Ihr Azure Cosmos DB Konto aus. Dieser Name wird verwendet, um einen vollqualifizierten Domänennamen wie wingtiptoysmongodb.documents.azure.com zu erstellen.
   • API: Geben Sie Azure Cosmos DB for MongoDB API für dieses Tutorial ein.
   • Standort: Geben Sie die nächstgelegene geografische Region für Ihre Datenbank an.

5. Wenn Sie alle vorherigen Informationen eingeben, wählen Sie "Überprüfen+ erstellen" aus.

6. Wenn alles auf der Rezensionsseite korrekt aussieht, wählen Sie "Erstellen" aus.

   

Abrufen der Verbindungszeichenfolge für das Azure Cosmos DB-Konto

1. Navigieren Sie zum Azure-Portal unter https://portal.azure.com/, und melden Sie sich an.

2. Klicken Sie auf "Alle Ressourcen", und wählen Sie dann das erstellte Azure Cosmos DB Konto aus.

3. Klicken Sie auf "Verbindungszeichenfolgen", und kopieren Sie den Wert für das Feld "Primäre Verbindungszeichenfolge ". Verwenden Sie diesen Wert, um Ihre Anwendung später zu konfigurieren.

   

Konfigurieren der Beispielanwendung

1. Öffnen Sie eine Befehlsshell, und klonen Sie das Beispielprojekt mithilfe eines Git-Befehls. Beispiel:

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

2. Erstellen Sie ein Ressourcenverzeichnis im <Projektstamm>/complete/src/main-Verzeichnis des Beispielprojekts. Erstellen Sie dann eine Application.properties-Datei im Ressourcenverzeichnis .

3. Öffnen Sie die Datei application.properties in einem Text-Editor. Fügen Sie der Datei die folgenden Zeilen hinzu, und ersetzen Sie die Beispielwerte durch die entsprechenden Werte aus früheren Versionen:

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

   Wo:

   Parameter	Beschreibung
   spring.data.mongodb.database	Der Name des Azure Cosmos DB-Kontos, das Sie weiter oben in diesem Artikel erstellt haben.
   spring.data.mongodb.uri	Die primäre Verbindungszeichenfolge, die Sie weiter oben in diesem Artikel kopiert haben

4. Speichern und schließen Sie die application.properties Datei.

Packen und Testen der Beispielanwendung

Um die Anwendung zu erstellen, wechseln Sie zum Verzeichnis "/gs-accessing-data-mongodb/complete", das die pom.xml Datei enthält.

1. Erstellen Sie die Beispielanwendung mit Maven, und konfigurieren Sie Maven, um Tests zu überspringen; Zum Beispiel:

   mvn clean package -DskipTests
   

2. Starten Sie die Beispielanwendung; Zum Beispiel:

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

   Ihre Anwendung sollte Werte wie die folgenden zurückgeben:

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

Zusammenfassung

In diesem Lernprogramm haben Sie ein Beispiel Java Anwendung erstellt, die Spring Data verwendet, um Informationen mithilfe von Azure Cosmos DB für MongoDB zu speichern und abzurufen.

Bereinigen von Ressourcen

Wenn Sie die Ressourcen nicht mehr benötigen, verwenden Sie das Azure Portal, um sie zu löschen. Durch das Löschen der Ressourcen können Sie unerwartete Gebühren vermeiden.

Nächste Schritte

Um mehr über Spring und Azure zu erfahren, fahren Sie mit dem Spring on Azure-Dokumentationscenter fort.

Weitere Informationen

Weitere Informationen zur Verwendung von Azure mit Java finden Sie unter Azure für Java-Entwickler und dem Arbeiten mit Azure DevOps und Java.