Spring Data használata a MongoDB API-hoz készült Azure Cosmos DB-vel

Ez a cikk egy mintaalkalmazás létrehozását mutatja be, amely Spring Data használatával tárol és kér le adatokat Azure Cosmos DB for MongoDBhasználatával.

Előfeltételek

• Azure-előfizetés – ingyenesen hozzon létre egyet.

• Java Development Kit (JDK), 8-os vagy újabb verzió.

• Apache Maven.

• Azure parancssori felület (CLI).

• Egy Git ügyfél.

Azure Cosmos DB-fiók létrehozása

Azure Cosmos DB-fiók létrehozása az Azure Portal használatával

Jegyzet

A fiókok létrehozásáról részletesebb információkat az Azure Cosmos DB dokumentációjábanolvashat.

1. Nyissa meg az Azure portált a https://portal.azure.com/ címen, és jelentkezzen be.

2. Válassza Erőforrás létrehozása, majd Adatbázisok, majd Azure Cosmos DB.

3. A API kiválasztása képernyőn válassza az Azure Cosmos DB-t a MongoDB-hez.

   

4. Adja meg a következő információkat:

   • Előfizetés: Adja meg a használni kívánt Azure előfizetést.
   • erőforráscsoport: Adja meg, hogy új erőforráscsoportot szeretne-e létrehozni, vagy válasszon egy meglévő erőforráscsoportot.
   • Fióknév: Válasszon egyedi nevet az Azure Cosmos DB-fiókhoz; ez a név egy teljesen minősített tartománynév létrehozására szolgál majd, mint például wingtiptoysmongodb.documents.azure.com.
   • API-: Adja meg a Azure Cosmos DB for MongoDB API az oktatóanyaghoz.
   • Hely: Adja meg az adatbázis legközelebbi földrajzi régióját.

5. A fenti információk megadása után kattintson a Véleményezés + létrehozásgombra.

6. Ha minden helyesnek tűnik a véleményezés oldalon, kattintson a létrehozása gombra.

   

Az Azure Cosmos DB-fiók kapcsolati sztringjének lekérése

1. Nyissa meg az Azure portált a https://portal.azure.com/ címen, és jelentkezzen be.

2. Kattintson a Minden erőforráselemre, majd a most létrehozott Azure Cosmos DB-fiókra.

3. Kattintson a Kapcsolati karakterláncokelemre, és másolja az elsődleges kapcsolati karakterlánc mező értékét; ezt az értéket az alkalmazás későbbi konfigurálásához fogja használni.

   

A mintaalkalmazás konfigurálása

1. Nyisson meg egy parancshéjat, és klónozza a mintaprojektet az alábbi példához hasonló Git-paranccsal:

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

2. Hozzon létre egy erőforrást könyvtárat a mintaprojekt <projekt gyökérkönyvtárában>/complete/src/main könyvtárban, és hozzon létre egy application.properties fájlt a resources könyvtárban.

3. Nyissa meg a application.properties fájlt egy szövegszerkesztőben, és adja hozzá a következő sorokat a fájlhoz, és cserélje le a mintaértékeket a korábbi megfelelő értékekre:

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

   Hol:

   Paraméter	Leírás
   spring.data.mongodb.database	A cikk korábbi részében szereplő Azure Cosmos DB-fiók nevét adja meg.
   spring.data.mongodb.uri	A cikk korábbi részében megadott elsődleges kapcsolati karakterláncot határozza meg.

4. Mentse és zárja be az application.properties fájlt.

A mintaalkalmazás csomagolása és tesztelése

Az alkalmazás létrehozásához keresse meg a /gs-accessing-data-mongodb/completekönyvtárat, amely tartalmazza a pom.xml fájlt.

1. Hozza létre a mintaalkalmazást a Mavennel, és konfigurálja a Mavent a tesztek kihagyására; például:

   mvn clean package -DskipTests
   

2. Indítsa el a mintaalkalmazást; például:

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

   Az alkalmazásnak az alábbihoz hasonló értékeket kell visszaadnia:

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

Összefoglalás

Ebben az oktatóanyagban létrehozott egy Java-mintaalkalmazást, amely a Spring Data használatával tárolja és kéri le az adatokat a MongoDB-hez készült Azure Cosmos DB használatával.

Erőforrások törlése

Ha már nincs rá szükség, a Azure Portal használatával törölheti a cikkben létrehozott erőforrásokat a váratlan költségek elkerülése érdekében.

Következő lépések

Ha többet szeretne megtudni a Springről és az Azure-ról, lépjen tovább a Spring on Azure dokumentációs központjába.

Tavasz az Azure-on

Lásd még:

Az Azure Javával való használatáról további információért lásd az Azure fejlesztőknek, valamint az Azure DevOps és Java együttműködésről szólócikket.