Overview
En esta guía, puede aprender a asignar una jerarquía de clases de Java a una colección de MongoDB mediante el uso de la extensión Hibernate ORM. Cuando una subclase de Java extiende una clase principal y hereda sus campos, las clases forman una jerarquía. Hibernate ORM proporciona estrategias de herencia que determinan cómo la extensión almacena cada clase en una jerarquía. La estrategia que elija determina qué colecciones contienen sus datos y la forma de los documentos resultantes.
La extensión Hibernate ORM admite las siguientes estrategias de herencia:
Herencia de tabla única: La extensión Hibernate ORM almacena una jerarquía de clases completa en una única colección.
Superclases mapeadas: Una superclase que no es una entidad aporta sus campos a cada subclase sin una colección propia.
La extensión no admite las estrategias de herencia JOINED y TABLE_PER_CLASS. Para aprender más, consulte la sección Estrategias no admitidas de esta guía.
Herencia de tabla única
En la estrategia de herencia de tabla única, el marco de trabajo almacena cada clase en una jerarquía dentro de la misma colección de MongoDB. Para usar esta estrategia, aplique la anotación @Inheritance(strategy = InheritanceType.SINGLE_TABLE) a la entidad raíz, la clase principal de nivel más alto en la jerarquía.
Dado que la colección contiene documentos que se asignan a varias clases, la extensión debe registrar la clase a la que se asigna cada documento. La extensión almacena esta información en un campo discriminator cuando guarda un objeto. Cuando query la colección, la extensión lee el valor discriminador para determinar qué clase instanciar.
Para especificar el campo discriminador, aplique la anotación @DiscriminatorColumn a la entidad raíz. Para establecer el valor del discriminador de una clase, aplicar la anotación @DiscriminatorValue a la clase.
El siguiente ejemplo mapea una jerarquía Movie a la colección movies. Las subclases Actor y Director heredan el campo name de Movie, pero cada subclase también añade su propio campo. Cada documento almacena ya sea "actor" o "director" en el campo discriminador role.
@Entity@Table(name = "movies")@Inheritance(strategy = InheritanceType.SINGLE_TABLE)@DiscriminatorColumn(name = "role")public abstract class Movie { @Id @ObjectIdGenerator private ObjectId id; private String name;
// Getter and setter methods
}
@Entity@DiscriminatorValue("actor")public class Actor extends Movie { private List<String> awards;
// Getter and setter methods
}
@Entity@DiscriminatorValue("director")public class Director extends Movie { private String studio;
// Getter and setter methods
}Cuando llama al método persist() en una instancia de Actor o en una instancia de Director, la extensión inserta el documento correspondiente en la colección movies. Cada documento contiene los campos que define su propia clase y el valor discriminador para esa clase:
{ "_id": ObjectId("..."), "role": "actor", "name": "Andrew Garfield", "awards": ["Golden Globe Award"] }{ "_id": ObjectId("..."), "role": "director", "name": "Greta Gerwig", "studio": "Warner Bros." }El ejemplo anterior utiliza un discriminador de string, el tipo de discriminador por defecto. Para cambiar este tipo, establezca el elemento discriminatorType de la anotación @DiscriminatorColumn. Establezca este elemento en DiscriminatorType.CHAR para almacenar el discriminador como un carácter, o en DiscriminatorType.INTEGER para almacenar el discriminador como un número entero.
Importante
Los discriminadores de caracteres y enteros requieren un valor explícito
Hibernate no establece por defecto el valor del discriminador de una clase al nombre de la clase para discriminadores de caracteres o enteros. Si establece discriminatorType en DiscriminatorType.CHAR o DiscriminatorType.INTEGER, debe agregar una anotación @DiscriminatorValue a la entidad raíz y a cada subclase, incluso si nunca crea una instancia directamente de la entidad raíz.
Query una jerarquía de tabla única
La colección movies contiene documentos para cada clase en la jerarquía Movie. Cuando realiza una query en una de estas clases, la extensión Hibernate ORM filtra en el campo discriminador para que la query devuelva documentos solo para esa clase. Este filtro depende de qué clase estás haciendo query:
Si realiza una query en una subclase, la extensión coincide con los documentos cuyo discriminador es igual al valor del discriminador de esa subclase. La consulta de
Actoren el ejemplo anterior solo coincide con los documentos en los querolees"actor".Si realiza una query en la clase raíz, la extensión no añade un filtro. La query lee cada documento de la colección y utiliza el valor del discriminador de cada documento para devolver un objeto de la clase correcta. Consultar
Movieen el ejemplo anterior devuelve los documentosActoryDirector. Si la colección contiene un documento cuyo valor de discriminador no se asigna a una clase en la jerarquía, la query arroja unHibernateException.
Para más información sobre las entidades de query, consultar la guía Especificar una query.
Superclases mapeadas
Una superclase mapeada comparte asignaciones de campo con sus subclases sin convertirse en una entidad en sí misma. Para crear una superclase mapeada, aplique la anotación @MappedSuperclass a la superclase. Dado que una mapped superclass no es una entity, la extensión de Hibernate ORM no crea una colección para ella, y no puedes hacer una query directamente.
Cada subclase que hereda una superclase mapeada se mapea a su propia colección. En cada documento, la extensión almacena los campos heredados y los campos propios de la subclase como campos de nivel superior. La extensión no anida los campos heredados ni los almacena por separado.
El siguiente ejemplo define una superclase asignada MovieDetails que proporciona las asignaciones de identificador y nombre para una entidad Genre y una entidad Language:
@MappedSuperclasspublic abstract class MovieDetails { @Id @ObjectIdGenerator private ObjectId id; private String name;
// Getter and setter methods
}
@Entity@Table(name = "genres")public class Genre extends MovieDetails { private String description;
// Getter and setter methods
}
@Entity@Table(name = "languages")public class Language extends MovieDetails { private String code;
// Getter and setter methods
}En el ejemplo anterior, la anotación @MappedSuperclass permite que MovieDetails defina las asignaciones id y name sin convertirse en una entidad. Las anotaciones @Entity y @Table en Genre y Language luego asignan cada subclase a su propia colección.
Como resultado, la extensión no crea una colección para MovieDetails. En su lugar, la extensión almacena Genre documentos en la colección genres y Language documentos en la colección languages. Cada documento contiene los campos _id y name que MovieDetails mapea además de los campos que define su clase correspondiente:
{ "_id": ObjectId("..."), "description": "Serious, narrative-driven stories.", "name": "Drama" }{ "_id": ObjectId("..."), "code": "en", "name": "English" }Estrategias no admitidas
La extensión Hibernate ORM no admite las siguientes estrategias de herencia de Hibernate ORM, que almacenan una única jerarquía de clases en varias tablas:
InheritanceType.JOINED: Almacena cada clase en su propia tabla y une las tablas para reconstruir una instanciaInheritanceType.TABLE_PER_CLASS: Almacena cada clase concreta en su propia tabla y combina las tablas para realizar una query en la jerarquía
Si asigna sus clases con cualquiera de las estrategias anteriores, la extensión arroja un FeatureNotSupportedException.
Importante
Se producen errores al inicio
La extensión Hibernate ORM valida la estrategia de herencia cuando compila la instancia SessionFactory. Una aplicación que utiliza una estrategia no compatible no puede iniciarse.
Información Adicional
Para obtener más información sobre la creación de entidades y la asignación de datos incrustados, consulte la guía Crear entidades para representar colección.
Para aprender a usar sus entidades para ejecutar operaciones de base de datos, consulte las guías Realizar operaciones CRUD y Especificar una query.
Para ver una lista de la funcionalidad que admite la extensión Hibernate ORM, consulte la página Compatibilidad de funcionalidad.
Para aprender más sobre las estrategias de herencia de Hibernate ORM, consulta Herencia en la documentación de Hibernate ORM.