Hibernate Query Language (HQL): consultas y métodos

Hibernate Query Language (HQL)

Query

HQL

Hibernate Query Languaje

Parámetros

Objetos y colecciones

Da acceso a las funcionalidades para poder leer objetos desde la base de datos.

Objeto

list()

Fucionalidades

Retorna una lista con todos los objetos que ha retornado la consulta.

uniqueResult()

Este método retornará directamente el único objeto que ha obtenido la consulta. En caso de que no encuentre ninguno se retornará null.

Paginación

setMaxResults(int maxResults): Establece el nº máximo de objetos que van a retornarse.

setFirstResult(int firstResult): Establece el primer de los objetos que se van a retornar.

Es el lenguaje de consultas que usa Hibernate para obtener los objetos desde la base de datos.

Los tipos de datos son los de Java.

Las consultas son independientes del lenguaje de SQL específico de la base de datos

Las consultas son independientes del modelo de tablas de la base de datos.

Es posible tratar con las colecciones de Java.

Es posible navegar entre los distintos objetos en la propia consulta.

Es sensible a mayúsculas y minúsculas.

Literales

Texto

Integer

Long

double

float

Fecha

Hora

Fecha y hora

Operadores de comparación

”=”, ”>”, ”>=”, ”<”, ”<=”, ”<>”, ”!=”, ”between”, ”in”, ”like”, ”not”, ”is

Operadores lógicos

AND

OR

NOT

Operadores Aritméticos

suma +

resta -

multiplicación *

division /

Funciones de agregación

AVG()

SUM()

MIN()

MAX()

COUNT()

Funciones sobre escalares

UPPER(s)

LOWER(s)

CONCAT(s1, s2)

TRIM(s)

SUBSTRING(s, offset, length)

LENGTH(s)

ABS(n)

SQRT(n)

Operador ”||”

Filtrando

Ordenación

Agrupaciones

ORDER BY

GROUP BY y HAVING

Subconsultas

se soportan 2 métodos

Posicional

Nombre

Se basa en definir cada parámetro como un interrogante ”?”. Posteriormente estableceremos a la clase Query el valor de cada uno de los parámetros.

Los parámetros se definen como nombre precedidos de dos puntos ”:”.

Mejoras

setParameter

setParameter(int position,Object val)

setParameter(String name,Object val)

Métodos encadenados

Todos los métodos de la clase Query que hemos visto para asignar valores a los parámetros retornan el propio objeto Query.

Navegación por propiedades

Permite acceder a propiedades de Clases que no están en la cláusula FROM pero accedemos a ellas desde la clase inicial de la consulta.

Colecciones

HQL puede tratar con colecciones dentro de la propia consulta

SIZE(c): Obtiene el nº de elementos de una colección.

c IS EMPTY: Comprueba si una colección no tiene elementos.

IS NOT EMPTY c: Comprueba si una colección sí tiene elementos.

Caract.

Funciones