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 Kotlin.
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 servidor MongoDB.
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 Kotlin, que usa a biblioteca BSON, permite que você trabalhe 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 Kotlin 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 obter instruções sobre como adicionar o driver Kotlin como uma dependência ao seu projeto, consulte o guia primeiros passos com o driver Kotlin.
Dica
Lista de materiais
Recomendamos adicionar a lista de materiais (BOM) do driver JVM ao seu aplicativo para gerenciar as versões dos artefatos do driver. Isso remove a necessidade de especificar uma versão para qualquer pacote individual coberto pelo BOM, simplificando o gerenciamento de dependências. Para saber mais, consulte o guia Introdução ao driver Kotlin.
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:
O seguinte trecho de código 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> </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' }
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.