Com a evolução do Hibernate, surge também a necessidade de trabalhar-se com banco de dados orientado a objetos. Mas infelizmente isso não é uma realidade atual, isso porque o custo para migrar todos os bancos de dados relacionais para orientado a objetos é grande, e como não irá mudar “nada” para o usuário final, então o mesmo prefere não trocar.

Enfim, a solução para trabalhar com o nível de abstração orientado a objetos, mesmo estando em um banco de dados relacional, é o HQL (Hibernate Query Language).

O HQL oferece ao desenvolvedor todo recurso necessário para trabalhar com um nível de abstração tão alto que fica quase transparente a manipulação com um banco de dados relacional, isso porque o HQL é um “SQL com capa”, ou seja, ao realizar a busca através de um Bean do Java, automaticamente o HQL é transformado em um SQL equivalente, de forma transparente ao desenvolvedor.

Usando HQLAntes de começar, é importante que você tenha em mente que é necessário ter todo mapeamento do hibernate.cfg.xml pronto, pois o HQL faz consulta a ele para transformar sua Classe em Tabela.

Ao usar HQL esqueça o nome das suas colunas, tabelas e tipos no banco. Lembre-se apenas como está a sua Classe, pois é ela que nos importa. Vamos então supor a classe Pessoa abaixo.

Listagem 1: Classe Pessoa

public class Pessoa {

//---------------------

//Atributos de instância

//---------------------

private Integer id;

private String nome;

private EnderecoPessoa enderecoAtual;

private String email;

//-------------

//Construtores

//-------------

public Pessoa() {

}

public Pessoa(Integer id) {

this.id = (Integer) id;

}

public Pessoa(Integer id, String nome) {

this.id = (Integer) id;

this.nome = nome;

}

public Integer getId() {

return id;

}

public void setId(Integer id) {

this.id = id;

}

public String getNome() {

return nome;

}

public void setNome(String nome) {

this.nome = nome;

}

public EnderecoPessoa getEnderecoAtual() {

return enderecoAtual;

}

public void setEnderecoAtual(EnderecoPessoa enderecoAtual) {

this.enderecoAtual = enderecoAtual;

}

public Telefone getTelefoneAtual() {

return telefoneAtual;

}

public void setTelefoneAtual(Telefone telefoneAtual) {

this.telefoneAtual = telefoneAtual;

}

public String getEmail() {

return email;

}

public void setEmail(String email) {

this.email = email;

}

} // Fim Pessoa

Agora vamos criar nosso Bean EnderecoPessoa.

Listagem 2: Classe EnderecoPessoa

import br.com.socic.util.Formatador;

public class EnderecoPessoa{

//-----------------------

//Atributos de instância

//-----------------------

private Integer id;

private String complemento;

private String entreRua1;

private String entreRua2;

private String numero;

private String pontoReferencia;

public Integer getId() {

return id;

}

public void setId(Integer id) {

this.id = id;

}

public String getComplemento() {

return complemento;

}

public void setComplemento(String complemento) {

this.complemento = complemento;

}

public String getEntreRua1() {

return entreRua1;

}

public void setEntreRua1(String entreRua1) {

this.entreRua1 = entreRua1;

}

public String getEntreRua2() {

return entreRua2;

}

public void setEntreRua2(String entreRua2) {

this.entreRua2 = entreRua2;

}

public String getNumero() {

return numero;

}

public void setNumero(String numero) {

this.numero = numero;

}

public String getPontoReferencia() {

return pontoReferencia;

}

public void setPontoReferencia(String pontoReferencia) {

this.pontoReferencia = pontoReferencia;

}

} // fim Endereco

Não vamos nos atentar ao mapeamento de ambas as classes, pois isso demandaria muito tempo e espaço do artigo, vamos focar em trabalhar com HQL usando essas duas classes.

Listagem 3: HQL Simples da Classe Pessoa

SELECT pessoa FROM Pessoa pessoa

Vamos ao nosso primeiro HQL, na listagem 3 você percebe que referenciamos apenas a classe Pessoa, fizemos um cast para “pessoa” e estamos retornando todas as pessoas do banco. Porém, ao realizar isso estamos retornando apenas os atributos comuns, sem objetos, ou seja, não conseguiremos dessa forma capturar o número do endereço da pessoa.

O SELECT acima retorna o objeto pessoa como “lazy”, ou seja, sem carregar seus “sub-objetos”, que é o caso do objeto enderecoPessoa. Para carregar os objetos precisamos explicitamente utilizar a palavra reservada “JOIN FETCH”, como na listagem 4.

Listagem 4: Carregando Pessoa com EnderecoPessoa

SELECT pessoa FROM Pessoa pessoa

JOIN FETCH pessoa.enderecoPessoa

O HQL tem uma sintaxe muito parecida com SQL, por isso seu aprendizado é rápido e simples para quem já é familiarizado com SQL. Ainda se tratando da listagem 4, pode ocorrer que nem toda pessoa tem um endereço, neste caso devemos usar a palavra “LEFT” antes do JOIN, assim estamos dizendo algo como: “Carregue todas as pessoas com os seus endereços, mesmo que elas não tenham endereço.” Se você retira o “LEFT” a nossa analogia ficaria mais ou menos assim: “Carregue todas as pessoas com os seus endereços, sendo que todas devem obrigatoriamente ter endereço, caso contrário ignore-a”.

Podemos ir mais a fundo, buscar um atributo de enderecoPessoa usando o objeto pessoa e ainda realizar um WHERE.

Listagem 5: Buscando atributo de EnderecoPessoa

SELECT pessoa FROM Pessoa pessoa

JOIN FETCH pessoa.enderecoPessoa endereco

WHERE endereco.numero = :numeroDoEndereco

O que fizemos acima foi realizar um cast de “pessoa.enderecoPessoa” para “endereco”, assim não precisamos ficar usando toda hora o nome completo (pessoa.enderecoPessoa), usamos apenas a palavra “endereco”. Depois estamos fazendo um filtro, para buscar apenas as pessoas que moram em determinado número. O código “:numeroDoEndereco” é exatamente um parâmetro que você irá passar ao HQL para procurar pelo número que desejar.

CONCLUSÃOEste artigo apresentou conceitos básicos para quem desejar iniciar a desenvolver com HQL, a partir daqui é recomendável uma leitura mais aprofundada sobre o assunto, caso tenha interesse. O HQL é uma poderosa linguagem que possui inúmeros recursos e métodos que são utilizados no próprio Java.