Persistencia Hibernate

1.0 DEFINICION DE HIBERNATE los conocidos patrones para la delegación

de persistencia en POJOs.

Hibernate es una herramienta para la Una característica de la filosofía de diseño

plataforma Java que facilita el mapeo de de Hibernate ha de ser destacada

atributos entre una base de datos relacional especialmente, dada su gran importancia:

y el modelo de objetos de una aplicación, puede utilizar los objetos Java definidos por

mediante archivos declarativos (XML) que el usuario tal cual, es decir, no utiliza

permiten establecer estas relaciones. técnicas como generación de código a partir

Hibernate es una herramienta ORM de descriptores del modelos de datos o

completa que ha conseguido en un tiempo manipulación de bytecodes en tiempo de

record una excelente reputación en la compilación (técnica conocida por su

comunidad de desarrollo posicionándose amplio uso en JDO), ni obliga a

claramente como el producto OpenSource implementar interfaces determinados, ni

líder en este campo gracias a sus heredar de una superclase. Utiliza en vez de

prestaciones, buena documentación y ello el mecanismo de reflexión de Java,

estabilidad. Es valorado por muchos incluso característica que le permite un modelado

como solución superior a productos iterativo fluido y natural basado en UML,

comerciales dentro de su enfoque, siendo un factor fundamental para lograr un

una muestra clara de su reputación y trabajo ágil y productivo. Además abre las

soporte la reciente integración dentro del puertas a utilizar herencia en el modelo de

grupo JBoss que seguramente generará datos (esta opción estaría limitada si una

iniciativas muy interesantes para el uso de herramienta nos obliga a que los objetos de

Hibernate dentro de este servidor de datos hereden de una superclase por no

aplicaciones. soportar Java herencia múltiple).

Se empezó a desarrollar hace algo más de 2

años por Gavin King siendo hoy Gavin y Hibernate – Características

Christian Bauer los principales gestores de

su desarrollo. • No intrusivo (estilo POJO)
Hibernate parte de una filosofía de mapear • Muy buena documentación (forums
objetos Java "normales", también conocidos para ayuda, libro)
en la comunidad como "POJOs" (Plain Old • Comunidad activa con muchos usuarios
Java Objects), no contempla la posibilidad • Transacciones, caché, asociaciones,
de automatizar directamente la persistencia polimorfismo, herencia, lazy loading,
de Entity Beans tipo BMP (es decir, generar persistencia transitiva, estrategias de
automáticamente este tipo de objetos), fetching.
aunque aún así es posible combinar
Hibernate con este tipo de beans utilizando

1
Persistencia
• Potente lenguaje de consulta (HQL):
subqueries, outer joins, ordering,
proyeccion (report query), paginacion.
• Facil testeo.
• No es estandard.
¿Por qué necesitamos Hibernate?
Si se esta trabajando con programación
orientada a objetos y bases de datos
relacionales, seguramente habrás observado
que estos son dos paradigmas diferentes.
El modelo relacional trata con relaciones,
tuplas y conjuntos y es muy matemático por
naturaleza. Sin embargo, el paradigma
orientado a objetos trata con objetos, sus
atributos y relaciones entre objetos. Cuando
se quiere hacer que los objetos sean
persistentes utilizando para ello una base de
datos relacional, uno se da cuenta de que
hay una desavenencia entre estos dos
paradigmas, la también llamada diferencia
objeto-relacional (object – relational gap”).
Un mapeador objeto-relacional (ORM ) nos
ayudará a evitar esta diferencia.
¿Cómo se manifiesta esta brecha entre
ambos paradigmas? Si estamos utilizando
Hibernate
objetos en nuestra aplicación y en algún
momento queremos que sean persistentes,
normalmente abriremos una conexión
JDBC, crearemos una sentencia SQL y
copiaremos todos los valores de las
propiedades sobre una PreparedStatement
o en la cadena SQL que estemos
construyendo. Esto podría ser fácil para un
objeto de tipo valor (value object:VO) de
pequeño tamaño pero consideremos esto
para un objeto con muchas propiedades.
Este no es el único problema. ¿Qué pasa
con las asociaciones? ¿Y si el objeto
contiene a su vez a otros objetos? ¿Los
almacenaremos también en la Base de
Datos? ¿Automáticamente? ¿Manualmente?
¿Qué haremos con las claves ajenas?
Preguntas similares surgen a la hora de
“cargar” un dato de la BD de un VO (se
denomina value object o VO a un objeto
que contiene información de negocio
estructurada en grupos de ítems de datos,
también recibe el nombre de transfer
object).
Como se puede ver, la brecha existente
entre los paradigmas de objeto y relacional
se vuelve mucho mayor si disponemos de
modelos con objetos “grandes”. Y hay
muchas más cosas a considerar como la
carga lenta, las referencias circulares, el
caché, etc. De hecho, hay estudios que
demuestran que el 35% del código de una
aplicación se produce como consecuencia
del mapeado (correspondencia) entre los
datos de la aplicación y el almacén de
datos.
2
Persistencia
Entonces, lo que necesitamos es una
herramienta ORM (Object Relational
Mapping). Básicamente, una ORM intenta
hacer todas estas tareas pesadas por
nosotros. Con una buena ORM, sólo
tendremos que definir la forma en la que
establecemos la correspondencia entre las
clases y las tablas una sola vez (indicando
que propiedad se corresponde con que
columna, que clase con que tabla, etc.).
Después de esto, podremos hacer cosas
como utilizar POJO’s (Plain Old Java
Objects) de nuestra aplicación y decirle a
nuestra ORM que los haga persistentes, con
una instrucción similar a esta:
orm.save(myObject). Es decir, una
herramienta puede leer o escribir en la base
de datos utilizando VO’s directamente.
Más formalmente: un modelo del dominio
representa las entidades del negocio
utilizadas en una aplicación Java. En una
arquitectura de sistemas por capas, el
modelo del dominio se utiliza para ejecutar
la logica del negocio (en Java, no en la base
de datos). Esta capa del negocio se
comunica con la capa de persistencia
subyacente para recuperar y almacenar los
objetos persistentes del modelo del
dominio. ORM es el middleware en la capa
de persistencia que gestiona la persistencia.
Hibernate es un ORM de libre distribución,
que además, es de las más maduras y
completas. Actualmente su uso esta muy
extendido y además esta siendo
desarrollada de forma muy activa. Una
característica muy importante que distingue
Hibernate de otras soluciones al problema
Hibernate
de la persistencia, como los Ejes de entidad,
es que la clase Hibernate persistente puede
utilizarse en cualquier contexto de
ejecución, es decir, no se necesita un
contenedor especial para ello.
Hibernate Query Language HQL
Hibernate nos proporciona además un
lenguaje para el manejo de consultas a la
base de datos.
Este lenguaje es similar a SQL y es
utilizado para obtener objetos de la base de
datos según las condiciones especificadas
en el HQL.
El uso de HQL nos permite usar un
lenguaje intermedio que según la base de
datos que usemos y el dialecto que
especifiquemos será traducido al SQL
dependiente de cada base de datos de forma
automática y transparente
Herramientas usadas junto con
Hibernate
Existen diversas herramientas útiles para el
uso de Hibernate que cubren todo el
desarrollo desde nuestra aplicación hasta
nuestra base de datos y viceversa:
3
Persistencia Hibernate

rasgos al concepto de conexión de JDBC y

cumple un papel muy parecido, es decir,
sirve para delimitar una o varias
operaciones relacionadas dentro de un
proceso de negocio, demarcar una
transacción y aporta algunos servicios
adicionales como una caché de objetos para
evitar interacciones innecesarias contra la
BD. En este sentido veremos que la clase
Session ofrece métodos como save(Object
object), createQuery(String queryString),
Desde herramientas de modelado UML
beginTransaction(), close(), etc. para
como por ejemplo con Poseidon podemos
interactuar con la BD tal como estamos
generar modelos entidad relación que son
acostumbrados a hacerlo con una conexión
traducidos por AndroMDA a POJO's y
JDBC (de hecho "envuelve" una conexión
mediante XDoclet se generan los ficheros
JDBC), pero con una diferencia: mayor
HBM. Todas estas tareas se automatizan
simplicidad, es decir, guardar un objeto, por
mediante el uso de ANT.
ejemplo, consiste en algo así como
session.save(miObjecto), sin necesidad de
Otra opción es crear la base de datos con
especificar una sentencia SQL, y esto es
una herramienta de modelado y a partir de
sólo un ejemplo muy trivial en el que
la base de datos una vez creada usar
ganamos relativamente poco utilizando
Middlegen para generar los ficheros HBM
Hibernate.
y a partir de estos los POJO's mediante
hbm2java
Con esto volvemos a los conceptos de
transient y persistent: los primeros son
Los conceptos básicos de Hibernate
objetos que sólo existen en memoria y no
en un almacén de datos (recuérdese en este
Hibernate se distingue entre objetos tipo
sentido también el modificador transient de
transient y tipo persistent.
Java), en algunos casos, no serán
Para almacenar y recuperar estos objetos de
almacenados jamás en la base de datos y en
la base de datos, el desarrollador debe
otros es un estado en el que se encuentran
mantener una conversación con el motor de
hasta ser almacenados en ella. Los
Hibernate mediante un objeto especial,
segundos se caracterizan por haber sido ya
quizás el concepto clave más importante
almacenados y ser por tanto objetos
dentro Hibernate, que es la Sesión (clase
persistentes. Dicho de otra: manera los
Session). Se puede equiparar a grandes
objetos transient han sido instanciados por

4
Persistencia Hibernate

el desarrollador sin haberlos almacenado perteneciente a su correspondientes thread y

mediante una sesión, los objetos con su contexto de objetos en caché,
persistentes han sido creados y transacciones, etc. Como tal no sorprende
almacenados en una sesión o bien devueltos que las sesiones no son “thread-safe” y que
en una consulta realizada con la sesión. la información vinculada a ella no sea
visible para otras sesiones. Es también
Igual que con las conexiones JDBC hemos lógico que tenga que existir una
de crear y cerrar sesiones, aunque no hay “institución” superior para crear sesiones y
una relación 1:1 entre sesiones y realizar operaciones comunes a los
conexiones, es decir, no tenemos que abrir diferentes threads como lo puede ser la
y cerrar simultáneamente sesiones y gestión de una caché compartida entre
conexiones JDBC, la política a seguir threads o caché de segundo nivel. Este
dependerá del contexto del proceso de elemento es la clase SessionFactory y en
negocio de cada situación dándonos ella podremos encontrar métodos como
Hibernate amplias posibilidades para la openSession()o evict(Class persistentClass).
implementación de nuestras políticas Por fin tenemos que pensar también en qué
(conexiones JDBC gestionadas por la sucede si en un entorno de múltiples hilos
aplicación, por Hibernate, por un posible de ejecución la aplicación accede a un
servidor de aplicaciones, etc.), siendo mismo objeto desde dos sesiones diferentes.
solamente necesario en la práctica crear y Vimos que una instancia de un objeto
cerrar explícitamente las sesiones de persistente nunca es compartida por dos
Hibernate. sesiones al contar cada una con su propio
Hemos visto que las sesiones son un contexto para ello, de modo que existirán
concepto ligado a un proceso de negocio, dos instancias dentro de la misma máquina
por tanto es natural pensar que una sesión virtual Java para un “mismo” objeto de
siempre va a pertenecer a un mismo thread datos, lo cual no lleva al concepto de
de ejecución (el que pertenece a la identidad.
ejecución de un método de negocio para un Hay que distinguir entre identidad de
usuario o sistema externo concreto), aunque instancia Java, es decir: objeto1 == objeto2,
técnicamente se pueden compartir sesiones identidad persistente:
entre threads, esto no se debe hacer jamás objeto1.getId().equals(objeto2.getId)) y la
por no ser una buena política de diseño y identidad a nivel de base de datos (claves
los consecuentes problemas que puede primarias iguales). Por tanto, puede haber
generar. dentro de la misma máquina virtual varios
Es decir, en un entorno multiusuario y por objetos con la misma identidad persistente,
tanto multithread habrá por tanto múltiples pero diferentes identidades como instancias
sesiones simultáneas, cada una por ser objetos de datos Java que

5
Persistencia Hibernate

representan la misma entidad persistente. seguridad se debe especificar de forma

Normalmente la identidad persistente del declarativa, es decir en sus metadatos.
objeto y la identidad de base de datos Un servidor de aplicaciones J2EE, tal
coincidirán, pero esto puede no ser así para como JBoss, Bea WebLogic o IBM
lógicas de negocio muy particularidad. En WebSphere implementan un entorno
todo caso, esta política depende del gestionado para Java.
desarrollador que puede jugar, por ejemplo, • Entorno no gestionado: proporciona
con sobreescribir el método equals() para una gestión básica de la concurrencia a
definir un comportamiento peculiar y través de un pooling de threads. Un
utilizar claves especiales para la identidad contenedor de servlets, como Tomcat
de objetos diferenciándolas o proporciona un entorno de servidor no
relacionándolas con la propiedad del objeto gestionado para aplicaciones Web Java.
utilizada como clave primaria para su Una aplicación stand-alone también se
presistencia en la base de datos. considera como no gestionada. Los
entornos no gestionados no
Configuración de Hibernate
proporcionan infraestructura para
Para utilizar Hibernate en una aplicación, es transacciones automáticas, gestiones de
necesario conocer como configurarlo. recursos, o seguridad. La propia
Hibernate puede configurarse y ejecutarse aplicación es la que gestiona las
en la mayoría de aplicaciones java y conexiones con la base de datos y
entornos de desarrollo. Generalmente, establece los límites de las
Hibernate se utiliza en aplicaciones transacciones.
cliente/servidor de dos y tres capas, Tanto en un entorno gestionado como en
desplegándose Hibernate únicamente en el uno no gestionado, lo primero que debemos
servidor. Las aplicaciones cliente hacer es iniciar Hibernate. Para hacer esto
normalmente utilizan un navegador Web, debemos crear una Session Factory desde
pero las aplicaciones swing y AWT una Configuration.
también son usuales. Aunque solamente
vamos a ver como configurar Hibernate en
un entorno no gestionado, es importante
comprender la diferencia entre la
configuración de Hibernate para entornos
gestionados y no gestionados:
• Entorno gestionado: los pools de
recursos tales como conexiones a la
base de datos permiten establecer los
límites de las transacciones y la

6
Persistencia Hibernate

2.0 ARQUITECTURA
Configuración de la base de datos
El API de Hibernate es una arquitectura de
dos capas (Capa de persistencia y Capa de
Negocio).
En la siguiente Figura se muestran los roles
de las interfaces Hibernate más importantes
en las capas de persistencia y de negocio de
una aplicación J2EE. La capa de negocio
está situada sobre la capa de persistencia,
debido a que actúa como un cliente de la
capa de persistencia.

Resumen de pasos de configuración

• Situar el *.jar del driver JDBC elegido

y el fichero hibernate2.jar en nuestro
classpath
• Añadir las dependencias de Hibernate
(directorio (lib)) en el classpath.
(lib/README.txt contiene una lista de Las Interfaces mostradas se clasifican de la
librerías requeridas y opcionales). siguiente forma:

• Elegir y configurar un pool de • Interfaces llamadas por la aplicación para

conexiones JDBC realizar operaciones básicas:

• Determinar las propiedades de - Session: interfaz primaria utilizada

Configuración en un fichero en cualquier aplicación Hibernate

hibernate.properties en el classpath, (SessionFactory).

• Crear una instancia de Configuración
en nuestra aplicación y cargar los
ficheros de mapeado XML utilizando
addResource() o addClass().
• Obtener una SessionFactory a partir de
Configuration llamando
BuildSessionFactory().
- Transaction
- Query: permite realizar peticiones
a la base de datos y controla cómo se
ejecuta dicha petición (query). Las
peticiones se escriben en HQL o en el
dialecto SQL nativo de la base de datos
a
que estamos utilizando. Una instancia
Query se utiliza para enlazar los

7
Persistencia Hibernate

parámetros de la petición, limitar el para los desarrolladores optar por

numero de resultados devueltos por la Hibernate.
petición y para ejecutar dicha petición. Si bien es cierto existe una brecha grande
• Interfaces llamadas por el código de la entre los elementos que intervienen en el
infraestructura de la aplicación para análisis y desarrollo de las aplicaciones de
configurar Hibernate. La más importante los proyectos que actualmente están
es la clase Configuration: se utiliza para utilizando el paradigma orientados a
configurar y "arrancar" Hibernate. La objetos, esto aun se ve aplazado por un
aplicación utiliza una instancia de ancla el cual es la base de datos de tipo
Configuration para especificar la relacional, sin embargo en la actualidad este
ubicación de los documentos que indican trabajo de conexión y manipulación de
el mapeado de los objetos y propiedades información de la base de datos ya no es tan
específicas de Hibernate, y a continuación tediosa gracias a la aparición de Hibernate,
crea la Session Factory. de la cual toda aplicación Web hecha en

• Interfaces callback que permiten a la Java que necesite interactuar con la base de

aplicación reaccionar ante determinados datos puede hacer uso, lo cual simplifica

eventos que ocurren dentro de la enormemente la programación de lógica.

aplicación, tales como Interceptor,

Lifecycle, y Validatable. 4.0 CASOS DE ÉXITO

• Interfaces que permiten extender las

A. Adding Technology ha colaborado,
funcionalidades de mapeado de
por mediación de acuerdos firmados
Hibernate, como por ejemplo UserType,
con Soluziona, en el diseño y posterior
CompositeUserType, e
desarrollo de la intranet corporativa de
IdentifierGenerator.
Feria de Muestras de Valencia.
Además, Hibernate hace uso de APIs de
Se decide implantar un sistema que sea
Java, tales como JDBC, JTA (Java
capaz de simplificar todas las tareas
Transaction Api) y JNDI (Java Naming
administrativas que supone la
Directory Interface).
celebración de un evento en la Feria de
Muestras de Valencia.
3.0 APLICACIÓN
Además se pretende no solo simplificar
sino unificar y asegurar el
Prácticamente, no hay lugar donde el uso de
cumplimiento de todas las tareas de
este framework no sea útil, las aplicaciones
cada proceso de negocio.
Java que requieran una constante
La intranet esta desarrollada con las
manipulación de base de datos requieren
siguientes tecnologías:
por su facilidad de manejo y versatilidad

8
Persistencia Hibernate

Hibernate: motor de persistencia.

SQLServer 2000: base de datos
Struts y Tiles Ajax Servicios webs con Axis
Servidor de aplicaciones JBoss 5.0 CONCLUSIONES Y
Diferentes patrones de diseño como RECOMENDACIONES
Delegate, DAO, DTO, fachade, etc.
* Utilizar un framework de ORM
simplifica enormemente la programación de
lógica de persistencia. Se trata de una idea
completamente madura que cada vez se
B. Desarrollo e implementación de vuelve más popular. Nuestra lógica de
aplicación comercial (ERP) en Web, negocios trabaja contra un modelo de
orientada a resolver la toma de dominio completamente orientado a
decisiones en todas las actividades de la objetos. Generamos entre un 30% y un 40%
empresa: Comercialización, menos de código y el tipo de código
Abastecimiento, Finanzas, Costos, generado es mucho más sencillo y
Producción, Contabilidad, mantenible.
Presupuestos, Distribución, y control de * Es fundamental conocer bien como
Gestión (administrativa, contable, funcionan las tecnologías que utilizamos.
presupuestaria, entre otras). En el caso de Hibernate hemos visto que
Tecnología Utilizada: Oracle dependiendo de como hagamos las cosas
Aplication Server10g–iDS 10g–Oracle puede afectar directamente al rendimiento
Server 10g. de la aplicación.
Esto no quiere decir que no debamos usar
Hibernate, al contrario, Hibernate nos
proporciona grandes beneficios como es la
C. Bunge Argentina S.A
independencia de la base de datos, bajo
Workflow de usuarios: Desarrollo de
acoplamiento entre negocio y persistencia,
workflow para la gestión de usuarios y
y un desarrollo rápido, ya que con
permisos de los diferentes ambientes de
Hibernate podremos cubrir de manera
los sistemas de la organización
sencilla y rápida el 80 - 90% de la
Workflow de Ajuste de Stock:
persistencia de nuestra aplicación. Esto nos
Desarrollo de workflow para la gestión
permite centrar nuestros esfuerzos en
de Ajustes de Stock y Transferencias en
optimizar las consultas que realmente lo
y entre Plantas de productos
merecen.
Tecnología Utilizada: Oracle9i - J2EE -
* En cuanto al manejo de consultas
Hibernate - JBoss - Oracle Workflow.
Hibernate saca una ligera ventaja ya que

9
Persistencia Hibernate

tiene su propio lenguaje “HQL” que lo

hace multi – motor de base de datos, eso es
uno de los atractivos de Hibernate.
* Hibernate soporta la mayoría de los
sistemas de bases de datos SQL. El
Hibernate Query Language, diseñado como
una extensión mínima, orientada a objetos,
de SQL, proporciona un puente elegante
entre los mundos objeto y relacional.
Hibernate ofrece facilidades para
recuperación y actualización de datos,
control de transacciones, repositorios de
conexiones a bases de datos, consultas
programáticas y declarativas, y un control
de relaciones de entidades declarativas.
* Hibernate es una muy buena herramienta
en lo que se refiere a mapeo clases en una
base de datos relacional, pero en lo que se
refiere al manejo de transacciones y
conexiones le falta funcionalidad y
capacidad.

* Hibernate es menos invasivo que otros

marcos de trabajo de mapeo O/R. Se
utilizan Reflection y la generación de
bytecodes en tiempo de ejecución, y la
generación del SQL ocurre en el momento
de la arrancada. Esto nos permite
desarrollar objetos persistentes siguiendo el
lenguaje común de Java: incluyendo
asociación, herencia, polimorfismo,
composición y el marco de trabajo
Collections de Java.

10