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 el portal de Azure

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

2. Seleccione Crear un recurso, bases de datos y, a continuación, seleccione 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 elegir un grupo de recursos existente.
   • Nombre de cuenta: elija un nombre único para la cuenta de Azure Cosmos DB. Este nombre se usa 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 escriba toda la información anterior, seleccione Revisar y crear.

6. Si todo parece correcto en la página de revisión, seleccione 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 recursos y, a continuación, seleccione la cuenta de Azure Cosmos DB que creó.

3. Haga clic en Cadenas de conexión y copie el valor del campo Cadena de conexión principal . Use este 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. Por ejemplo:

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

2. Cree un directorio de recursos en el <directorio root>/complete/src/main del proyecto de ejemplo. A continuación, cree un archivo application.properties en el directorio resources .

3. Abra el archivo application.properties en un editor de texto. Agregue las líneas siguientes al 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 de 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 necesite los recursos, use el portal de Azure para eliminarlos. La eliminación de los recursos le ayuda a 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.

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.