Overview
En esta guía, puedes aprender sobre el formato de datos BSON, cómo lo utiliza MongoDB y cómo instalar la librería BSON de forma independiente al driver Java de MongoDB.
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 humanos, pero puedes emplear la librería Java BSON para convertirlo en una representación JSON. Puedes leer más sobre la relación entre estos formatos en nuestro artículo de JSON y BSON.
MongoDB y BSON
El driver Java de MongoDB, que utiliza la librería BSON, le permite trabajar con datos BSON utilizando uno de los tipos de objeto Realm que implementan la Interfaz BSON., incluyendo:
Documento (paquete de biblioteca BSON)
Documento BSON (paquete de la librería BSON)
RawBsonDocument (paquete de biblioteca BSON)
JsonObject (paquete de librería BSON)
BasicDBObject (paquete del Controlador Java)
Para obtener más información sobre el uso de estos tipos de objeto Realm, consulte nuestra Guía de Documentos.
Instalar la librería BSON
Estas instrucciones le muestran cómo agregar la biblioteca BSON como dependencia a su proyecto. Si agregó el controlador Java de MongoDB 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 Java de MongoDB 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 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 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 { compile '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.
Preguntas frecuentes
Esta sección responde preguntas que pueden surgir al utilizar el formato de datos BSON.
¿Cómo puedo evitar el error "IllegalArgumentException: nombre de campo BSON no válido"?
Tu aplicación podría arrojar esta excepción si pasas un documento con formato incorrecto a una operación y estás usando el controlador Java v4.7 o anterior.
Nota
En las versiones del controlador v4.8 y posteriores, este mensaje de error fue reemplazado por uno que incluye detalles más específicos sobre lo que estaba formateado incorrectamente.
Por ejemplo, el controlador lanza este error cuando llamas a una operación de actualización y omites incorrectamente el operador de actualización, como se muestra en el siguiente ejemplo de código:
// incorrectly formatted update document collection.updateOne( new Document().append("name", "fizz"), new Document().append("name", "buzz") );
Para evitar este error, utiliza la clase de creador para la operación correspondiente. El driver ofrece clases de desarrolladores para crear BSON sintácticamente correcto para operaciones de MongoDB. El ejemplo anterior puede expresarse correctamente usando las clases de desarrolladores, como se muestra en el siguiente ejemplo de código:
// Builder class imports import static com.mongodb.client.model.Filters.*; import static com.mongodb.client.model.Updates.*; // ... collection.updateOne(eq("name", "fizz"), set("name", "buzz"));
Para saber más sobre las clases de desarrolladores disponibles, consulta la guía de desarrolladores.