Overview
En esta guía, puede aprender cómo actualizar matrices en un documento con el controlador Java de MongoDB.
Para actualizar una matriz, debe hacer lo siguiente:
Especifique la actualización que desea realizar
Especifique a qué elementos de la matriz aplicar su actualización
Realice una operación de actualización utilizando estas especificaciones
Documento de muestra
Las siguientes secciones presentan ejemplos que actualizan este documento de muestra:
{ "_id": 1, "color": "green", "qty": [8, 12, 18] }
Los ejemplos de esta página utilizan el findOneAndUpdate() Método de la clase MongoCollection para recuperar y actualizar el documento. Cada ejemplo utiliza una instancia de la clase FindOneAndUpdateOptions para que MongoDB recupere el documento después de la actualización. Para más información sobre el método findOneAndUpdate(), consulte nuestra
Guía de operaciones compuestas.
Especificación de una actualización
Para especificar una actualización, utilice el Updates constructor. El Updates constructor proporciona métodos de utilidad estáticos para construir especificaciones de actualización. Para obtener más información sobre el uso del Updates constructor con matrices, consulte nuestra guía sobre el constructor de actualizaciones.
El siguiente ejemplo realiza estas acciones:
Consulta del documento de muestra
Agregue "17" a la matriz
qtyen el documento que coincida con el filtro de consulta
Bson filter = Filters.eq("_id", 1); Bson update = Updates.push("qty", 17); // Defines options that configure the operation to return a document in its post-operation state FindOneAndUpdateOptions options = new FindOneAndUpdateOptions() .returnDocument(ReturnDocument.AFTER); // Updates the first document that matches the filter and prints the updated document as JSON Document result = collection.findOneAndUpdate(filter, update, options); System.out.println(result.toJson());
El ejemplo anterior actualiza el documento original al siguiente estado:
{ "_id": 1, "color": "green", "qty": [8, 12, 18, 17] }
Especificación de elementos de matriz
Se puede especificar cuáles elementos de un arreglo actualizar usando un operador posicional. Los operadores posicionales pueden especificar el primer, todos o ciertos elementos del arreglo para actualizar.
Para especificar elementos en un arreglo con operadores posicionales, utiliza la notación de puntos. La notación de puntos es una sintaxis de acceso a propiedades para navegar objetos BSON.
Para obtener información adicional, consulte la entrada del Manual del servidor en notación de puntos.
El primer elemento coincidente de la matriz
Para actualizar el primer elemento de la matriz que coincida con el filtro de consulta, utilice el operador posicional $. El campo de la matriz debe aparecer como parte del filtro de consulta para poder utilizar el operador posicional $.
Ejemplo
El siguiente ejemplo realiza estas acciones:
Consulta de un documento con un campo
qtyque contiene el valor "18"Disminuye el primer valor de la matriz en el documento que coincida con el filtro de consulta en "3"
Bson filter = Filters.eq("qty", 18); Bson update = Updates.inc("qty.$", -3); // Defines options that configure the operation to return a document in its post-operation state FindOneAndUpdateOptions options = new FindOneAndUpdateOptions() .returnDocument(ReturnDocument.AFTER); // Updates the first document that matches the filter and prints the updated document as JSON Document result = collection.findOneAndUpdate(filter, update, options); System.out.println(result.toJson());
El ejemplo anterior actualiza el documento original al siguiente estado:
{ "_id": 1, "color": "green", "qty": [8, 12, 15] }
Para obtener más información sobre los métodos y operadores mencionados en esta sección, consulte los siguientes recursos:
Entrada manual del servidor del operadorposicional $
Cª() Documentación de la API
Coincidencia de todos los elementos del arreglo
Para actualizar todos los elementos de una matriz, utilice el operador posicional $[].
Ejemplo
El siguiente ejemplo realiza estas acciones:
Consulta del documento de muestra
Multiplica los elementos de la matriz que coinciden con el filtro de consulta por "2"
Bson filter = Filters.eq("_id", 1); Bson update = Updates.mul("qty.$[]", 2); // Defines options that configure the operation to return a document in its post-operation state FindOneAndUpdateOptions options = new FindOneAndUpdateOptions() .returnDocument(ReturnDocument.AFTER); // Updates the first document that matches the filter and prints the updated document as JSON Document result = collection.findOneAndUpdate(filter, update, options); System.out.println(result.toJson());
El ejemplo anterior actualiza el documento original al siguiente estado:
{ "_id": 1, "color": "green", "qty": [16, 24, 36] }
Para obtener más información sobre los métodos y operadores mencionados en esta sección, consulte los siguientes recursos:
Entrada manual del servidor deloperador posicional $[]
Documentación de la APImul()
Coincidencia de múltiples elementos de una matriz
Para actualizar los elementos de una matriz que coinciden con un filtro, utilice el operador posicional filtrado $[<identifier>]. Debe incluir un filtro de matriz en la operación de actualización para especificar qué elementos de la matriz actualizar.
<identifier> es el nombre que le asignas al filtro de matriz. Este valor debe empezar con una letra minúscula y contener solo caracteres alfanuméricos.
Ejemplo
El siguiente ejemplo realiza estas acciones:
Consulta del documento de muestra
Establezca un filtro de matriz para buscar valores menores que "15"
Incrementar los elementos de la matriz que coinciden con el filtro de consulta en "5"
Bson filter = Filters.eq("_id", 1); Bson smallerFilter = Filters.lt("smaller", 15); // Defines options that configure the document's return state and apply the array value filter FindOneAndUpdateOptions options = new FindOneAndUpdateOptions() .returnDocument(ReturnDocument.AFTER) .arrayFilters(Arrays.asList(smallerFilter)); // Creates an update document to increase the matched array values by "5" Bson update = Updates.inc("qty.$[smaller]", 5); // Updates the first document that matches the filter and prints the updated document as JSON Document result = collection.findOneAndUpdate(filter, update, options); System.out.println(result.toJson());
El ejemplo anterior actualiza el documento original al siguiente estado:
{ "_id": 1, "color": "green", "qty": [13, 17, 18] }
Para obtener más información sobre los métodos y operadores mencionados en esta sección, consulte los siguientes recursos: