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

Cet article explique comment créer un exemple d’application qui utilise Spring Data pour stocker et récupérer des informations à l’aide de Azure Cosmos DB pour MongoDB.

Conditions préalables

  • Un client Git.

Créer un compte Azure Cosmos DB

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

Remarque

Pour plus d’informations sur la création de comptes, consultez la documentation Azure Cosmos DB.

  1. Accédez au portail Azure à https://portal.azure.com/ et connectez-vous.

  2. Sélectionnez Créer une ressource, sélectionnez Bases de données, puis Azure Cosmos DB.

  3. Dans l’écran Sélectionner l’API, sélectionnez Azure Cosmos DB pour MongoDB.

    Capture d’écran de l’écran de l’option Sélectionner l’API du portail Azure avec Azure Cosmos DB pour MongoDB sélectionnée.

  4. 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 du compte : choisissez un nom unique pour votre compte Azure Cosmos DB. Ce nom est 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.

  5. Lorsque vous entrez toutes les informations précédentes, sélectionnez Vérifier + créer.

  6. Si tout semble correct sur la page de révision, sélectionnez Créer.

    Capture d’écran de la page de révision montrant les paramètres du compte Azure Cosmos DB avant la création.

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

  1. Accédez au portail Azure à https://portal.azure.com/ et connectez-vous.

  2. Cliquez sur Toutes les ressources, puis sélectionnez le compte Azure Cosmos DB que vous avez créé.

  3. Cliquez sur Chaînes de connexion, puis copiez la valeur du champ Chaîne de connexion principale . Utilisez cette valeur pour configurer votre application ultérieurement.

    Capture d’écran de la page Chaînes de connexion montrant la chaîne de connexion principale du compte Azure Cosmos DB.

Configurer l’exemple d’application

  1. Ouvrez un interpréteur de commandes et clonez l’exemple de projet à l’aide d’une commande Git. Par exemple:

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

  2. Créez un répertoire de ressources dans le <répertoire racine>/complete/src/main de l’exemple de projet. Ensuite, créez un fichier application.properties dans le répertoire des ressources .

  3. Ouvrez le fichier application.properties dans un éditeur de texte. Ajoutez les lignes suivantes au fichier et remplacez les valeurs d’exemple par les valeurs appropriées mentionnées précédemment :

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

    Où:

    Paramètre Descriptif
    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.

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

  1. Générez l’exemple d’application avec Maven et configurez Maven pour ignorer les tests ; par exemple:

    mvn clean package -DskipTests

  2. 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 de Azure Cosmos DB pour MongoDB.

Nettoyer les ressources

Lorsque vous n’avez plus besoin des ressources, utilisez le portail Azure pour les supprimer. La suppression des ressources vous permet d’é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.

  • Last updated on