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

Este artigo mostra como criar uma aplicação de exemplo que utiliza o Spring Data para armazenar e recuperar informação utilizando o Azure Cosmos DB para MongoDB.

Pré-requisitos

• Uma assinatura do Azure - crie uma gratuitamente.

• Java Development Kit (JDK), versão 8 ou superior.

• Apache Maven.

• CLI do Azure.

• Um cliente Git .

Criar uma conta do Azure Cosmos DB

Crie uma conta Azure Cosmos DB usando o portal Azure

Observação

Para 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 Bases de Dados e depois selecione Azure Cosmos DB.

3. No ecrã da opção Selecionar API, selecione Azure Cosmos DB para MongoDB.

   

4. Especifique as seguintes informações:

   • Subscrição: Especifique a subscrição do Azure que pretende utilizar.
   • Grupo de recursos: Especifique se deve criar um novo grupo de recursos ou escolher um grupo de recursos existente.
   • Nome da conta: Escolha um nome único para a sua conta Azure Cosmos DB. Este nome é usado para criar um domínio totalmente qualificado como wingtiptoysmongodb.documents.azure.com.
   • API: Especifique Azure Cosmos DB for MongoDB API para este tutorial.
   • Localização: Especifique a região geográfica mais próxima para o seu banco de dados.

5. Depois de introduzir todas as informações anteriores, selecione Rever e criar.

6. Se tudo parecer correto na página de avaliação, selecione Criar.

   

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. Clica em Todos os Recursos e depois seleciona a conta Azure Cosmos DB que criaste.

3. Clique em Strings de Ligação e copie o valor do campo String de Conexão Primária. Use este valor para configurar a sua aplicação mais tarde.

   

Configurar o aplicativo de exemplo

1. Abre um shell de comandos e clona 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> do projeto/complete/src/main do projeto de exemplo. Depois, crie um ficheiro application.properties no diretório de recursos .

3. Abra o ficheiro application.properties num editor de texto. Adicione as seguintes linhas ao ficheiro e substitua os valores de amostra pelos valores apropriados de antes:

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

   Onde:

   Parâmetro	Descrição
   spring.data.mongodb.database	Especifica o nome da sua conta do Azure Cosmos DB do início deste artigo.
   spring.data.mongodb.uri	Especifica a Cadeia de Conexão Primária de mais acima neste artigo.

4. Salve e feche o ficheiro application.properties.

Empacotar e testar o aplicativo de exemplo

Para construir a aplicação, vá ao diretório /gs-accessing-data-mongodb/complete, que contém o ficheiropom.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 os seguintes:

   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, criaste uma aplicação Java de exemplo que usa Spring Data para armazenar e recuperar informação usando o Azure Cosmos DB para o MongoDB.

Limpar recursos

Quando já não precisares dos recursos, usa o portal do Azure para os apagar. Eliminar os recursos ajuda-o a evitar cobranças inesperadas.

Próximos passos

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

Primavera no Azure

Ver também

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