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, o JSON binario, es el formato de datos que MongoDB utiliza para organizar y almacenar datos. Este formato de datos incluye todos los tipos de estructuras de datos JSON y también admite otros tipos, incluidas fechas, enteros de diferentes tamaños, valores de ObjectId y datos binarios. Para obtener una lista completa de los tipos admitidos, consulta la página de BSON types en el manual de MongoDB Server.
El formato binario no es legible por humanos, pero puedes utilizar la librería Java BSON para convertirlo a una representación en JSON. Para **aprender** más información sobre la relación entre estos formatos, consulta el artículo JSON y BSON.
MongoDB y BSON
El driver Scala, que utiliza la librería BSON, le permite trabajar con datos BSON utilizando uno de los tipos de objeto Realm 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 (paquete JVM)
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.