Hibernate: Consultas

Francisco do Nascimento

PSC - Programação de Softwares Corporativos

UNIBRATEC, outubro de 2008

2

Consultas Umas das partes mais interessantes do acesso a

dados Consultas complexas podem levar um bom tempo

para serem escritas e podem ter considerável impacto na performance da aplicação

Consultas são escritas utilizando conceitos de orientação a objetos

Objetos no lugar de tabelas Propriedades no lugar de colunas

Experiência em SQL não é desprezada

3

Consultas

Podem ser feitas de três maneiras Hibernate Query Language (HQL) Criteria API e Query by Example Utilizando SQL

4

Consultas: Exemplos

// Através de HQLsession.createQuery("from Category c where c.name like 'Laptop%'");

// Utilizando-se Criteriasession.createCriteria(Category.class).add(

Restrictions.like("name", "Laptop%"));

// Através de SQLsession.createSQLQuery(

"select * from cad.CATEGORY where name_category like 'Laptop%'");

5

Consultas

Envolve alguns passos Criar a consulta com as restrições necessárias Adicionar parâmetros à consulta Executar a consulta e recuperar o resultado

A forma de execução da consulta e obtenção dos dados pode ser configurada

6

Criando a Consulta

Query query = session.createQuery("from User");

Criteria criteria = session.createCriteria(User.class);

Objetos Query e Criteria são obtidos através do Session

org.hibernate.Query org.hibernate.Criteria

7

Adicionando Parâmetros à Consulta Parâmetros não devem ser adicionados na

própria String da consulta "from Item i where i.description like '" + search +

"'" Parâmetros podem ser adicionados através

de sua posição ou de seu nome

8

Adicionando Parâmetros pelo Nome

String queryString = "from Item item where item.description like :search";

Query q = session.createQuery(queryString).setString("search",searchString);

String queryString = "from Item item"+ " where item.description like :search"+ " and item.date > :minDate";

Query q = session.createQuery(queryString).setString("search",searchString).setDate("minDate", mDate);

Nome do parâmetro é precedido de “:” O valores são adicionados através de

métodos sets

9

Adicionando Parâmetros pela Posição

String queryString = "from Item item"+ " where item.description like ?" + " and item.date > ?";

Query q = session.createQuery(queryString).setString(0, searchString).setDate(1, minDate);

A consulta contém “?” para indicar a existência de alguma parâmetro

Os valores também são adicionado através de métodos sets

10

Executando a Consulta Se mais de um objeto pode ser retornado,

chama-se o método list() List list = query.list();

Se somente um objeto pode ser retornado, chama-se o método uniqueResult()

User user = (User) query.uniqueResult(); O método retorna null se nenhum objeto for

encontrado Se a consulta retornar mais de um objetos, a

exceção NonUniqueResultException é lançada

11

Executando a Consulta

Query query = session.createQuery("from User");List<User> list = query.list();

for (User user : list) {System.out.println(user.getName());

}

Query query2 = session.createQuery("from User user where user.name =:name").setString("name","SUNSP");

User user = (User) query2.uniqueResult();

System.out.println(user.getName());

12

Consultas Básicas A consulta mais simples tem somente a

cláusula FROM “from Item”

Para se referenciar as propriedades de uma entidade, um ALIAS deve ser criado

“from Item as item” “from Item item”

Palavra chave “as” é opcional

A consulta não é case-sensitive “FROM Item AS item” também pode ser utilizada

13

Consultas Polimórficas Consultas podem ser escritas utilizando

polimorfismo “from Pessoa”

Retorna todas as entidades que herdam de Pessoa

Aluno Professor

14

Restrições

Geralmente não se quer trazer todo o conteúdo da tabela

Restrições devem ser adicionadas para restringir os objetos retornados

HQL também utiliza-se a cláusula WHERE As restrições são feitas sobre propriedades

da entidade

15

Restrições Literais e condições podem ser incluídos

Utiliza-se aspas simples para literais do tipo String “from Usuario u where u.email = 'foo@hibernate.org'” “from Item i where i.ativo = true”

Comparações podem ser realizadas “from Produto p where p.quantidade between 1 and 10” “from Produto p where p.quantidade > 100” “from Usuario u where u.email in ('foo@bar', 'bar@foo')”

16

Operador LIKE pode ser utilizado “%” representa qualquer seqüência de caracteres _ (Under_Score) representa qualquer caractere “from Usuario u where u.nome like 'G%'” Negação pode ser utilizada

“from Usuario u where u.nome not like '%Foo B%'”

Operadores lógicos e parênteses “from Usuario user where user.nome like 'G%'

and user.sobrenome like 'K%'”

Comparações

17

Comparações

Operadores lógicos e parênteses “from Usuario u where (u.nome like 'G%' and

u.sobrenome like 'K%' ) or u.email in ('foo@hibernate.org', 'bar@hibernate.org' )”

Coleções "from Venda d where d.itens is not empty"

18

Comparações Funções podem ser chamadas a partir do HQL

HQL permite a chamada de funções SQL na cláusula WHERE

Funções podem ser definidas pelo usuário Depende do suporte do banco de dados

Funções UPPER() e LOWER() "from Usuario u where lower(u.email) =

'foo@hibernate.org'" Função SIZE()

from Venda v where size(v.itens) > 3 E muitas outras...

19

Comparações Outras funções

CONCAT(s1, s2) SUBSTRING(s, offset, length)

Offset começa a partir de 1 TRIM( [[BOTH|LEADING|TRAILING] s)

"from Item i where TRIM(BOTH i.name) = 'Computador'" LENGTH(s) LOCATE(search, s, offset)

Procura a localização de uma substring dentro de uma string

20

Comparações

Outras funções CURRENT_DATE(), CURRENT_TIME(),

CURRENT_TIMESTAMP() Valores retornados são referentes ao SGBD

SECOND(d), MINUTE(d), HOUR(d), DAY(d), MONTH(d), YEAR(d)

Extraem os valores de um argumento temporal

21

Ordenando o Resultado A Cláusula ORDER BY é utilizada para ordenar o

resultado "from Usuario u order by u.nome"

Ordem ascendente ou descendente Utiliza-se asc ou desc from Usuario u order by u.login desc

Ordenando por mais de uma propriedade “from Usuario u order by u.sobrenome asc, u.nome asc”

22

Junções

A habilidade de realizar junções é uma das principais forças do modelo relacional

Permite selecionar diferentes objetos associados e coleções em uma única consulta

23

Inner Join

Contém somente os registros que estão relacionados com o outro lado da junção

Contém somente os Itens que possuem Bids

24

(left) Outer Join

Retorna todos os Itens Dados de Bid são preenchidos com NULL se não

houver uma correspondência

25

Junção com HQL Coluna de junção não precisar ser informada na

consulta Informação é extraída do mapeamento

É necessário ser informado somente o nome da associação

Nome do atributo que referencia a classe ou coleção de classes

Joins podem ser executados de duas maneiras Join implícitos na Associação Join especificado na cláusula FROM

26

Join Implícito na Associação

O Join é realizado através da associação entre duas entidades

Exemplo: “from Bid bid where bid.item.description like '%Foo%'” Bid é associado a Item através do atributo “item” Hibernate sabe que a associação está mapeada a partir

da chave estrangeira ITEM_ID da tabela BID Joins implícitos são sempre realizados através de

associações many-to-one ou one-to-one

27

Join Implícito na Associação

Múltiplos joins são possíveis from Bid bid where bid.item.category.name like

'Laptop%'

28

Join especificado na Cláusula FROM Joins podem ser especificados explicitamente na

cláusula FROM Exemplo

"select i from Item i join i.bids b where b.amount > 10" Aliases devem ser especificados na cláusula FROM

e utilizados na cláusula WHERE Cláusula SELECT é utilizada para que somente

Itens sejam retornados

29

Join especificado na Cláusula FROM Na consulta, um Item pode ser retornado

mais de uma vez Uma para cada Bid associado Somente uma instância é utilizada

A consulta possui o mesmo formato para associações many-to-one e one-to-one

30

Outer Joins

Para a utilização de Outer Joins utiliza-se a cláusula LEFT JOIN

LEFT OUTER JOIN e RIGHT OUTER JOIN também podem ser utilizados

A cláusula WITH é utilizada para adicionar restrições "select i from Item i left join i.bids b with b.amount >=

9" Itens que não possuem Bids também são retornados

31

Comparando Identificadores

Entidades também podem ser adicionadas como parâmetros de uma consulta

Query query = session.createQuery("from Item i where i.seller = :seller");

query.setEntity("seller", user);

HQL

Consultas não precisam aparecer no código Na verdade, muitas vezes é melhor que não apareçam Podem ficar nos metadados e serem chamadas pelo nome

Usa-se o método getNamedQuery()

Mas antes, ela precisa ser declarada em algum arquivo de mapeamento ou anotada em alguma entidade

List clientes = session.getNamedQuery(“findClienteByName”)

.setString(“nome”, nome),list()

<query name=“findClienteByName”><![CDATA[from Cliente c where c.nome like :nome]]

</query>

NamedQueries com Annotationpackage auction.model;import ...;@NamedQueries({@NamedQuery(name = "findItemsByDescription",query = "select i from Item i where i.description like :desc"),...})@Entity@Table(name = "ITEM")public class Item { ... }

Paginando o resultado

Query query =

session.createQuery("from User u order by u.name asc");

query.setFirstResult(5);

query.setMaxResults(10);

Instanciação dinâmica

select new Aluno(

a.id, a.nome, a.idade, a.curso

)

from Aluno a

where a.curso is not null

group by a.nome