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 MongoDB Kotlin.

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 usar a biblioteca 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 MongoDB Kotlin , 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)

Para obter mais informações sobre como usar esses tipos de objeto , consulte nossoguia de 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 Kotlin 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 Kotlin 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>
        <version>5.2.1</version>
    </dependency>
</dependencies>

dependencies {
   implementation("org.mongodb:bson:5.2.1")
}

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.