Formato de dados do documento: BSON

Visão geral

Neste guia, você aprenderá sobre o formato de dados BSON, como o MongoDB o usa e como instalar a biblioteca BSON independentemente do driver Java do MongoDB.

Formato de dados JSON

BSON, ou Binary JSON, é o formato de dados que o MongoDB utiliza para organizar e armazenar dados. Este formato de dados inclui todos os tipos de estrutura de dados JSON e adiciona suporte para tipos incluindo datas, inteiros de tamanhos diferentes, ObjectIds e dados binários. Para obter uma lista completa dos tipos compatíveis, consulte a página de manual do servidor Tipos BSON.

O formato binário não é legível em humanos, mas você pode utilizar a biblioteca Java BSON para convertê-lo em uma representação JSON. Você pode ler mais sobre o relacionamento entre esses formatos em nosso artigo sobre JSON e BSON.

MongoDB e BSON

O Driver Java do MongoDB , que usa a biblioteca BSON, permite que você trabalhe com dados BSON usando um dos tipos de objeto que implementa a interface BSON, incluindo:

• Documento (pacote da biblioteca BSON)

• BsonDocument (pacote da biblioteca BSON)

• RawBsonDocument (pacote da biblioteca BSON)

• JsonObject (pacote da biblioteca BSON)

• BasicDBObject (pacote do Driver Java)

Para obter mais informações sobre como usar esses tipos de objetos, consulte nossoguia Documentos.

Instale a biblioteca BSON

Estas instruções mostram como adicionar a biblioteca BSON como uma dependência para seu projeto. Se você adicionou o driver Java do MongoDB como uma dependência ao seu projeto, poderá pular esta etapa, pois a biblioteca BSON já está incluída como dependência obrigatória do driver. Para instruções sobre como adicionar o driver Java do MongoDB como uma dependência ao seu projeto, consulte a seção de instalação do driver do nosso guia de Início Rápido.

Recomendamos que você use a ferramenta de automação de construção Maven ou Gradle para gerenciar as dependências do seu projeto. Selecione uma das seguintes abas para visualizar a declaração de dependência dessa ferramenta:

<dependencies>
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>bson</artifactId>
    </dependency>
</dependencies>

dependencies {
   compile 'org.mongodb:bson'
}

Se você não estiver usando uma das ferramentas anteriores, poderá incluí-la em seu projeto baixando o arquivo JAR diretamente do repositório sonatype.

Perguntas frequentes

Esta seção responde a perguntas que podem surgir ao usar o formato de dados BSON.

// incorrectly formatted update document
collection.updateOne(
    new Document().append("name", "fizz"),
    new Document().append("name", "buzz")
);

// Builder class imports
import static com.mongodb.client.model.Filters.*;
import static com.mongodb.client.model.Updates.*;
// ...
collection.updateOne(eq("name", "fizz"), set("name", "buzz"));