Query MongoDB - Java SDK

Inserir um único documento

Você pode inserir um único documento usando collection.insertOne().

O trecho a seguir insere um único documento que descreve uma planta "lírio do vale" em uma coleção de documentos que descrevem plantas à venda em um grupo de lojas:

A execução deste trecho produz saída semelhante ao seguinte:

V/EXAMPLE: successfully inserted a document with id: BsonObjectId{value=5f19...}

Insira vários documentos

Você pode inserir vários documentos ao mesmo tempo usando collection.insertMany().

O trecho a seguir insere três documentos descrevendo plantas em uma coleção de documentos que descrevem plantas para venda em um grupo de lojas:

A execução deste trecho produz saída semelhante ao seguinte:

V/EXAMPLE: successfully inserted 3 documents into the collection.

Encontrar um único documento

Você pode encontrar um único documento usando collection.findOne().

O trecho a seguir encontra um único documento de uma coleção de documentos que descrevem plantas para venda em um grupo de lojas onde o campo type do documento da planta contém o valor da string "perennial":

A execução deste trecho produz uma saída semelhante ao seguinte:

V/EXAMPLE: successfully found a document: Plant [id=5f18..., name=venus flytrap, sunlight=full, color=white, type=perennial, partition=Store 42]

Localizar vários documentos

Você pode encontrar vários documentos usando collection.find().

O snippet a seguir encontra todos os documentos em uma coleção de documentos que descrevem plantas à venda em um grupo de lojas que contêm um campo chamado _partition com um valor de "Loja 42":

A execução deste trecho produz saída semelhante ao seguinte:

V/EXAMPLE: successfully found all plants for Store 42:
V/EXAMPLE: Plant [id=5f18..., name=venus flytrap, sunlight=full, color=white, type=perennial, partition=Store 42]
V/EXAMPLE: Plant [id=5f18..., name=sweet basil, sunlight=partial, color=green, type=annual, partition=Store 42]
V/EXAMPLE: Plant [id=5f18..., name=thai basil, sunlight=partial, color=green, type=perennial, partition=Store 42]
V/EXAMPLE: Plant [id=5f18..., name=helianthus, sunlight=full, color=yellow, type=annual, partition=Store 42]

Contagem de documentos na coleção

Você pode contar documentos em uma coleção usando collection.count(). Você pode especificar uma query opcional para determinar quais documentos contar. Se você não especificar uma query, a ação contará todos os documentos da collection.

O seguinte trecho conta o número de documentos em uma coleção de documentos que descrevem plantas para venda em um grupo de lojas:

A execução deste trecho produz saída semelhante ao seguinte:

V/EXAMPLE: successfully counted, number of documents in the collection: 5

Atualizar um único documento

Você pode atualizar um único documento usando collection.updateOne().

O trecho a seguir atualiza um único documento em uma coleção de documentos que descrevem plantas para venda em um grupo de lojas. Essa operação consulta um documento em que o campo name contém o valor "petunia" e altera o valor do campo sunlight do primeiro documento correspondente para "parcial":

A execução deste trecho produz saída semelhante ao seguinte:

V/EXAMPLE: successfully updated a document.

Atualizar vários documentos

Você pode atualizar vários documentos usando collection.updateMany().

O trecho a seguir atualiza vários documentos em uma coleção de documentos que descrevem plantas para venda em um grupo de lojas. Esta operação faz queries em documentos onde o campo _partition contém o valor "Armazenar 47" e altera o valor do campo _partition de cada documento correspondente para "Armazenar 51":

A execução deste trecho produz saída semelhante ao seguinte:

V/EXAMPLE: successfully updated 2 documents.

Documentos do Upsert

Se uma operação de atualização não corresponder a nenhum documento na coleção, você poderá inserir automaticamente um único novo documento na coleção que corresponda à query de atualização definindo a opção upsert como true.

O trecho a seguir atualiza um documento em uma coleção de documentos que descrevem plantas para venda em um grupo de lojas ou insere um novo documento se nenhum documento corresponder à query. Esta operação query documentos onde:

• o campo sunlight tem um valor de "completo"

• o campo type tem um valor de "perene"

• o campo color tem um valor de "verde"

• o campo _partition tem um valor de "Armazenar 47"

Como esse trecho define a opção upsert como true, se nenhum documento corresponder à query, o MongoDB cria um novo documento que inclui a query e as atualizações especificadas:

A execução deste trecho produz saída semelhante ao seguinte:

V/EXAMPLE: successfully upserted a document with id: BsonObjectId{value=5f19...}

Excluir um único documento

Você pode excluir um único documento de uma coleção usando collection.deleteOne().

O trecho a seguir exclui um documento em uma coleção de documentos que descrevem plantas para venda em um grupo de lojas. Esta operação consulta um documento onde o campo color tem um valor de "verde" e exclui o primeiro documento que corresponde à consulta:

A execução deste trecho produz saída semelhante ao seguinte:

V/EXAMPLE: successfully deleted a document.

Excluir vários documentos

Você pode excluir vários itens de uma coleção usando collection.deleteMany().

O trecho a seguir exclui todos os documentos em uma coleção de documentos que descrevem plantas para venda em um grupo de lojas que correspondem à query que corresponde a documentos contendo um valor de campo sunlight de "completo" e um valor de campo type de "anual ".

A execução deste trecho produz saída semelhante ao seguinte:

V/EXAMPLE: succcessfully deleted 2 documents.

Fique atento às mudanças em uma coleção

Você pode abrir um fluxo de alterações feitas em uma coleção chamando collection.watch() ou collection.watchAsync(). Você pode observar alterações em documentos específicos em uma coleção passando as IDs de objeto dos objetos que você gostaria de monitorar como um número variável de argumentos.

O seguinte trecho observa alterações em quaisquer documentos na coleção plants :

A execução deste trecho produz saída semelhante ao seguinte:

V/EXAMPLE: successfully inserted a document with id BsonObjectId{value=5f6bb...}
V/EXAMPLE: Event type: INSERT full document: Plant [id=5f6bb..., name=triffid, sunlight=low, color=green, type=perennial, partition=Store 47]

Fique atento às alterações em uma coleção com um filtro

Você pode abrir um fluxo de alterações feitas em documentos em uma coleção que atendam a determinados critérios chamando collection.watchWithFilter() ou collection.watchWithFilterAsync(). Ambos os métodos aceitam um parâmetro Document ou BsonDocument que é utilizado como a query de um operador $match para processar cada evento do banco de dados que ocorre enquanto observa a collection.

O trecho a seguir observa alterações em documentos na coleção plants , mas apenas aciona a chamada de resposta fornecida para eventos correspondentes a documentos pertencentes à partição chamada "Store 42":

A execução deste trecho produz saída semelhante ao seguinte:

V/EXAMPLE: successfully inserted 2 documents into the collection
V/EXAMPLE: Event type: INSERT full document: Plant [id=5f6bb..., name=venomous tentacula, sunlight=low, color=brown, type=annual, partition=Store 42]

Filtrar documentos

Você pode usar o estágio $match para filtrar documentos de acordo com um filtro de query da API de query.

{
  "$match": {
    "<Field Name>": <Query Expression>,
    ...
  }
}

Documentos do grupo

Você pode usar o estágio $group para agregar dados resumidos de um ou mais documentos. O MongoDB agrupa documentos com base na expressão definida no _id valor de campo do $group estágio . Você pode referenciar um campo de documento específico prefixando o nome do campo com um $.

O trecho a seguir agrupa todos os documentos na coleção plants por seu valor type e agrega uma contagem do número de cada tipo:

Campos do documento do projeto

Você pode usar o estágio $project para incluir ou omitir campos específicos dos documentos. Além disso, você pode calcular novos campos utilizando operadores de aggregation. As projeções funcionam de duas formas:

• Inclua campos explicitamente com um valor de 1. Isso tem o efeito colateral de excluir implicitamente todos os campos não especificados.

• Exclua campos de forma implícita com um valor de 0. Isso tem o efeito colateral de incluir implicitamente todos os campos não especificados.

Esses dois métodos de projeção são mutuamente exclusivos: se você incluir campos explicitamente, não poderá excluir campos explicitamente e vice-versa.

{
  "$project": {
    "<Field Name>": <0 | 1 | Expression>,
    ...
  }
}

Adicionar campos aos documentos

Você pode usar o estágio $addFields para adicionar novos campos com valores calculados usando operadores de aggregation.

Desenrolar valores de array

Você pode usar o estágio $unwind para transformar um único documento contendo uma matriz em vários documentos contendo valores individuais dessa matriz. Quando você desvincula um campo de array, o MongoDB copia cada documento uma vez para cada elemento do campo de array, mas substitui o valor de array pelo elemento de array em cada cópia.

{
  $unwind: {
    path: <Array Field Path>,
    includeArrayIndex: <string>,
    preserveNullAndEmptyArrays: <boolean>
  }
}

Considere o seguinte documento de uma collection de compras:

   {
     _id: 123,
     customerId: 24601,
     items: [
       { name: "Baseball", quantity: 5 },
       { name: "Baseball Mitt", quantity: 1 },
       { name: "Baseball Bat", quantity: 1 },
     ]
   }

Se aplicarmos o exemplo do estágio $unwind a este documento, o estágio produzirá os três documentos a seguir:

   {
     _id: 123,
     customerId: 24601,
     itemIndex: 0,
     items: { name: "Baseball", quantity: 5 }
   }, {
     _id: 123,
     customerId: 24601,
     itemIndex: 1,
     items: { name: "Baseball Mitt", quantity: 1 }
   }, {
     _id: 123,
     customerId: 24601,
     itemIndex: 2,
     items: { name: "Baseball Bat", quantity: 1 }
   }