Overview
En esta guía, puedes aprender sobre el formato de datos BSON, cómo MongoDB utiliza BSON para organizar y almacenar datos, y cómo instalar la librería BSON independientemente del controlador Kotlin sincronizar.
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 estructuras de datos JSON y añade soporte para tipos como fechas, números enteros de diferente tamaño (32bits y 64bits), ObjectId y datos binarios. Para ver una lista completa de los tipos compatibles, consulta la BSON types en la documentación del MongoDB Server.
BSON no es legible para humanos, pero puedes usar la librería BSON para convertirlo a la representación JSON legible para humanos. Puedes obtener más información sobre la relación entre estos formatos en la guía JSON y BSON en el sitio web de MongoDB.
MongoDB y BSON
Puedes trabajar con datos BSON en tu aplicación de driver Sync de Kotlin utilizando uno de los siguientes tipos de objetos que 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)
Instalar la librería BSON
Estas instrucciones detallan cómo agregar la librería BSON como una dependencia a tu proyecto.
Nota
Si ya has añadido el controlador de sincronización de Kotlin como dependencia a tu proyecto, puedes omitir este paso. Esto se debe a que la librería BSON ya se incluye como una dependencia requerida del driver.
Para obtener instrucciones sobre cómo agregar el controlador MongoDB Kotlin Sync Driver como una dependencia a tu proyecto, consulta la instalación del controlador sección de nuestra guía para empezar.
Tip
Lista de Materiales
Recomendamos agregar el Registro de Materiales (BOM) del controlador JVM a tu aplicación para gestionar las versiones de los artefactos del controlador. Esto remueve la necesidad de especificar una versión para cualquier paquete individual cubierto por el BOM, simplificando 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.
Recomendamos que utilices la herramienta de automatización de compilación Maven o Gradle para gestionar las dependencias de tu proyecto de Kotlin. Las siguientes instrucciones detallan las declaraciones de dependencias tanto para Maven como para Gradle:
El siguiente snippet 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 ninguna de las herramientas anteriores, puedes incluir la dependencia BSON en tu proyecto descargando el archivo JAR directamente desde el repositorio de sonatype.