Mapeamento Objeto-Relacional em Java usando Oracle Toplink: Parte 3

A JPQL também é uma especificação da JPA. É uma linguagem, semelhante à SQL. Diferente da SQL que trabalha com tabelas, a JPQL trabalha com entidades (classes).

Selecionando todos os objetos de uma entidade
As queries são criadas e executadas com o auxílio da classe EntityManager, usando o método createQuery. Existem outros dois métodos semelhantes: createNativeQuery e createNamedQuery. O primeiro é para usar queries escritas em SQL puro (nativas), o segundo veremos mais adiante.

Crie uma classe chamada SelectAll, o código dela fica assim: http://pastebin.com/f3aa9d3bc. Esteja atento a duas coisas:

• Não tem SELECT *;
• Você deve importar a interface Query do pacote javax.persistence.

O código mostrado é muito simples. Vamos agora começar a filtrar resultados e ver como os joins não são tão complicados aqui :)

Filtrando resultados
Vamos fazer apenas uma filtragem simples. Note que a JPQL é muito semelhante à SQL. Vamos selecionar todos os status que começam com a letra V. Você pode pensar: “em SQL eu uso o like, o que será que eu uso na JPQL?”. O like também! Veja o código:

Nada demais, quase igual à SQL. O nome dos atributos deve ser equivalente ao nome dado nas classes. Esqueça as tabelas no banco de dados, você não vai usar nada de lá :) Não explicitamente.

JOIN’s
Uma das coisas mais legais em trabalhar com banco de dados relacionais é fazer JOIN. O problema é que os joins costumam gerar consultar enormes. Vamos fazer a seguinte consulta: Eu quero obter todos os clientes que compraram um produto cujo nome (do produto, caso haja ambiguidade aqui) começa com a letra A. :) Como a JPQL é muito semelhante à SQL, vamos fazer assim ué:

Taí, um SELECT pra ninguém botar defeito. Na verdade, eu boto defeito. A JPQL não seria tão útil se não pudesse melhorar a forma de fazer consultas no banco de dados. É nesse momento que as pessoas têm mais problemas com SQL :) Vamos reescrever a query?

Melhorou? Pois é, o Toplink processa essa query e gera algo semelhante à query anterior. Mas para o programador é mais fácil não usar tantos joins. Nós declaramos estar selecionando dados somente de uma entidade, mas por baixo dos panos é feita uma consulta que acessa quatro tabelas. Isso sim é VHPL :)

Bind variable
Já aprendemos a usar as queries. Mas uma coisa muito importante que encontramos no JDBC e ainda não vimos na JPA é a possibilidade de fornecer parâmetros às queries.

Diferente de como acontece no JDBC, na JPA os parâmetros possuem nome e não número. Em JDBC declaramos os parâmetros usando pontos de exclamação (“?”) e configuramos estes parâmetros usando seu número. Na JPA, os parâmetros têm nome:

O nome do parâmetro é “nome”. Todo parâmetro é identificado pelos dois pontos (“:”) seguidos do nome do parâmetro. Vamos agora ver um código onde setamos o parâmetro:

Obs: Se você quiser, pode configurar todos os parâmetros usando números também.

Dando nome às queries
Bom, já vimos como criar queries, já vimos como filtrar resultados, como fazer join’s e como adicionar parâmetros a uma query. Um recurso interessante é deixar a query pronta, e depois chamar ela pelo nome. :)

Você cria uma NamedQuery na entidade e depois acessa ela pelo nome. Legal né?! Vamos ver como fazer isso. Abra a classe Status e adicione abaixo da linha @Entity as seguintes linhas:

Entendeu o que fizemos? Criamos uma query chamada SelecionarTodosStatus e outra criada SelecionarStatusPeloNome. Agora vamos usá-la. Crie a classe SelectNamedQuery, com o seguinte código: http://pastebin.com/f65f464b8.

Ao invés de usarmos o createQuery, usamos o createNamedQuery. Passamos o nome da Query, o Toplink encontra ela, processamos os parâmetros (se existirem) e pronto, temos o resultado! :)

Na próxima, e última, parte vou apresentar uma ideia nova para criação de classes Dao, usando o recurso de tipagem genérica do Java. Não é algo ligado ao Toplink ou à JPA. Vou mostrar o modelo de criação das classes Dao, e exemplificar como eu faria usando Toplink (mostrando como é fácil) e JDBC (vai dar mais trabalho).