Utiliser Spring Data avec l’API Azure Cosmos DB pour MongoDB

Article
01/22/2025

Cet article illustre la création d’un exemple d’application qui utilise spring Data pour stocker et récupérer des informations à l’aide d'Azure Cosmos DB pour MongoDB.

Conditions préalables

Un abonnement Azure - en créer un gratuitement.
kit de développement Java (JDK), version 8 ou ultérieure.
Apache Maven.
Azure CLI.

Un client Git.

Créer un compte Azure Cosmos DB

Créer un compte Azure Cosmos DB à l’aide du portail Azure

Remarque

Vous pouvez lire des informations plus détaillées sur la création de comptes dans la documentation Azure Cosmos DB.

Accédez au portail Azure à https://portal.azure.com/ et connectez-vous.
Sélectionnez Créer une ressource, puis Bases de données, puis Azure Cosmos DB.
Dans l’écran Sélectionner l’API, sélectionnez Azure Cosmos DB pour MongoDB.
Spécifiez les informations suivantes :
- Abonnement: spécifiez votre abonnement Azure à utiliser.
- groupe de ressources: spécifiez s’il faut créer un groupe de ressources ou choisir un groupe de ressources existant.
- nom de compte: choisissez un nom unique pour votre compte Azure Cosmos DB ; cela sera utilisé pour créer un nom de domaine complet comme wingtiptoysmongodb.documents.azure.com.
- api: spécifiez Azure Cosmos DB for MongoDB API pour ce didacticiel.
- emplacement: spécifiez la région géographique la plus proche de votre base de données.
Après avoir entré toutes les informations ci-dessus, cliquez sur Vérifier + créer.
Si tout semble correct sur la page de révision, cliquez sur Créer.

Récupérer la chaîne de connexion de votre compte Azure Cosmos DB

Accédez au portail Azure à https://portal.azure.com/ et connectez-vous.
Cliquez sur Toutes les ressources, puis cliquez sur le compte Azure Cosmos DB que vous venez de créer.
Cliquez sur chaînes de connexion, puis copiez la valeur du champ chaîne de connexion principale ; vous utiliserez cette valeur pour configurer votre application ultérieurement.

Configurer l’exemple d’application

Ouvrez un interpréteur de commandes et clonez l’exemple de projet à l’aide d’une commande Git comme dans l’exemple suivant :
```
git clone https://github.com/spring-guides/gs-accessing-data-mongodb.git
```
Créez un répertoire ressources dans le répertoire racine du projet/complete/src/main de l'exemple de projet , puis créez un fichier application.properties dans le répertoire ressources.

Ouvrez le fichier application.properties dans un éditeur de texte, puis ajoutez les lignes suivantes dans le fichier, puis remplacez les exemples de valeurs par les valeurs appropriées de la version antérieure :

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

Où:

Paramètre	Description
`spring.data.mongodb.database`	Spécifie le nom de votre compte Azure Cosmos DB mentionné plus tôt dans cet article.
`spring.data.mongodb.uri`	Spécifie la chaîne de connexion principale mentionnée plus tôt dans cet article.

Enregistrez et fermez le fichier application.properties.

Empaqueter et tester l’exemple d’application

Pour générer l’application, accédez au répertoire /gs-accessing-data-mongodb/complete, qui contient le fichier pom.xml.

Générez l’exemple d’application avec Maven et configurez Maven pour ignorer les tests ; par exemple:
```
mvn clean package -DskipTests
```

Démarrez l’exemple d’application ; par exemple:


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

Votre application doit retourner des valeurs comme suit :

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

Résumé

Dans ce tutoriel, vous avez créé un exemple d’application Java qui utilise Spring Data pour stocker et récupérer des informations à l’aide d’Azure Cosmos DB pour MongoDB.

Nettoyer les ressources

Quand vous n’en avez plus besoin, utilisez le portail Azure pour supprimer les ressources créées dans cet article pour éviter des frais inattendus.

Étapes suivantes

Pour en savoir plus sur Spring et Azure, passez au centre de documentation Spring sur Azure.

Spring sur Azure

Voir aussi

Pour plus d’informations sur l’utilisation d’Azure avec Java, consultez les Azure pour développeurs Java et les Travailler avec Azure DevOps et Java.

Partager via