Overview
En esta guía, podrá aprender sobre el formato de datos BSON, cómo lo utiliza MongoDB y cómo instalar la librería BSON independientemente del driver Scala.
Formato de datos BSON
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 y BSON
El controlador de Scala, que utiliza la biblioteca BSON, permite trabajar con datos BSON mediante uno de los tipos de objeto que implementan la interfaz BSON. Los siguientes tipos implementan la interfaz BSON:
Documento (Paquete de librería BSON)
Documento BSON (paquete de la librería BSON)
RawBsonDocument (paquete de la librería BSON)
JsonObject (paquete de librería BSON)
BasicDBObject (JVM package)
Instalar la librería BSON
Esta sección muestra cómo agregar la librería BSON como una dependencia a su proyecto. Si agregó el driver de Scala como una dependencia a su proyecto, puede omitir este paso, ya que la librería BSON ya está incluida como una dependencia requerida del driver. Para obtener instrucciones sobre cómo agregar el driver de Scala como una dependencia a su proyecto, consulte la guía Introducción al driver de Scala.
Tip
Lista de Materiales
Recomendamos agregar la lista de materiales (BOM) del driver de JVM a su aplicación para gestionar las versiones de los artefactos del driver. Esto remueve la necesidad de especificar una versión para cualquier paquete individual cubierto por la BOM, lo que simplifica la gestión de dependencias. Para obtener más información, consulte la guía Comenzar con el driver de Scala.
Recomendamos utilizar la herramienta de automatización de construcción Maven o Gradle para gestionar las dependencias de su proyecto. Selecciona entre las siguientes pestañas para ver la declaración de dependencia de esa herramienta:
El siguiente snippet muestra la declaración de dependencia en la dependencies sección de tu archivo pom.xml.
<dependencies> <dependency> <groupId>org.mongodb</groupId> <artifactId>bson</artifactId> </dependency> </dependencies>
El siguiente snippet muestra la declaración de dependencia en el objeto dependencies de tu archivo build.gradle.
dependencies { compile 'org.mongodb:bson' }
Si no utilizas una de las herramientas mencionadas anteriormente, puedes incluirla en tu proyecto descargando el archivo JAR directamente desde el repositorio de sonatype.