Primeiros passos com o driver Java

Visão geral

O driver Java é uma API síncrona que você pode usar para interagir com o MongoDB a partir do seu aplicação Java . Este guia mostra como criar um aplicação que usa o driver Java para se conectar a um cluster MongoDB hospedado no MongoDB Atlas e consultar dados em seu cluster.

Siga este tutorial para conectar um aplicação Java de amostra a um sistema do MongoDB Atlas . O tutorial inclui as seguintes seções:

• Download e instalação: saiba como instalar o driver Java .

• Criar um MongoDB deployment: Aprenda como criar um MongoDB deployment gratuito no Atlas.

• Criar uma connection string: Saiba como recuperar a string de conexão do sistema do Atlas.

• Criar um MongoClient: saiba como criar um aplicação que se conecte ao MongoDB e consulte os dados armazenados em seu sistema.

Se você preferir se conectar ao MongoDB usando um driver ou linguagem de programação diferente, consulte nossa lista de drivers oficiais.

Baixar e instalar

Conclua as etapas a seguir para instalar o driver Java e suas dependências em seu ambiente de desenvolvimento.

<dependencies>
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>mongodb-driver-sync</artifactId>
        <version>5.4.0</version>
    </dependency>
</dependencies>

dependencies {
  implementation 'org.mongodb:mongodb-driver-sync:5.4.0'
}

Depois de concluir estas etapas, você tem um novo projeto e as dependências do driver instaladas.

Criar uma MongoDB deployment

Você pode criar uma implantação MongoDB de camada gratuita no MongoDB Atlas para armazenar e gerenciar seus dados. O MongoDB Atlas hospeda e gerencia seu banco de dados MongoDB na nuvem.

Depois de concluir essas etapas, você terá uma nova implantação do MongoDB de camada grátis no Atlas, credenciais de usuário do banco de dados e dados de amostra carregados no seu banco de dados.

Criar uma connection string

Você pode se conectar à sua implantação do MongoDB fornecendo um URI de conexão, também chamado de connection string, que instrui o driver sobre como se conectar a uma implantação do MongoDB e como se comportar enquanto estiver conectado.

A cadeia de conexão inclui o nome do host ou endereço IP e porta de sua implantação, o mecanismo de autenticação, as credenciais do usuário quando aplicável, e opções de conexão.

1

Encontre sua string de conexão do MongoDB Atlas

Para recuperar a string de conexão da implantação criada na etapa anterior, faça login na sua conta do Atlas e navegue até a seção Clusters. Clique no botão Connect para sua nova implantação, como mostrado na seguinte captura de tela:

Em seguida, vá para a seção Connect your application. Selecione "Java" no menu de seleção Driver e a versão que melhor corresponde à versão instalada no menu de seleção Version.

2

Copie a string de conexão

Clique no botão à direita da string de conexão para copiá-la para a área de transferência, como mostrado na seguinte captura de tela:

3

Editar seus espaços reservados para string de conexão

Cole sua string de conexão em um arquivo no editor de texto de sua preferência e salve este arquivo em um local seguro para uso posterior. Na string de conexão, substitua os espaços reservados <db_username> e <db_password> pelo nome de usuário e senha do usuário do banco de dados .

Depois de concluir essas etapas, você terá uma string de conexão que contém o nome de usuário e a senha do banco de dados.

Executar uma query de amostra

Depois de recuperar a string de conexão para sua implantação do MongoDB Atlas , você pode se conectar à implantação a partir do seu aplicação Java e consultar os conjuntos de dados de amostra do Atlas .

import static com.mongodb.client.model.Filters.eq;
import org.bson.Document;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
public class QuickStart {
    public static void main( String[] args ) {
        // Replace the placeholder with your MongoDB deployment's connection string
        String uri = "<connection string uri>";
        try (MongoClient mongoClient = MongoClients.create(uri)) {
            MongoDatabase database = mongoClient.getDatabase("sample_mflix");
            MongoCollection<Document> collection = database.getCollection("movies");
            Document doc = collection.find(eq("title", "Back to the Future")).first();
            if (doc != null) {
                System.out.println(doc.toJson());
            } else {
                System.out.println("No matching documents found.");
            }
        }
    }
}

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}

javax.net.ssl.SSLHandshakeException: extension (5) should not be presented in certificate_request

Depois de concluir essas etapas, você tem um aplicação Java que se conecta à implementação do MongoDB , executa uma query nos dados de amostra e retorna um documento correspondente.

Próximos passos

Parabéns por concluir o tutorial!

Neste tutorial, você criou um aplicação de driver Java que se conecta a um sistema MongoDB hospedado no MongoDB Atlas e recupera um documento que corresponde a uma query.

Você pode continuar desenvolvendo seu aplicação de amostra acessando os seguintes guias:

• Bancos de dados e coleções: saiba mais sobre como interagir com bancos de dados e coleções do MongoDB.

• Integrações de terceiros: saiba mais sobre as integrações de terceiros que você pode usar com o driver Java.