Overview
En esta guía, puedes aprender sobre el formato de datos BSON, cómo MongoDB lo utiliza y cómo instalar la librería BSON de forma independiente del driver de Kotlin.
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 una lista completa de los tipos admitidos, consulta la página BSON Types en el manual del servidor de MongoDB.
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 de Kotlin, que utiliza la librería BSON, te 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 dependencia a su proyecto. Si añadiste el driver de Kotlin como una dependencia a tu Proyecto, puedes 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 Kotlin como dependencia en tu proyecto, consulta la guía Comenzar con el driver de Kotlin.
Tip
Lista de Materiales
Recomendamos añadir el Bill of Materials (BOM) del driver JVM a tu 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, simplificando la gestión de dependencias. Para obtener más información, consulta la guía Comenzar con el driver de Kotlin.
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.