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

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

Prérequis

  • Un client Git.

Création d’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.

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

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

    Azure portal, create a resource, search for Azure Cosmos DB.

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

    Azure portal, create a resource, select API option, Azure Cosmos DB for MongoDB selected.

  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. 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.
  5. Lorsque vous avez entré toutes les informations ci-dessus, cliquez sur Vérifier + créer.

  6. Si tout semble correct, cliquez sur Créer.

    Review your Azure Cosmos DB account settings.

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

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

  2. Cliquez sur Toutes les ressources, puis sur le compte Azure Cosmos DB que vous venez de créer.

  3. Cliquez sur Connecter chaînes d’ion, puis copiez la valeur du champ Chaîne de Connecter ion primaire . Vous utiliserez cette valeur pour configurer votre application ultérieurement.

    Retrieve your Azure Cosmos DB connection string.

Configurer l’exemple d’application

  1. 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
    
  2. Créez un répertoire resources dans le répertoire <project root>/complete/src/main de l’exemple de projet, puis créez un fichier application.properties dans le répertoire resources.

  3. Ouvrez le fichier application.properties dans un éditeur de texte, ajoutez les lignes suivantes dans le fichier et remplacez les exemples de valeurs 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 Description
    spring.data.mongodb.database Spécifie le nom de votre compte Azure Cosmos DB précédemment dans cet article.
    spring.data.mongodb.uri Spécifie la chaîne de connexion principale mentionnée plus haut dans cet article.
  4. Enregistrez et fermez le fichier application.properties.

Packager 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. Compilez 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 :

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

    Votre application doit renvoyer 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 des ressources créées dans le cadre de cet article, utilisez le portail Azure pour les supprimer afin d’éviter des frais imprévus.

Étapes suivantes

Pour en savoir plus sur Spring et Azure, poursuivez vers le centre de documentation Spring sur Azure.

Voir aussi

Pour plus d’informations sur l’utilisation d’Azure avec Java, renseignez-vous sur Azure pour les développeurs Java et l’utilisation d’Azure DevOps et Java.