Veamos ahora un sencillo ejemplo de consulta en HQL

SELECT c FROM Ciclo c ORDER BY nombre

¿Qué diferencias podemos ver entre HQL y SQL?

• Ciclo hace referencia a la clase Javaejemplo02.Ciclo y NO a la tabla CicloFormativo.Nótese que la clase Java y la tabla tienen distinto nombre .
• Es necesario definir el alias c de la clase Java Ciclo.
• Tras la palabra SELECT se usa el alias en vez del “*”.
• Al ordenar los objetos se usa la propiedad nombre de la clase Ciclo en vez de la columna nombreCiclo de la tabla CicloFormativo.

SELECT Ciclo FROM Ciclo    

java.lang.NullPointerException

  FROM Ciclo   

Respecto a la sensibilidad de las mayúsculas y minúsculas , el lenguaje HQL sí que lo es, pero con matices.

• Las palabras clave del lenguaje NO son sensibles a las mayúsculas o minúsculas.
  • Las siguientes 2 consultas son equivalentes.

    select count(*) from Ciclo

    SELECT COUNT(*) FROM Ciclo

• El nombre de las clases Java y sus propiedades SI son sensibles a las mayúsculas o minúsculas.
  • La siguiente consulta HQL es correcta

    SELECT c.nombre FROM Ciclo c WHERE nombre='Desarrollo de aplicaciones Web'

  • La siguiente consulta HQL es errónea ya que la propiedad nombre está escrita con la “N” en mayúsculas.

    SELECT c.Nombre FROM Ciclo c WHERE Nombre='Desarrollo de aplicaciones Web'

  • La siguiente consulta HQL es errónea ya que el nombre de la clase Java Ciclo está escrita con la “c” en minúsculas.

    SELECT c.nombre FROM ciclo c WHERE nombre='Desarrollo de aplicaciones Web'

• Al realizar comparaciones con los valores de las propiedades, éstas NO son sensibles a las mayúsculas o minúsculas.
  • Las siguientes 2 consultas retornan los mismos objetos

    SELECT c.nombre FROM Ciclo c WHERE nombre='Desarrollo de aplicaciones Web'

    SELECT c.nombre FROM Ciclo c WHERE nombre='DESARROLLO DE APLICACIONES WEB'

Al igual que en SQL en HQL también podemos filtrar los resultados mediante la cláusula WHERE. La forma de usarla es muy parecida a SQL.

SELECT p FROM Profesor p WHERE nombre='ISABEL' AND ape1<>'ORELLANA' 

Al igual que con el nombre de la clase, el nombre de los campos del WHERE siempre hace referencia a las propiedades Java y nunca a los nombres de las columnas.De esa forma seguimos independizando nuestro código Java de la estructura de la base de datos.

El carácter para indicar un literal de texto es la comilla simple no pudiéndose usar la doble comilla.

SELECT p FROM Profesor p WHERE nombre='juan' 

Si se quiere usar la comilla dentro de un literal deberemos duplicarla.

SELECT p FROM Profesor p WHERE ape1='perez l''andreu' 

Para incluir un número del tipo integer simplemente se escribe dicho número.

SELECT tb FROM TiposBasicos tb WHERE inte=4

Para incluir un número del tipo long se escribe dicho número y se añade una L mayúscula al final.

SELECT tb FROM TiposBasicos tb WHERE long1=4L

Para representar un double se escribe el número separarando la parte decimal con un punto o se puede usar la notación científica.

SELECT tb FROM TiposBasicos tb WHERE double1=1.45

SELECT tb FROM TiposBasicos tb WHERE double1=1.7976931348623157E308

Para representar un float se escribe el número separarando la parte decimal con un punto o se puede usar la notación científica pero se le añade el carácter F en mayúscula al final.

SELECT tb FROM TiposBasicos tb WHERE float1=1.45F

SELECT tb FROM TiposBasicos tb WHERE float1=3.4028235E38F

Para indicar una fecha la incluiremos entre comillas simples con el formato yyyy-mm-dd

SELECT tb FROM TiposBasicos tb WHERE dateDate='2012-07-25'

Para indicar una hora la incluiremos entre comillas simples con el formato hh:mm:ss

SELECT tb FROM TiposBasicos tb WHERE dateTime='02:05:10'

Para indicar una fecha y hora la incluiremos entre comillas simples con el formato yyyy-mm-dd hh:mm:ss.millis,siendo optativos el último punto y los milisegundos .

SELECT tb FROM TiposBasicos tb WHERE dateTime='2012-07-25 02:05:10'

Para comparar los datos en una expresión se pueden usar las siguientes Operadores:

• Signo igual “=”: La expresión será verdadera si los dos datos son iguales. En caso de comparar texto, la comparación no es sensible a mayúsculas o minúsculas.
• Signo mayor que “>”: La expresión será verdadera si el dato de la izquierda es mayor que el de la derecha.
• Signo mayor que “>=”: La expresión será verdadera si el dato de la izquierda es mayor o igual que el de la derecha.
• Signo mayor que “<”: La expresión será verdadera si el dato de la izquierda es menor que el de la derecha.
• Signo mayor que “⇐”: La expresión será verdadera si el dato de la izquierda es menor o igual que el de la derecha.
• Signo desigual “<>”: La expresión será verdadera si el dato de la izquierda es distinto al de la derecha.
• Signo desigual “!=”: La expresión será verdadera si el dato de la izquierda es distinto al de la derecha.
• Operador “between”: La expresión será verdadera si el dato de la izquierda está dentro del rango de la derecha.

  SELECT tb FROM TiposBasicos tb WHERE inte BETWEEN 1 AND 10

• Operador “in”: La expresión será verdadera si el dato de la izquierda está dentro de la lista de valores de la derecha.

  SELECT tb FROM TiposBasicos tb WHERE inte IN (1,3,5,7)

• Operador “like”: La expresión será verdadera si el dato de la izquierda coincide con el patrón de la derecha.Se utilizan los mismos signos que en SQL “%” y “_”.

  SELECT tb FROM TiposBasicos tb WHERE stri LIKE 'H_la%'

• Operador “not”: Niega el resultado de una expresión.
• expresión “is null”: Comprueba si el dato de la izquierda es null.

  SELECT tb FROM TiposBasicos tb WHERE dataDate IS NULL

Se puede hacer uso de los típicos operadores lógicos como en SQL:

• AND
• OR
• NOT

  SELECT p FROM Profesor p WHERE nombre='ANTONIO' AND (ape1='LARA' OR ape2='RUBIO')

Se puede hacer uso de los típicos operadores aritméticos:

• suma +
• resta -
• multiplicación *
• division /

  SELECT tb FROM TiposBasicos tb WHERE (((inte+1)*4)-10)/2=1

Las funciones de agregación que soporta HQL son:

• AVG(): Calcula el valor medio de todos los datos.
• SUM(): Calcula la suma de todos los datos.
• MIN(): Calcula el valor mínimo de todos los datos.
• MAX(): Calcula el valor máximo de todos los datos.
• COUNT(): Cuanta el nº de datos.

  SELECT AVG(c.horas),SUM(c.horas),MIN(c.horas),MAX(c.horas),COUNT(*) FROM Ciclo c

Algunas de las funciones que soporta HQL sobre datos escalares son:

• UPPER(s): Transforma un texto a mayúsculas.
• LOWER(s): Transforma un texto a minúsculas.
• CONCAT(s1, s2): Concatena dos textos
• TRIM(s):Elimina los espacio iniciales y finales de un texto.
• SUBSTRING(s, offset, length): Retorna un substring de un texto.El offset empieza a contar desde 1 y no desde 0.
• LENGTH(s): Calcula la longitud de un texto.
• ABS(n): Calcula el valor absoluto de un número.
• SQRT(n): Calcula la raíz cuadrada del número
• Operador “||” : Permite concatenar texto.

  SELECT p.nombre || ' ' || p.ape1 || ' ' || p.ape2 FROM Profesor p WHERE Id=1001

Como en SQL también es posible ordenar los resultados usando ORDER BY. Su funcionamiento es como en SQL.

SELECT p FROM Profesor p ORDER BY nombre ASC,ape1 DESC

Las palabras ASC y DESC son opcionales al igual que en SQL.

Al igual que en SQL se pueden realizar agrupaciones mediante las palabras claves GROUP BY y HAVING

nombres de profesores que se repiten mas de una vez

SELECT nombre,count(nombre) FROM Profesor p GROUP BY nombre HAVING count(nombre)>1 ORDER BY count(nombre)

HQL también soporta subconsultas como en SQL.

que duran más horas que la media de duración de todos los ciclos

SELECT c.nombre,c.horas FROM Ciclo c WHERE c.horas >  (SELECT  AVG(c2.horas) FROM Ciclo c2)