Usar o Spring Data com a API do Azure Cosmos DB para MongoDB

Este artigo mostra como criar um aplicativo de exemplo que usa o Spring Data para armazenar e recuperar informações usando Azure Cosmos DB para MongoDB.

Pré-requisitos

  • Um cliente Git.

Criar uma conta do Azure Cosmos DB

Criar uma conta Azure Cosmos DB usando o portal Azure

Nota

Para obter mais informações sobre como criar contas, consulte a documentação do Azure Cosmos DB.

  1. Navegue até o portal do Azure em https://portal.azure.com/ e entre.

  2. Selecione Criar um recurso, selecione Bancos de Dados e selecione Azure Cosmos DB.

  3. Na tela Selecionar uma opção de API, escolha Azure Cosmos DB for MongoDB.

    Captura de tela da tela de opção Selecionar API do portal Azure com Azure Cosmos DB para MongoDB selecionada.

  4. Especifique as seguintes informações:

    • Assinatura: especifique sua assinatura do Azure a ser usada.
    • Grupo de recursos: especifique se deseja criar um novo grupo de recursos ou escolher um grupo de recursos existente.
    • Nome da conta: escolha um nome exclusivo para sua conta Azure Cosmos DB. Esse nome é usado para criar um nome de domínio totalmente qualificado como wingtiptoysmongodb.documents.azure.com.
    • API: especifique Azure Cosmos DB for MongoDB API para este tutorial.
    • Local: especifique a região geográfica mais próxima do banco de dados.

  5. Ao inserir todas as informações anteriores, selecione Examinar + criar.

  6. Se tudo estiver correto na página de revisão, selecione Criar.

    Captura de tela da página de revisão mostrando as configurações da conta Azure Cosmos DB antes da criação.

Recuperar a cadeia de conexão para sua conta do Azure Cosmos DB

  1. Navegue até o portal do Azure em https://portal.azure.com/ e entre.

  2. Clique em Todos os Recursos e selecione a conta Azure Cosmos DB que você criou.

  3. Clique em cadeias de conexão e copie o valor do campo Cadeia de Conexão Primária . Use esse valor para configurar seu aplicativo mais tarde.

    Captura de tela da página Cadeias de conexão mostrando a cadeia de conexão primária da conta Azure Cosmos DB.

Configurar o aplicativo de exemplo

  1. Abra um shell de comando e clone o projeto de exemplo usando um comando git. Por exemplo:

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

  2. Crie um diretório de recursos no <diretório raiz>/completo/src/principal do projeto de exemplo. Em seguida, crie um arquivo application.properties no diretório de recursos .

  3. Abra o arquivo application.properties em um editor de texto. Adicione as seguintes linhas ao arquivo e substitua os valores de exemplo pelos valores apropriados anteriormente:

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

    Em que:

    Parâmetro Descrição
    spring.data.mongodb.database Especifica o nome da sua conta do Azure Cosmos DB mencionado anteriormente neste artigo.
    spring.data.mongodb.uri Especifica a Cadeia de conexão primária referida anteriormente neste artigo.

  4. Salve e feche o arquivo application.properties.

Empacotar e testar o aplicativo de exemplo

Para compilar o aplicativo, acesse o diretório /gs-accessing-data-mongodb/complete, que contém o arquivo pom.xml .

  1. Crie o aplicativo de exemplo com o Maven e configure o Maven para ignorar testes; por exemplo:

    mvn clean package -DskipTests

  2. Inicie o aplicativo de exemplo; por exemplo:

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

    Seu aplicativo deve retornar valores como o seguinte:

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

Resumo

Neste tutorial, você criou um aplicativo de Java de exemplo que usa o Spring Data para armazenar e recuperar informações usando Azure Cosmos DB para MongoDB.

Limpar recursos

Quando você não precisar mais dos recursos, use o portal Azure para excluí-los. Excluir os recursos ajuda você a evitar encargos inesperados.

Próximas etapas

Para saber mais sobre o Spring e o Azure, prossiga para o centro de documentação do Spring on Azure.

Spring no Azure

Consulte também

Para obter mais informações sobre como usar o Azure com Java, consulte Azure para Desenvolvedores Java e Trabalhando com o Azure DevOps e Java.

  • Última atualização em