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 JSON, incluindo:
Documento (Pacote da biblioteca BSON)
JsonObject (Pacote da biblioteca BSON)
BasicDBObject (Pacote Java Driver)
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 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 o Maven ou Gradle crie uma ferramenta de automação para gerenciar as dependências do seu projeto. Selecione a partir das seguintes guias para ver a declaração de dependência para esta ferramenta:
O seguinte trecho mostra a declaração de dependência na seção dependencies
do seu arquivo pom.xml
.
<dependencies> <dependency> <groupId>org.mongodb</groupId> <artifactId>bson</artifactId> <version>5.2.0</version> </dependency> </dependencies>
O seguinte trecho mostra a declaração de dependência no objeto dependencies
em seu arquivo build.gradle
.
dependencies { compile 'org.mongodb:bson:5.2.0' }
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.