Hibernate: Consultas

1. 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 HQL session.createQuery("from Category c where c.name like 'Laptop%'"); // Utilizando-se Criteria session.createCriteria(Category.class).add( Restrictions.like("name", "Laptop%")); // Através de SQL session.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 • Objetos Query e Criteria são obtidos através do Session • org.hibernate.Query • org.hibernate.Criteria Query query = session.createQuery("from User"); Criteria criteria = session.createCriteria(User.class);

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 • Nome do parâmetro é precedido de “:” • O valores são adicionados através de métodos sets 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);

9. Adicionando Parâmetros pela Posição • 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 String queryString = "from Item item" + " where item.description like ?" + " and item.date > ?"; Query q = session.createQuery(queryString).setString(0, searchString).setDate(1, minDate);

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. Comparações • 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%'”

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);

32. 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>

33. NamedQueries com Annotation package 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 { ... }

34. Paginando o resultado Query query = session.createQuery("from User u order by u.name asc"); query.setFirstResult(5); query.setMaxResults(10);

35. 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