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 Scala.
Formato de dados JSON
BSON, or Binary JSON, is the data format that MongoDB uses to organize and store data. This data format includes all JSON data structure types and also supports other types, including dates, different size integers, ObjectId values, and binary data. For a complete list of supported types, see the BSON Types page in the MongoDB Server manual.
The binary format is not human-readable, but you can use the Java BSON library to convert it to a JSON representation. To learn more about the relationship between these formats, see the JSON and BSON article.
MongoDB e BSON
O driver Scala, 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 Scala 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 Scala como uma dependência ao seu projeto, consulte o guia Comece a usar o driver Scala.
Dica
Lista de materiais
Recomendamos adicionar a Bill of Materials (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 pela BOM, simplificando o gerenciamento de dependências. Para saber mais, consulte o guia Introdução ao driver Scala.
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.