O documento discute as linguagens HQL e Criteria para consultas no Hibernate, abordando: 1) HQL é baseada em SQL e suporta classes, enquanto Criteria é 100% Java; 2) Ambas permitem filtros, ordenação, junções e agregações; 3) Criteria é indicada quando as consultas são dinâmicas.

1.
Hibernate Query Language
&
Hibernate Criteria Queries
Walter Itamar Mourão
walter.mourao@gmail.com

2.
Hibernate Tools
● Plugin Eclipse, componente do JBoss Tools
● Editores, ferramentas para engenharia reversa e
prototipação de queries.

3.
HQL
● Hibernate Query Language: linguagem de consulta
baseada em SQL, porém com extensões para suportar
classes.
● Indicado quando a query é estática (relatórios, por
exemplo).
Ex.:
select g.id from Grupo g where g.descricao like 'A%'
from Usuario u join u.grupo
from Usuario u where u.grupo.descricao like 'A%'

4.
Palavras chave
● Derivadas do SQL
● Não diferenciadas por maiúsculas/minúsculas (mas
as classes e atributos são !)

5.
Palavras chave: from
A query mais simples do HQL:
from <classe> [apelido]
retorna todas as instâncias daquela classe.
Ex:
from br.ita.finep.icammh.domain.ResultadoColeta
from br.ita.finep.icammh.domain.ResultadoColeta rc

6.
Palavras chave: select
Seleciona objetos e propriedades a serem
retornados no result set:
select <objetos.propriedades> from …
Ex:
select rc.id, rc.nomeArquivo
from
br.ita.finep.icammh.domain.ResultadoColeta rc

7.
Palavras chave: where
Acrescentra condições para filtragem do result set:
select … from … where <condição>
Ex:
select rc.id, rc.nomeArquivo
from
br.ita.finep.icammh.domain.ResultadoColeta rc
where rc.id>20

8.
Outras Palavras chave
● order by: ordenação do result set
● group by: agrupamento do result set
Ex:
select tamanho from
br.ita.finep.icammh.domain.CampoParametro
group by tamanho

9.
Junções Implícitas
● Objetos visíveis podem ser referenciados
diretamente.
Ex:
select rc.coleta.nome, rc.coleta.tipoColeta.nome
from
br.ita.finep.icammh.domain.ResultadoColeta rc
where rc.id < 200

10.
Junções Explícitas
● Use a palavra chave join para explicitar a junção e
definir apelidos
Ex:
select col.nome, col.tipoColeta.nome
from
br.ita.finep.icammh.domain.ResultadoColeta rc
join rc.coleta col
where rc.id < 200

11.
Funções de agregação
● avg(...), sum(...), min(...), max(...)
● count(*)
● count(...), count(distinct ...), count(all...)
Ex:
select avg(rc.id) from
br.ita.finep.icammh.domain.ResultadoColeta rc

12.
Expressões suportadas em
condições
● Operadores matemáticos: +, ­, *, /
● Comparadores lógicos: =, >=, <=, <>, !=, like, in,
not in, between, is null, is not null, is empty, is
not empty, member of and not member of
● Operações lógicas: and, or, not
● Parenteses indicando agrupamento: ( )
● Case: case ... when ... then ... else ... end

13.
Expressões suportadas em
condições
● Concatenação de strings: ||, concat(...,...)
● Expressões temporais: current_date(),
current_time(), and current_timestamp(),
second(...), minute(...), hour(...), day(...),
month(...), year(...)
● Expressões EJB­QL 3.0: substring(), trim(),
lower(), upper(), length(), locate(), abs(), sqrt(),
bit_length(), mod(), coalesce(), nullif()
● Conversões para string: str()

14.
Expressões suportadas em
condições
● Conversão de tipo: cast(... as ...), extract(... from ...)
● Parâmetros posicionais e nomeados: ?, :nomePar
● Operações em coleções: [any, some, all, exists]
elements(), indices(), size(), minelement(),
maxelement(), minindex(), maxindex(),
● Qualquer função suportada pelo SQL do BD
destino: sign(), trunc(), rtrim(), sin()

15.
Subqueries
● Subqueries são suportadas em bancos de dados que
suportam subqueries.
Ex:
from br.ita.finep.icammh.domain.Coleta col
where col.id in
(select af.id from
br.ita.finep.bdhr.domain.AgenciaFinanceira af)

16.
Interface Query
● Regras de retorno no result set:
● Se não existe cláusula select
● Se a cláusula from referencia uma única classe, cada
linha do result set é uma instância dessa classe.
● Se a cláusula from referencia mais de uma classe, o
result set é composto por Object[] onde cada entrada
é uma instância de cada classe referenciada.
● Se existe a cláusula select
● Com um único elemento, cada linha do result set é
uma instância desse elemento.
● Com vários elementos, cada linha do result set é um
Object[] onde cada entrada é uma instância de cada
elemento.

17.
Retornando Instâncias de
VOs
● É possível criar instâncias de value objects
diretamente no HQL:
select new <ClasseVO>(...) from …
Ex:
select new
br.ita.finep.icammh.sad.common.PerfilVO(p.id,
p.nome)
from br.ita.finep.icammh.domain.Perfil p

18.
Outros retornos
● O result set pode ser um um list, usando­se
“select new list(...)”
● O result set pode ser um map, usando­se
“select new map(...)”

19.
Update & Delete
● Sintaxe semelhante ao SQL: ( update | delete)
[from] EntityName (where <condições>)
Ex:
delete br.ita.finep.icammh.domain.Coleta col
where col.id > 2000000
update br.ita.finep.icammh.domain.Coleta col set
col.nomeArquivo=:novoNomeArquivo where
col.id > 2000000

20.
Interface Query
● O HQL é executado a partir de uma instância de
org.hibernate.Query, obtida da instância do Session
Query query = session.createQuery("from Book");
List books = query.list();
…
Query query = session.createQuery("from Book");
Iterator itBooks = query.iterate();
...
Query query = session.createQuery("from Book where isbn=:isbn");
query.setString("isbn", "1932394419");
Book book = (Book) query.uniqueResult();

21.
Parâmetros
● Parâmetros podem ser passados com a notação '?' ou ':'
...
Query query = session.createQuery("from Book where isbn = ?");
query.setString(0, "1932394419");
Book book = (Book) query.uniqueResult();
**** atenção: o primeiro parâmetro é o 0, diferentemente do SQL***
…
Query query = session.createQuery("from Book where isbn = :isbn");
query.setString("isbn", "1932394419");
Book book = (Book) query.uniqueResult();
● Usando o método query.setProperties, um JavaBean pode ser passado
como parâmetro. Os getters serão usados para atribuir valores aos
parâmetros da query.

22.
Performance HQL
● Métodos que influenciam na performance:
...
query.setFirstResult(20);
...
query.setMaxResults(10);
...
query.setFetchSize(100);
● O método uniqueResult retorna o objeto único que a query
retorna, null se o result set é vazio, ou dispara a exceção
NonUniqueResultException caso o result set retorne
mais de uma instância.

23.
Queries nomeadas
● Pode­se colocar as queries dentro dos arquivos de
mapeamento (*.hbm.xml), atribuindo nomes.
Ex:
<hibernate­mapping>
<query name="Book.by.isbn">
<![CDATA[from Book where isbn = ?]]>
</query>
</hibernate­mapping>
…
Query query = session.getNamedQuery("Book.by.isbn");
query.setString(0, "1932394419");
Book book = (Book) query.uniqueResult();

24.
HQL & Andromda
● Para escrever queries HQL diretamente no modelo,
crie um método na <<Entity>> marque­o como
“Query” e escreva a query no valor etiquetado
@andromda.hibernate.query
● Os parâmetros do método devem ter o mesmo nome
dos parâmetros dentro da query.
● Pode­se retornar um Collection ou uma classe
específica, nesse caso o método uniqueResult() da
interface org.hibernate.Query é usado.

25.
Hibernate Criteria Queries
● Mecanismo de consultas 100% Java.
● Indicado para situações onde a query deve ser
criada dinamicamente.
● A sessão corrente retorna instâncias da Criteria
através do método createCriteria.
Ex:
Criteria criteria = session.createCriteria(Book.class)
List books = criteria.list();
Equivale a:
Query query=session.createQuery(“from Book”);
List books = query.list();

26.
Restrições
● Restrições são acrescentadas através de factories da
classe org.hibernate.criterion.Restrictions
Ex:
Criteria criteria=
session.createCriteria(br.ita.finep.icammh.domain.Perfil.class);
criteria.add(Restrictions.ilike("nome","P%"));
criteria.list();

27.
Expressões Lógicas
● Podem ser expressas com Restrictions.and,
Restrictions.or ou Restrictions.conjunction e
Restrictions.disjunction.
Ex:
Criteria criteria=
session.createCriteria(
br.ita.finep.icammh.domain.Perfil.class);
Disjunction dj=Restrictions.disjunction();
dj.add(Restrictions.le("id",10L));
dj.add(Restrictions.ge("id",50L));
criteria.add(dj);
criteria.list();

28.
Ordenação
● Use o método addOrder e a classe
org.hibernate.criterion.Order para ordenar o
resultado
Ex:
Criteria criteria=session.createCriteria(
br.ita.finep.icammh.domain.Perfil.class);
criteria.add(Restrictions.ilike("nome","P%"));
criteria.addOrder(Order.desc("id"));
criteria.list();

29.
Associações
● O método createCriteria permite a inclusão de
associações na consulta
Ex:
Criteria criteria=session.createCriteria(
br.ita.finep.icammh.domain.PerfilCampos.class);
criteria.add(Restrictions.lt("id",10L));
Criteria critPerfil=criteria.createCriteria("perfil");
critPerfil.add(Restrictions.ilike("nome","P%"));
criteria.list();

30.
Associações usando
apelidos
● Pode­se criar apelidos para as associações com o
método createAlias
Ex:
Criteria criteria=session.createCriteria(
br.ita.finep.icammh.domain.PerfilCampos.class);
criteria.add(Restrictions.lt("id",10L));
criteria.createAlias("perfil","p");
criteria.add(Restrictions.ilike("p.nome","P%"));
criteria.list();

31.
Agrupamentos
● Projeções e agrupamentos são criados com o
método setProjection e com a classe
org.hibernate.criterion.Projections
Ex:
Criteria criteria=session.createCriteria(
br.ita.finep.icammh.domain.PerfilCampos.class);
criteria.add(Restrictions.lt("id",10L));
criteria.setProjection(Projections.rowCount());
criteria.list();

32.
Criteria desacoplada da
sessão
● A classe org.hibernate.criterion.DetachedCriteria
permite a criação de consultas desacopladas da
sessão
Ex:
DetachedCriteria dc=DetachedCriteria.forClass(
br.ita.finep.icammh.domain.PerfilCampos.class);
dc.add(Restrictions.lt("id",10L));
dc.getExecutableCriteria(session).list();

33.
Performance
● Métodos que influenciam na performance:
...
criteria.setFirstResult(20);
...
criteria.setMaxResults(10);
...
criteria.setFetchSize(100);
● O método uniqueResult retorna o objeto único que a
consulta retorna, null se o result set é vazio, ou dispara a
exceção NonUniqueResultException caso o result set
retorne mais de uma instância.

34.
Criteria & Andromda
● Use o estereótipo <<Criteria>> para criar classes
que representem consultas na persistência

35.
Criteria & Andromda
● O cartucho Hibernate gera uma classe Search para
facilitar a criação de consultas no código Java, e
os DAOs gerados contém métodos para a
execução dessas consultas.
Ex:

36.
SQL
● Use o método Session.createSQLQuery para
executar queries SQL.
Ex:
SQLQuery qry=
session.createSQLQuery(“select * from PERFIL”);
List lst=qry.list();

37.
Dicas
● A classe SessionFactoryUtils tem métodos
utilitários em geral, inclusive para retornar a
sessão Hibernate atual

38.
Hibernate & Jasper Reports
● O Jasper Reports suporta HQL de forma nativa
● O Jasper Reports pode receber um Collection de
beans como base de dados para o relatório,
portanto pode­se um passar o resultado da
execução de uma Criteria (ou de uma
<<Criteria>>)

39.
Referências
● http://docs.jboss.org/hibernate/stable/core/api/
● http://www.hibernate.org/hib_docs/v3/reference/en­
US/html/