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 independientemente del driver de MongoDB para Kotlin.
Formato de datos BSON
BSON, o JSON binario, es el formato de datos que MongoDB usa para organizar y almacenar datos. Este formato de datos incluye todos los tipos de estructura de datos JSON y añade soporte para tipos como fechas, enteros de diferentes tamaños, ObjectIds y datos binarios. Para ver una lista completa de los tipos compatibles, consulta la BSON Types página del manual del servidor.
El formato binario no es legible para los humanos, pero puedes utilizar la librería BSON para convertirlo en una representación en JSON. Puedes leer más sobre la relación entre estos formatos en nuestro artículo sobre JSON y BSON.
MongoDB y BSON
El controlador MongoDB Kotlin, que utiliza la biblioteca BSON, le permite trabajar con datos BSON mediante uno de los tipos de objetos que implementan la interfaz BSON, incluidos:
Documento (paquete de biblioteca BSON)
Documento BSON (paquete de la librería BSON)
RawBsonDocument (paquete de biblioteca BSON)
JsonObject (paquete de librería BSON)
Para más información sobre el uso de estos tipos de objeto Realm, consulta nuestro Guía de Documentos.
Instalar la librería BSON
Estas instrucciones muestran cómo añadir la librería BSON como una dependencia a tu Proyecto. Si añadiste el driver MongoDB Kotlin como dependencia a tu proyecto, puedes omitir este paso ya que la librería BSON ya está incluida como una dependencia requerida del driver. Para instrucciones sobre cómo añadir el driver MongoDB Kotlin como dependencia a tu proyecto, consulta la sección instalación del driver de nuestra guía de inicio rápido.
Tip
Lista de Materiales
Recomendamos agregar el programa de materiales del driver JVM (BOM) 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 el BOM, lo que simplifica la gestión de dependencias. Para obtener más información, consulte el paso Agregar la factura de materiales del driver de la guía de inicio rápido.
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 fragmento muestra la declaración de dependencia en el
dependencies sección de su 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 { implementation("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.