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.

Requisitos previos

  • 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 recurso, Bases de datos y, a continuación, seleccione Azure Cosmos DB.

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

  3. En la pantalla Seleccionar API , seleccione Azure Cosmos DB para MongoDB.

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

  4. Especifique la información siguiente:

    • 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; 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 escrito toda la información anterior, haga clic en Revisar y crear.

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

    Review your Azure Cosmos DB account settings.

Recuperación de la cadena de conexión para 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, después, haga clic en la cuenta de Azure Cosmos DB que acaba de crear.

  3. Haga clic en Conectar cadenas y copie el valor del campo Cadena de Conectar ion principal; usará ese valor para configurar la aplicación más adelante.

    Retrieve your Azure Cosmos DB connection string.

Configurar la aplicación de ejemplo

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

    git clone https://github.com/spring-guides/gs-accessing-data-mongodb.git
    
  2. Cree un directorio resources en el directorio <raíz del proyecto>/complete/src/main del proyecto de ejemplo y cree un archivo application.properties en el directorio resources.

  3. Abra el archivo application.properties en un editor de texto y agréguele las siguientes líneas; después, sustituya los valores de ejemplo por los valores adecuados que se mencionaron anteriormente:

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

    Donde:

    Parámetro Descripción
    spring.data.mongodb.database Especifica el nombre de la cuenta de Azure Cosmos DB anterior 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.

Empaquetado y prueba de 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. Cree la aplicación de ejemplo con Maven y configure Maven para omitir 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 similares a 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 lo necesite, use Azure Portal para eliminar los recursos creados en este artículo y evitar cargos inesperados.

Pasos siguientes

Para más información acerca de Spring y Azure, vaya al centro de documentación de Azure.

Consulte también

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