Documento Referenciado

Documentos Referenciados

Un documento referenciado en jmoordb es un documento que guarda solo la referencia al campo llave del otro documento, de manera que no se almacene el contenido del documento referenciado dentro de el. El framework, realiza las operaciones para serializar y deserializarlo respectivamente, se define mediante la anotación @Referenced.

Si has utilizado un modelo relacional @Referenced es una forma de manejar relaciones entre documentos.

@Referenced

@Referenced(collection="", field="",javatype="",lazy="",repository="com.mypaquete.EntityRepository")

Atributo	Descripción
collection	Nombre de la colección referenciada
field	Nombre del campo llave que identifica al documento en la colección
javatype	Indica el tipo de datos de la llave primaria.	String: Tipo String de llave primaria.	Integer: Tipo Integer de la llave primaria.
lazy	Indica si se debe recorrer o no los documentos en las colecciones referenciadas.	false: Indica que al buscar en el documento principal, buscara en la colección relacionada el documento. Devolverá todo los atributos del documento relacionado.	true: Indica que al buscar en una colección , no se buscara la colección relacionada solo se devolverá el id de la colección relacionada.
repository	Indicar el nombre del Repository definido especificando el paquete donde esta ubicado.		f

Ejemplos de definición de @Referenced lazy

lazy= false (valor predeterminado)

Devolverá los entitys relacionados con la información de los documentos referenciados.

Continentes{idcontinente=oc, continente=Oceania, planetas=[Planetas{idplaneta=tierra, planeta=Tierra}, Planetas{idplaneta=marte, planeta=Marte}]}

lazy= true (no buscar en documentos referenciados)

Solo devolverá el valor de los campos llaves referenciados, los demás atributos serán null.

Continentes{idcontinente=oc, continente=Oceania, planetas=[Planetas{idplaneta=tierra, planeta=null}, Planetas{idplaneta=marte, planeta=null}]}

Ejemplo de un documento @Referenced

Entity

@Getter
@Setter
public class Continentes {
@Id
private String idcontinente;
private String continente;
@Referenced(collection = "Planetas", field = "idplaneta",javatype="String", lazy = false,repository="com.avbravo.repository.PlanetasRepository")

private Planetas planetas;
}

Controller

Continentes continentes = new Continentes();
continentes.setIdcontinente("am");
continentes.setContinente("America");
Planetas planetas = new Planetas();
planetas.setIdplaneta("tr");
Planetas p1 = planetasRepository.findBy(planetas);
ontinentes.setPlanetas(p1);
if (continentesRepository.save(continentes)) { }

Documento Generado

Nota: Solo se almacena el valor del atributo relacionado, en el ejemplo idplaneta.

{ "_id" : ObjectId("587e73eba6cca93639449808"),
"idcontinente" : "am",
"continente" : "America",
"planetas" : {
"idplaneta" : "tr"
}
}

Listas Referenciadas

Una lista referenciada es una lista de documentos que solo se almacena la llave primaria y que son usadas como referencia para cargar automáticamente el contenido del documento referenciado.

Entity

@Getter
@Setter
public class Continentes {
@Id
private String idcontinente;
private String continente;
@Referenced(collection = "Planetas",field = "idplaneta",javatype="String",lazy=false, repository="com.avbravo.repository.PlanetasRepository")
private List<Planetas> planetas;
}

Controller

Continentes continentes = new Continentes();
continentes.setIdcontinente("am");
continentes.setContinente("America");
Planetas planetas = new Planetas();
planetas.setIdplaneta("tr");
Planetas p1 = planetasRepository.findBy(planetas);
Planetas p2 = planetasRepository.findById(new Document("idplaneta","mr");
Planetas p3 = planetasRepository.findById(new Document("idplaneta","jp");
List<Planetas> list = new ArrayList<>();
list.add(p1);
list.add(p2);
list.add(p3);
continentes.setPlanetas(list);
if (continentesRepository.save(continentes)) {
}

Documento Generado

{ "_id" : ObjectId("587e7747a6cca937ac6fb6bf"),
"idcontinente" : "am",
"continente" : "America",
"planetas" : [
{
"idplaneta" : "tr"
},
{
"idplaneta" : "mr"
},
{
"idplaneta" : "jp"
}
]
}

Listas de Objetos Java

Para definir listas de objetos Java no se utilizara ninguna anotación. Solo se declara List < >; de tipos de datos Java

(String, Integer, Double,etc)

Entity

@Getter
@Setter
public class Continentes {
@Id
private String idcontinente;
private String continente;
private List<String> ciudades;
}

Controller

Continentes continentes = new Continentes();
continentes.setIdcontinente("am");
continentes.setContinente("America");
List<String> list = new ArrayList<>();
list.add("Panama");
list.add("Los Santos");
continentes.setCiudades(list);
continentesRepository.save(continentes);

Documento

 {
"_id" : ObjectId("587ec427b2a08a14f778b0f1"),
"idcontinente" : "am",
"continente" : "America",
"ciudades" : [
"Panama",
"Los Santos"
]
}