Overview
En esta guía, puedes aprender a usar el controlador de Streams Reactivos de Java para especificar qué campos devolver de una operación de lectura. Puedes seleccionar estos campos utilizando una proyección, un documento que especifica qué campos devuelve MongoDB de una query.
Datos de muestra
Los ejemplos de esta guía utilizan el sample_restaurants.restaurants colección de la Conjuntos de datos de muestra de Atlas. Para aprender a crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de muestra, consulta el
Guía de primeros pasos.
Importante
Proyecto Reactor librería
Esta guía usa la librería Proyecto Reactor para consumir instancias Publisher devueltas por los métodos del driver Reactive Streams de Java. Para obtener más información sobre la biblioteca Project Reactor y cómo utilizarla, consulta Primeros pasos en la documentación de Reactor. Para obtener más información sobre cómo utilizamos los métodos de la librería Project Reactor en esta guía, consulta la guía Guardar datos en MongoDB.
Tipos de proyección
Se puede usar una proyección para especificar qué campos incluir y excluir de los documentos recuperados. Por defecto, al incluir ciertos campos se excluyen todos los demás campos, por lo que no se pueden combinar instrucciones de inclusión y exclusión en una sola proyección, a menos que se excluya el campo _id de los resultados.
Especifica los campos que deseas incluir
Utilice la siguiente sintaxis para especificar los campos que se incluirán en el resultado de una operación de lectura:
projection(fields(include("<field name>")))
Para usar una proyección, pasa un filtro de query al método find(). Luego, encadene el método projection() a la llamada al método find().
El siguiente ejemplo utiliza el método find() para recuperar documentos en los que el valor del campo name es "Emerald Pub". Luego utiliza una proyección para incluir únicamente los campos name, cuisine y borough de los documentos devueltos.
FindPublisher<Document> findProjectionPublisher = restaurants.find( eq("name", "Emerald Pub")) .projection(fields(include("name", "cuisine", "borough"))); Flux.from(findProjectionPublisher) .doOnNext(System.out::println) .blockLast();
{'_id': ObjectId('...'), 'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub'} {'_id': ObjectId('...'), 'borough': 'Queens', 'cuisine': 'American', 'name': 'Emerald Pub'}
Cuando usas una proyección para especificar los campos que deseas incluir en el documento de retorno, el campo "_id" también se incluye por defecto. Todos los demás campos quedan implícitamente excluidos. Debe excluir explícitamente el campo _id para omitirlo de los documentos devueltos.
Excluir el campo _id
Puedes excluir el campo _id de los documentos devueltos utilizando el método excludeId().
El siguiente ejemplo realiza la misma query que en el ejemplo anterior, pero también excluye el campo _id en los documentos devueltos:
FindPublisher<Document> findProjectionPublisher = restaurants.find( eq("name", "Emerald Pub")) .projection(fields(include("name", "cuisine", "borough"), excludeId())); Flux.from(findProjectionPublisher) .doOnNext(System.out::println) .blockLast();
{'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub'} {'borough': 'Queens', 'cuisine': 'American', 'name': 'Emerald Pub'}
Especificar campos a excluir
Utiliza la siguiente sintaxis para especificar los campos que deben excluirse del resultado de una operación de lectura:
projection(fields(exclude("<field name>")))
Para usar una proyección, pasa un filtro de query al método find(). Luego, encadene el método projection() a la llamada al método find().
El siguiente ejemplo utiliza el método find() para encontrar todos los restaurantes en los que el valor del campo name es "Emerald Pub". Luego utiliza una proyección para excluir los campos grades y address de los documentos devueltos.
FindPublisher<Document> findProjectionPublisher = restaurants.find( eq("name", "Emerald Pub")) .projection(fields(exclude("grades", "address"))); Flux.from(findProjectionPublisher) .doOnNext(System.out::println) .blockLast();
{'_id': ObjectId('...'), 'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub', 'restaurant_id': '40367329'} {'_id': ObjectId('...'), 'borough': 'Queens', 'cuisine': 'American', 'name': 'Emerald Pub', 'restaurant_id': '40668598'}
Cuando se utiliza una proyección para especificar qué campos deben excluirse, cualquier campo no especificado se incluye implícitamente en el documento de retorno.
Errores de proyección
La siguiente sección describe un error que puede encontrar al utilizar proyecciones.
Error de inclusión y exclusión
El controlador devuelve lo siguiente si se intenta incluir y excluir campos en una sola proyección:
OperationFailure: ... Cannot Do Exclusion on Field <field> in Inclusion Projection
Para solucionar este error, asegúrate de que tu proyección especifique solo campos a incluir o solo campos a excluir.
Información Adicional
Para obtener más información sobre las proyecciones, consulte la manual de MongoDB Server Guía de campos de proyecto.
Documentación de la API
Para obtener más información sobre cualquiera de los métodos o tipos discutidos en esta guía, consultar la siguiente documentación de la API: