Construtores

Visão geral

Esta seção inclui guias sobre como usar cada um dos construtores disponíveis e demonstra a utilidade que as classes de construtores de drivers do MongoDB Java fornecem.

O driver Java fornece classes para simplificar o processo para os desenvolvedores usarem operações CRUD e a API de agregação. Os métodos utilitários estáticos permitem criar uma query com mais eficiência.

Por que usar o Builders?

Usando a classe de construtores, você aproveita o poder de:

• O compilador Java e o IDE para encontrar erros durante o desenvolvimento

• O IDE para descoberta e conclusão de código

Ao usar construtores, o compilador Java e o IDE detectam erros, como operadores com erros ortográficos, desde o início. Ao usar o shell do MongoDB ou o Java simples, você escreve operadores como strings e não recebe nenhum sinal visual de um problema, enviando esses erros para o tempo de execução em vez de compilar

Com as classes construtores, você escreve operadores como métodos. O IDE sublinha instantaneamente e mostra uma barra vermelha à direita indicando que algo está errado. Durante o desenvolvimento, o IDE também mostra os métodos que você pode usar. Ele completa automaticamente seu código com parâmetros de espaço reservado quando você seleciona qual método deseja usar.

Cenário

Imagine que queremos enviar um e-mail de marketing a todos os usuários em nossa collection users com os seguintes critérios:

• Usuários que se identificam como gênero "Feminino"

• Usuários com mais de "29"

Queremos apenas o endereço de e-mail deles, por isso queremos garantir que nossa consulta não retorne dados pelos quais pagamos custos de largura de banda, mas de que não precisamos.

collection.find({ "gender": "female", "age" : { "$gt": 29 }}, { "_id": 0, "email": 1 })

Bson filter = new Document().append("gender", "female").append("age", new Document().append("$gt", 29));
Bson projection = new Document().append("_id", 0).append("email", 1);
collection.find(filter).projection(projection);

import static com.mongodb.client.model.Filters.*;
import static com.mongodb.client.model.Projections.*;
...
Bson filter = and(eq("gender", "female"), gt("age", 29));
Bson projection = fields(excludeId(), include("email"));
collection.find(filter).projection(projection);

Construtores disponíveis

• Filtros para criar filtros de query.

• Projeções para construções de projeções.

• Classificar para criar critérios de classificação.

• Atualizações para atualizações de construções.

• Agregados para construção de pipelines de agregação.

• Índices para criar chaves de índice.