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.

Formato de dados JSON

BSON, ou Binary JSON, é o formato de dados que o MongoDB usa para organizar e armazenar dados. Este formato de dados inclui todos os tipos de estrutura de dados JSON e também oferece suporte a outros tipos, incluindo datas, inteiros de tamanhos diferentes, valores ObjectId e dados binários. Para obter uma lista completa dos tipos compatíveis, consulte a página BSON Types no manual do MongoDB Server.

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. Para aprender mais sobre o relacionamento entre esses formatos, consulte o artigo JSON e BSON.

MongoDB e BSON

O driver Java, que usa a biblioteca BSON, permite trabalhar com dados BSON usando um dos tipos de objeto de Realm que implementa a interface BSON. Os seguintes tipos implementam a interface BSON:

• Documento (pacote da biblioteca BSON)

• BsonDocument (pacote da biblioteca BSON)

• RawBsonDocument (pacote da biblioteca BSON)

• JsonObject (pacote da biblioteca BSON)

• BasicDBObject (pacote JVM)

Instale a biblioteca BSON

Esta seção mostra como adicionar a biblioteca BSON como uma dependência ao seu projeto. Se você adicionou o driver Java 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 como uma dependência ao seu projeto, consulte o guia Introdução ao driver Java.

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"));