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

  • Articolo

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

  • Un client Git.

Creare un account Azure Cosmos DB

Creare un account Azure Cosmos DB mediante il portale di Azure

Nota

Per altre informazioni dettagliate sulla creazione di account, vedere la documentazione di Azure Cosmos DB.

  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.

    portale di Azure creare una risorsa, selezionare l'opzione API, Azure Cosmos DB per MongoDB selezionato.

  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.

    Esaminare le impostazioni dell'account Azure Cosmos DB.

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.

    Recuperare i stringa di connessione di Azure Cosmos DB.

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.

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.