Overview
En esta guía, puede aprender sobre el formato de datos BSON, cómo lo usa MongoDB y cómo instalar la biblioteca BSON independientemente del controlador MongoDB Kotlin.
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, ObjectIds y datos binarios. Para obtener una lista completa de los tipos admitidos, consulte Página del manual del servidorde tipos BSON.
El formato binario no es legible, pero se puede usar la biblioteca BSON para convertirlo a una representación JSON. Puede 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)
BsonDocument (paquete de biblioteca BSON)
RawBsonDocument (paquete de biblioteca BSON)
JsonObject (paquete de biblioteca BSON)
Para obtener más información sobre el uso de estos tipos de objetos, consulte nuestra Guía de documentos.
Instalar la biblioteca BSON
Estas instrucciones le muestran cómo agregar la biblioteca BSON como dependencia a su proyecto. Si agregó el controlador MongoDB Kotlin como dependencia a su proyecto, puede omitir este paso, ya que la biblioteca BSON ya está incluida como dependencia obligatoria del controlador. Para obtener instrucciones sobre cómo agregar el controlador MongoDB Kotlin como dependencia a su proyecto, consulte la sección de instalación del controlador en nuestra Guía de inicio rápido.
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 inicio rápido.
Le recomendamos usar la herramienta de automatización de compilación Maven o Gradle para administrar las dependencias de su proyecto. Seleccione una de 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 fragmento muestra la declaración de dependencia en el objeto dependencies en su 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.