Overview
En esta guía, puede aprender sobre el formato de datos BSON, cómo MongoDB usa BSON para organizar y almacenar datos, y cómo instalar la biblioteca BSON independientemente del controlador Kotlin Sync.
Formato de datos BSON
BSON, o JSON binario, es el formato de datos que MongoDB utiliza para organizar y almacenar datos. Este formato incluye todos los tipos de estructuras de datos JSON y admite tipos como fechas, enteros de diferentes tamaños (bits32de y 64bit de), ObjectIds y datos binarios. Para obtener una lista completa de los tipos admitidos, consulte Tipos BSON en la documentación del servidor MongoDB.
BSON no es legible, pero puede usar la biblioteca BSON para convertirlo a la representación JSON legible. Puede leer más sobre la relación entre estos formatos en la guía JSON y BSON del sitio web de MongoDB.
MongoDB y BSON
Puede trabajar con datos BSON en su aplicación de controlador Kotlin Sync utilizando uno de los siguientes tipos de objetos que implementan la interfaz BSON:
Documento (paquete de biblioteca BSON)
BsonDocument (paquete de biblioteca BSON)
RawBsonDocument (paquete de biblioteca BSON)
JsonObject (paquete de biblioteca BSON)
Instalar la biblioteca BSON
Estas instrucciones detallan cómo agregar la biblioteca BSON como una dependencia a su proyecto.
Nota
Si ya agregó el controlador Kotlin Sync como dependencia a su proyecto, puede omitir este paso. Esto se debe a que la biblioteca BSON ya está incluida como dependencia obligatoria del controlador.
Para obtener instrucciones sobre cómo agregar el controlador de sincronización de MongoDB Kotlin como una dependencia a su proyecto, consulte la Sección de instalación del controlador de nuestra guía de introducción.
Tip
Lista de materiales
Recomendamos agregar la lista de materiales (BOM) del controlador JVM a su aplicación para administrar las versiones de los artefactos del controlador. Esto elimina la necesidad de especificar una versión para cada paquete individual cubierto por la BOM, lo que simplifica la gestión de dependencias. Para obtener más información, consulte el paso "Agregar la lista de materiales del controlador" de la guía de introducción.
Le recomendamos usar la herramienta de automatización de compilación Maven o Gradle para administrar las dependencias de su proyecto Kotlin. Las siguientes instrucciones detallan las declaraciones de dependencias para Maven y Gradle:
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 fragmento muestra la declaración de dependencia en el objeto dependencies en su archivo build.gradle.
dependencies { implementation("org.mongodb:bson") }
Si no está utilizando ninguna de las herramientas anteriores, puede incluir la dependencia BSON en su proyecto descargando el archivo JAR directamente desde el repositorio sonatype.