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 compatibles, consulte la página del manual del servidor de 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 utilizando uno de los tipos de objetos que implementan la interfaz BSON, incluido:
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.
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> <version>5.0.0</version> </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:5.0.0") }
Si no utilizas una de las herramientas mencionadas anteriormente, puedes incluirla en tu proyecto descargando el archivo JAR directamente desde el repositorio de sonatype.