Documentos Referenciados con jmoordb-core

 Los documentos reverenciados en jmoordb -core se basan en el principio de que estos son documentos embebidos en la colección, en los cuales podemos especificar si deben ser consultados en otra colección o se utilizan los documentos de la misma colección.

En el ejemplo contados con tres colecciones Animal, Grupo , Zoo. Dentro de animal tenemos dos documentos embebidos Zoo y Especie.

Colección Grupo

/* 0 */
{
  "_id" : ObjectId("63613acfc6acae0fad901685"),
  "grupo" : "Mamifero",
  "idgrupo" : "mamifero"
}

/* 1 */
{
  "_id" : ObjectId("63613afec6acae0fad901686"),
  "grupo" : "Aves",
  "idgrupo" : "aves"
}

/* 2 */
{
  "_id" : ObjectId("63613b19c6acae0fad901687"),
  "grupo" : "Reptiles",
  "idgrupo" : "reptiles"
}

Colección Zoo

/* 0 */
{
  "_id" : ObjectId("63613a91c6acae0fad901683"),
  "idzoo" : "panama",
  "nombre" : "Zoo de Panama"
}

/* 1 */
{
  "_id" : ObjectId("63613aa1c6acae0fad901684"),
  "idzoo" : "china",
  "nombre" : "Zoo de China"
}

Colección Animal

{
    "animal": "Perro",
    "idanimal": NumberLong(1),
    "especie":{
      "nombre":"perropequeño"  
    },
    "plaga": [
        {
            "nombre": "pulgas"
        },
        {
            "nombre": "garrapatas"
        }
    ],

    "grupo": {

        "grupo": "Mamifero",
        "idgrupo": "mamifero"
    },
    "zoo": [
        {
            "idzoo": "panama",
            "nombre": "Zoo de Panama"
        }

        ,
        {
            "idzoo": "china",
            "nombre": "Zoo de China"
        }
    ]
}

Observe que aunque sean documentos referenciados estos se almacenan como documentos embebidos dentro de la colección principal. Esto nos permite que especifiquemos el mecanismo de consulta a realizar.

Entidad Animal, utilizando @Referenced   TypeReferenced.EMBEDDED si la utilizamos como un documento embebido no se harán consultas sobre la colección referenciada, se cargara el documento embebido por lo tanto se obtiene un mejor desempeño en la operación.

@Entity(jakartaSource = JakartaSource.JAVAEE_LEGACY)
public class Animal {
 @Id(autogeneratedActive = AutogeneratedActive.ON)
 private Long idanimal;
 @Column
 private String animal;
 
 @Embedded
 private Especie especie;
 
 @Embedded
 private List<Plaga> plaga;
 
 @Referenced(from = "grupo",localField = "idgrupo",typeReferenced = TypeReferenced.EMBEDDED)
 private Grupo grupo;

 @Referenced(from="zoo",localField = "idzoo",typeReferenced = TypeReferenced.REFERENCED)
 private List<Zoo> zoo;
 

Al compilar el proyecto genera un código similar a este segmento que se muestra a continuación. Observe que grupo aunque es una referencia se maneja como documento embebido.

	public Animal get(Supplier<? extends Animal> s, Document document_) {
        Animal animal= s.get(); 
        try {
	
	 animal.setIdanimal(document_.getLong("idanimal"));
	animal.setAnimal(document_.getString("animal"));

	// Embedded of especie
	animal.setEspecie((Especie) document_.get("especie"));
		

	// Embedded List<plaga>
	List<Plaga> plagaList = new ArrayList<>();
	List<Document> plagaDoc = (List) document_.get("plaga");
	for( Document docPlaga : plagaDoc){
		Plaga plaga = plagaSupplier.get(Plaga::new, docPlaga);
		plagaList.add(plaga);
	};
	animal.setPlaga(plagaList);
		

	// Embedded of grupo
	animal.setGrupo((Grupo) document_.get("grupo"));
		
	// Referenced List<zoo>
	 List<Document> zooDocumentList = (List)document_.get("zoo");
	List<Zoo> zooList = new ArrayList<>();
	for( Document zooDoc :zooDocumentList){
		Zoo zoo = zooSupplier.get(Zoo::new,zooDoc);
		 Optional<Zoo> zooOptional = zooRepository.findByPk(zoo.getIdzoo());
		if(zooOptional.isPresent()){
			zooList.add(zooOptional.get());
		}
	}
	animal.setZoo(zooList);

Ahora si editamos la entidad Animal y especificamos la referencia a Grupo como TypeReferenced.REFERENCED,  Se realizara una consulta a la colección Grupo. En el framework evitamos el uso de los $Lookup de MongoDB , para mejorar el desempeño de  las operaciones.

 @Entity(jakartaSource = JakartaSource.JAVAEE_LEGACY)
public class Animal {
 @Id(autogeneratedActive = AutogeneratedActive.ON)
 private Long idanimal;
 @Column
 private String animal;
 
 @Embedded
 private Especie especie;
 
 @Embedded
 private List<Plaga> plaga;
 
 @Referenced(from = "grupo",localField = "idgrupo",typeReferenced = TypeReferenced.REFERENCED)
 private Grupo grupo;

 @Referenced(from="zoo",localField = "idzoo",typeReferenced = TypeReferenced.REFERENCED)
 private List<Zoo> zoo;

Al compilar el proyecto se genera el siguiente código

 
 public Animal get(Supplier<? extends Animal> s, Document document_) {
        Animal animal= s.get(); 
        try {
	
	 animal.setIdanimal(document_.getLong("idanimal"));
	animal.setAnimal(document_.getString("animal"));

	// Embedded of especie
	animal.setEspecie((Especie) document_.get("especie"));
		

	// Embedded List<plaga>
	List<Plaga> plagaList = new ArrayList<>();
	List<Document> plagaDoc = (List) document_.get("plaga");
	for( Document docPlaga : plagaDoc){
		Plaga plaga = plagaSupplier.get(Plaga::new, docPlaga);
		plagaList.add(plaga);
	};
	animal.setPlaga(plagaList);
		
	// @Referenced of grupo how Referenced
	Grupo grupo = (Grupo) document_.get("grupo");
	animal.setGrupo(grupoRepository.findByPk(grupo.getIdgrupo()).get());
		
	// Referenced List<zoo>
	 List<Document> zooDocumentList = (List)document_.get("zoo");
	List<Zoo> zooList = new ArrayList<>();
	for( Document zooDoc :zooDocumentList){
		Zoo zoo = zooSupplier.get(Zoo::new,zooDoc);
		 Optional<Zoo> zooOptional = zooRepository.findByPk(zoo.getIdzoo());
		if(zooOptional.isPresent()){
			zooList.add(zooOptional.get());
		}
	}
	animal.setZoo(zooList);
		

         } catch (Exception e) {
              MessagesUtil.error(MessagesUtil.nameOfClassAndMethod() + " " + e.getLocalizedMessage());
         }
         return animal;
     }
        
    

Usted puede utilizar a su conveniencia esta caracteristica