Uso de Spring Data con Azure Cosmos DB para mongoDB API

En este artículo se muestra cómo crear una aplicación de ejemplo que usa Spring Data para almacenar y recuperar información mediante Azure Cosmos DB para MongoDB.

Prerrequisitos

• Una suscripción de Azure: crea una gratis.

• Java Development Kit (JDK), versión 8 o posterior.

• Apache Maven.

• CLI de Azure

• Un cliente Git.

Creación de una cuenta de Azure Cosmos DB

Creación de una cuenta de Azure Cosmos DB mediante Azure Portal

Nota

Puede leer información más detallada sobre la creación de cuentas en la documentación de Azure Cosmos DB.

1. Vaya a Azure Portal en https://portal.azure.com/ e inicie sesión.

2. Seleccione Crear un recursoy, después, Bases de datosy, después, azure Cosmos DB.

3. En la pantalla Seleccionar opción de API, seleccione Azure CosmosDB for MongoDB.

   

4. Especifique la siguiente información:

   • Suscripción: especifique la suscripción de Azure que se va a usar.
   • grupo de recursos: especifique si desea crear un nuevo grupo de recursos o elija un grupo de recursos existente.
   • Nombre de cuenta: elija un nombre único para la cuenta de Azure Cosmos DB; se usará para crear un nombre de dominio completo, como wingtiptoysmongodb.documents.azure.com.
   • API: especifique Azure Cosmos DB for MongoDB API para este tutorial.
   • Ubicación: especifique la región geográfica más cercana para la base de datos.

5. Cuando haya especificado toda la información anterior, haga clic en Revisar + crear.

6. Si todo parece correcto en la página de revisión, haga clic en Crear.

   

Recuperación de la cadena de conexión de la cuenta de Azure Cosmos DB

1. Vaya a Azure Portal en https://portal.azure.com/ e inicie sesión.

2. Haga clic en Todos los recursosy, a continuación, haga clic en la cuenta de Azure Cosmos DB que acaba de crear.

3. Haga clic en Cadenas de conexióny copie el valor del campo cadena de conexión principal ; Usará ese valor para configurar la aplicación más adelante.

   

Configuración de la aplicación de ejemplo

1. Abra un shell de comandos y clone el proyecto de ejemplo mediante un comando git como en el ejemplo siguiente:

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

2. Cree un directorio de recursos en el directorio raíz del proyecto <>/complete/src/main del proyecto de ejemplo. Cree un archivo application.properties en el directorio de recursos .

3. Abra el archivo application.properties en un editor de texto y agregue las líneas siguientes en el archivo y reemplace los valores de ejemplo por los valores adecuados de anteriormente:

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

   Dónde:

   Parámetro	Descripción
   spring.data.mongodb.database	Especifica el nombre de tu cuenta de Azure Cosmos DB mencionado anteriormente en este artículo.
   spring.data.mongodb.uri	Especifica la cadena de conexión principal que se mencionó anteriormente en este artículo.

4. Guarde y cierre el archivo application.properties.

Empaquetar y probar la aplicación de ejemplo

Para compilar la aplicación, vaya al directorio /gs-accessing-data-mongodb/complete, que contiene el archivo pom.xml.

1. Compile la aplicación de ejemplo con Maven y configure Maven para omitir las pruebas; por ejemplo:

   mvn clean package -DskipTests
   

2. Inicie la aplicación de ejemplo; por ejemplo:

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

   La aplicación debe devolver valores como los siguientes:

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

Resumen

En este tutorial, ha creado una aplicación java de ejemplo que usa Spring Data para almacenar y recuperar información mediante Azure Cosmos DB para MongoDB.

Limpieza de recursos

Cuando ya no sea necesario, use el Azure Portal para eliminar los recursos creados en este artículo para evitar cargos inesperados.

Pasos siguientes

Para más información sobre Spring y Azure, continúe con el Centro de documentación de Spring en Azure.

Spring en Azure

Consulte también

Para más información sobre el uso de Azure con Java, consulte Azure para desarrolladores de Java y Trabajo con Azure DevOps y Java.