Query

Hasta ahora nos hemos dedicado a ver las diversas formas de persistencia que soporta Hibernate en funcin de
nuestro modelo de objetos de negocio en Java. Pero una caracterstica fundamental de cualquier ORM es la
necesidad de leer dichos objetos de la base de datos.

Hibernate tiene el objeto Query que nos da acceso a todas las funcionalidades para poder leer objetos desde la
base de datos. Veamos ahora un sencillo ejemplo de cmo funciona y posteriormente explicaremos ms
funcionalidades de la clase Query.

1 Query query = session.createQuery("SELECT p FROM Profesor p");
2 List<Profesor> profesores = query.list();

3 for (Profesor profesor : profesores) {
4 System.out.println(profesor.toString());
5 }

Lanzar una consulta con Hibernate es bastante simple. Usando la session llamamos al mtodo
createQuery(String queryString) con la consulta en formato HQL y nos retorna un objeto Query (Lnea 1).
Despus, sobre el objeto Query llamamos al mtodo list() que nos retorna una lista de los objetos que ha
retornado (Lnea 2).
Por ltimo en las lneas de la 3 a la 5 podemos ver cmo usar la lista de objetos Profesor aunque este
cdigo ya es simplemente el uso de la clase java.util.List que no tiene nada que ver con Hibernate.

En la siguiente leccin se explica en detalle se explica en detalle el lenguaje de consultas que usa Hibernate, ya
que no se usa SQL sino Hibernate Query Languaje (HQL)

Modelo
En los ejemplos que vamos a realizar van a usarse las siguientes clases Java y tablas, que solo mostraremos en
formato UML. No vamos a poner el cdigo fuente ni los ficheros de hibernate de mapeo ya que no todas las
caractersticas que usan han sido explicadas en lecciones anteriores.

Modelo de Java
El modelo de clases Java es el siguiente:

Modelo de Tablas
El modelo de tablas es el siguiente:

Query
Pasemos ahora a ver las funcionalidades de la clase Query

Lista de Objetos list()
Como ya hemos dicho el mtodo list() nos retorna una lista con todos los objetos que ha retornado la
consulta. En caso de que no se encuentre ningn resultado se retornar una lista sin ningn elemento.

1 Query query = session.createQuery("SELECT p FROM Profesor p");
2 List<Profesor> profesores = query.list();
3 for (Profesor profesor : profesores) {
4 System.out.println(profesor.toString());
5 }

Lista de Array de Objetos
Tan y como veremos en la siguiente leccin sobre HQL, tambin se permite que las consultas retornen datos
escalares en vez de clases completas.

SELECT p.id,p.nombre FROM Profesor p

En la consulta podemos ver cmo en vez de retornar un objeto Profesor se retorna nicamente el cdigo del
profesor y su nombre.

En estos casos el mtodo list() retorna una lista con una Array de objetos con tantos elementos como
propiedades hayamos puesto en la SELECT.

Veamos ahora un ejemplo.

1 Query query = session.createQuery("SELECT p.id,p.nombre FROM Profesor p");
2 List<Object[]> listDatos = query.list();
3 for (Object[] datos : listDatos) {
4 System.out.println(datos[0] + "--" + datos[1]);
5 }

Consulta con datos escalares
En la lnea 1 vemos cmo se crea el objeto Query con la consulta de datos escalares.
En la lnea 2 se ve que el mtodo list() retorna una lista de array de Objetos.Es decir 'List<Object[]>'.
En la lnea 4 se inicia el bucle para recorrer cada una de las filas de datos escalares.
En la lnea 5 finalmente se accede a los 2 datos de cada fila mediante datos[0] y datos[1].

Lista de Objeto
Hay otro caso cuando hay una nica columna en el SELECT de datos escalares. Es ese caso, como el array a
retornar dentro de la lista solo tendra un elemento, no se retorna una lista de arrays List<Object[]> sino
nicamente una lista de elementos List<Object>.

Si modificamos la anterior consulta de forma que slo se retorne el nombre, el cdigo quedar de la siguiente
forma:

1 Query query = session.createQuery("SELECT p.nombre FROM Profesor p");
2 List<Object> listDatos = query.list();
3 for (Object datos : listDatos) {
4 System.out.println(datos);
5 }
Consulta con slo un nico dato escalar
En la lnea 1 ahora la consulta slo tiene un nico dato escalar.
En la lnea 2 el mtodo list() ya no retorna un List<Object[] sino un List<Object>.
En la lnea 4 se inicia el bucle para recorrer cada una de las filas de datos escalares pero ahora el tipo es
Object en vez de Object[].
En la lnea 5 finalmente se accede al dato sin el ndice del array ya que ha dejado de serlo.

uniqueResult()
En muchas ocasiones una consulta nicamente retornar cero o un resultado. En ese caso es poco prctico que
nos retorne una lista con un nico elemento. Para facilitarnos dicha tarea Hibernate dispone del mtodo
uniqueResult().

Este mtodo retornar directamente el nico objeto que ha obtenido la consulta. En caso de que no encuentre
ninguno se retornar null.

1 Profesor profesor = (Profesor) session.createQuery("SELECT p FROM Profesor p
WHERE id=1001").uniqueResult();
2 System.out.println("Profesor con Id 1001=" + profesor.getNombre());

Vemos cmo, gracias al mtodo uniqueResult() , se simplifica el cdigo aunque siempre se debe comprobar
si ha retornado o no null.

Al igual que ocurre con list() el mtodo uniqueResult() puede retornar tanto un objeto de una entidad,
un array de objetos escalares Object[] o un nico objeto escalar Object.
Si el mtodo uniqueResult() retorna ms de un resultado se producir la excepcin:

org.hibernate.NonUniqueResultException: query did not return a unique result

Paginacin
La paginacin es parte fundamental de cualquier aplicacin ya que una consulta puede tener miles de
resultados y no queremos mostrarlos todos a la vez.

Para conseguir paginar el resultado de una consulta la clase Query dispone de los siguientes mtodos:
setMaxResults(int maxResults): Establece el n mximo de objetos que van a retornarse.
setFirstResult(int firstResult): Establece el primer de los objetos que se van a retornar.

Al realizar la paginacin son necesarios al menos 2 valores:
El tamao de la pgina
El n de la pgina a mostrar

Con esos 2 valores hemos creado el siguiente cdigo Java que muestra una nica pgina en funcin del
tamanyoPagina y paginaAMostrar.

1 int tamanyoPagina = 10;
2 int paginaAMostrar = 7;
3
4 Query query = session.createQuery("SELECT p FROM Profesor p Order By p.id");
5 query.setMaxResults(tamanyoPagina);
6 query.setFirstResult(paginaAMostrar * tamanyoPagina);
7 List<Profesor> profesores = query.list();
8
9 for (Profesor profesor : profesores) {
10 System.out.println(profesor.toString());
11 }

Mostrar el contenido de una nica pgina
Las lneas 1 y 2 establecen los valores necesarios para poder mostrar la pgina, que son el tamao de la
pgina y el n de la pgina a mostrar.
En la lnea 4 se crea la Query.
En la lnea 5 se llama al mtodo setMaxResults(int maxResults) para indicar que slo se
retornen como mximo tantos objetos como tamao tiene la pgina.
En la lnea 6 se llama al mtodo setFirstResult(int firstResult) para indicarle cul es el
primer objeto a retornar. Este valor coincidir con el primer objeto de la pgina que se quiere mostrar.
Para calcular dicho valor se multiplica el n de la pgina a mostrar por el tamao de pgina. Para que
esta formula funcione el nmero de pgina debe empezar por 0, es decir, que la primera pgina deber
ser la n 0, la segunda la n 1, y as sucesivamente.
Por fn, en la lnea 7 se obtienen nicamente los resultados de la pgina solicitada.
Por ltimo en las lneas 9,10 y 11 se muestran los datos.
El mayor problema que tiene la paginacin es determinar el n de pginas para poder mostrrselo al
usuario, para saber el n de pginas es necesario conocer el n de objetos que retorna la consulta y la
forma mas rpida y sencilla es mediante una consulta que las cuente.
El siguiente cdigo Java calcula el n de pginas de la consulta.

1 long numTotalObjetos = (Long) session.createQuery("SELECT count(*) FROM
Profesor p").uniqueResult();
2 int numPaginas =(int) Math.ceil((double)numTotalObjetos /
(double)tamanyoPagina);

En la lnea 1 realizamos la consulta de count(*) para obtener el n de objetos que retorna la consulta
En la lnea 2 de divide el n total de objetos entre el tamao de la pgina obtenindose el n total de
pginas.

Al hacer la divisin para calcular el n de pginas es necesario hacer el cast de los 2 valores a double ya que si
no Java automticamente redondea el resultado a un valor entero con lo que el valor que se le pasa a ceil ya
no ser el correcto.
Consultas con nombre
En cualquier libro sobre arquitectura del software siempre se indica que las consultas a la base de datos no
deberan escribirse directamente en el cdigo sino que deberan estar en un fichero externo para que puedan
modificarse fcilmente.

Hibernate provee una funcionalidad para hacer sto mismo de una forma sencilla. En cualquier fichero de
mapeo de Hibernate se puede incluir el tag <query> con la consulta HQL que deseamos lanzar.

En el siguiente ejemplo podemos ver cmo se ha definido una query en el fichero Profesor.hbm.xml.

1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD
3.0//EN" "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
3 <hibernate-mapping>
4 <class name="ejemplo01.Profesor">
5 <id column="Id" name="id" type="integer"/>
6 <property name="nombre"/>
7 <property name="ape1"/>
8 <property name="ape2"/>
9 </class>
10
11
12 <query name="findAllProfesores"><![CDATA[
13 SELECT p FROM Profesor p
14 ]]></query>
15 </hibernate-mapping>

query con nombre "findAllProfesores"

Vemos cmo en las lneas 12, 13, y 14 se ha definido la consulta llamada findAllMunicipios mediante el
tag <query>.

Tag <query>
Este tag tiene los siguientes datos:
name: Este atributo define el nombre de la consulta. Es el nombre que posteriormente usaremos
desde el cdigo Java para acceder a la consulta.
contenido: El contenido del tag <query> es la consulta en formato HQL que ejecutar Hibernate.

Hacer notar que la consulta se ha incluido dentro de la instruccin CDATA de XML para evitar que algn
smbolo de > o < de la consulta se pueda interpretar como cierre del tag <query>.
CDATA forma parte de la especificacin de los ficheros XML no siendo algo que se ha definido en Hibernate.

Cdigo Java
Para hacer uso de una consulta con nombre usaremos el mtodo getNamedQuery(String queryString)
en vez de createQuery(String queryString) para obtener el objeto Query. Por lo tanto slo se ha
modificado la lnea 1 y el resto del cdigo queda exactamente igual.

1 Query query = session.getNamedQuery("findAllProfesores");
2 List<Profesor> profesores = query.list();
3 for (Profesor profesor : profesores) {
4 System.out.println(profesor.toString());
5 }
Como podemos ver el uso de consultas con nombre es muy sencillo al usar Hibernate.