Usare Spring Data con l'API Azure Cosmos DB per MongoDB

Questo articolo illustra la creazione di un'applicazione di esempio che usa Spring Data per archiviare e recuperare informazioni usando Azure Cosmos DB per MongoDB.

Prerequisiti

• Una sottoscrizione di Azure: creare un account gratuitamente.

• Java Development Kit (JDK), versione 8 o successiva.

• Apache Maven.

• Interfaccia della riga di comando di Azure.

• Un client Git.

Creare un account Azure Cosmos DB

Creare un account Azure Cosmos DB mediante il portale di Azure

1. Passare al portale di Azure all'indirizzo https://portal.azure.com/ ed eseguire l'accesso.

2. Selezionare Crea una risorsa, quindi Database, quindi Azure Cosmos DB.

3. Nella schermata Selezionare l'opzione API selezionare Azure Cosmos DB per MongoDB.

   

4. Specifica le e seguenti informazioni:

   • Sottoscrizione: specificare la sottoscrizione di Azure da usare.
   • Gruppo di risorse: specificare se creare un nuovo gruppo di risorse o scegliere un gruppo di risorse esistente.
   • Nome account: scegliere un nome univoco per l'account Azure Cosmos DB. Verrà usato per creare un nome di dominio completo, ad esempio wingtiptoysmongodb.documents.azure.com.
   • API: specificare per questa esercitazione Azure Cosmos DB for MongoDB API .
   • Località: specificare l'area geografica più vicina per il database.

5. Dopo aver immesso tutte le informazioni precedenti, fare clic su Rivedi e crea.

6. Se tutte le informazioni contenute nella pagina visualizzata risultano corrette, fare clic su Crea.

   

Recuperare la stringa di connessione per l'account Azure Cosmos DB

1. Passare al portale di Azure all'indirizzo https://portal.azure.com/ ed eseguire l'accesso.

2. Fare clic su Tutte le risorse e quindi sull'account Azure Cosmos DB appena creato.

3. Fare clic su Connessione stringhe di Connessione e copiare il valore per il campo Stringa di Connessione primaria. Questo valore verrà usato per configurare l'applicazione in un secondo momento.

   

Configurare l'applicazione di esempio

1. Aprire una shell dei comandi e clonare il progetto di esempio con un comando git come quello riportato nell'esempio seguente:

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

2. Creare una directory resources nella directory <radice progetto>/complete/src/main del progetto di esempio e quindi un file application.properties nella directory resources.

3. Aprire il file application.properties in un editor di testo e aggiungere le righe seguenti nel file, sostituendo i valori di esempio con i valori appropriati dei passaggi precedenti:

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

   Dove:

   Parametro	Descrizione
   spring.data.mongodb.database	Specifica il nome dell'account Azure Cosmos DB precedente in questo articolo.
   spring.data.mongodb.uri	Specifica il valore di Stringa di connessione primaria copiato in precedenza in questo articolo.

4. Salvare e chiudere il file application.properties.

Creare il pacchetto dell'applicazione di esempio e testarla

Per compilare l'applicazione, passare alla directory /gs-accessing-data-mongodb/complete, che contiene il file pom.xml .

1. Compilare l'applicazione di esempio con Maven e configurare Maven per ignorare i test. Ad esempio:

   mvn clean package -DskipTests
   

2. Avviare l'applicazione di esempio. Ad esempio:

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

   L'applicazione dovrebbe restituire valori come i seguenti:

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

Riepilogo

In questa esercitazione è stata creata un'applicazione Java di esempio che usa Spring Data per archiviare e recuperare informazioni usando Azure Cosmos DB per MongoDB.

Pulire le risorse

Quando le risorse create in questo articolo non sono più necessarie, usare il portale di Azure per eliminarle in modo da evitare addebiti imprevisti.

Passaggi successivi

Per altre informazioni su Spring e Azure, passare al centro di documentazione di Spring in Azure.

Vedi anche

Per altre informazioni sull'uso di Azure con Java, vedere Azure per sviluppatori Java e la documentazione relativa all'uso di Azure DevOps e Java.