24 de set. de 2007

Criar uma aplicação com hibernate

Dae gurizada!!!

Esse é um post simples para quem quer confirguar uma aplicação para usar Hibernate com Annotations.

Eu usei o
Netbeans 5.5 para montar esse exemplo. Será necessário fazer o download do Hibernate Annotations, que por sua vez precisa do Hibernate Core. Para os teste utilizei o Postgresql 8.2. Segue os links: Abaixo está o link da aplicação exemplo: E só clicar nos links que irá direto para o local onde pode ser veito o download.


1º Passo: Criar o projeto

Esse artigo ainda foi feito no NetBeans 5.5. Para criar um novo projeto vá em Arquivo -> Novo Projeto. Selecione a categoria "Geral" e clique em Aplicação Java. Chamei o projeto de HibernateApp.

Crie uma pasta chamada de "lib" na raiz do seu projeto. A estrutura de diretórios vai ficar assim:


Criado o nosso projeto já criei alguns pacotes e classes. Veja:




Agora temos qu adicionar os jar necessários para a aplicação rodar. Se você notar, o hibernate tem um monte de JARs, mas nem todos são obrigatórios.

Abaixo estão quais os JARs devem estar na pasta LIB do nosso projeto. Vou separar os jars do Hibernate Core e do Hibernate Annotations, mas todos devem ser colocados na pasta LIB direto, não em subpastas.

Hibernate Core - 3.2.5GA:
  • antlr.jar
  • cglib.jar
  • asm.jar
  • asm-attrs.jars
  • commons-collections.jar
  • commons-logging.jar
  • hibernate3.jar
  • jta.jar
  • dom4j.jar
  • log4j.jar

Hibernate Annotations 3.3.0GA
  • ejb3-persistence
  • hibernate-commons-annotations
  • hibernate-annotations
Postgresql 8.2
  • postgresql-8.2-505.jdbc4

A minha pasta lib ficou assim:



Com os JARs na pasta lib ainda temos que adicionar ao projeto pelo Netbeans.
Para isso clique com o botão direito no nome do projeto e clieque em propriedades:


Depois clique em "Bibliotecas" e no botão "Adicionar Jar/Pasta" e localize os jars na pasta lib do nosso projeto:



2º Passo: Criar as classes - Entidades Persistentes.
É considerado "Entidade persistente" as classes que serão inseridas no banco de dados.

No nosso exemplo tenho duas classes que serão persistidas no banco de dados. A classe Pessoa e Endereco.

Veja com elas ficaram:

Explicação

@
Entity: Toda classe persistente (POJO) deve user @Entity. Isso indica que a classe é uma entidade persistente(Entity Bean). Ou seja, existe uma tabela no banco de dados que representa essa classe. Por padrão o hibernate considera o nome da tabela igual ao nome da classe.

Caso sua classe possua um nome diferente ao nome da tabela, é necessário usar a anotaçao a seguir:


@
Table:
essa anotação é utiliza quando informamos o nome da tabela. Veja a classe Pessoa. O nome da classe é Pessoa, mas o nome da tabela no banco é TB_Pessoa.

@Id
:
Para o hibernate o ID é a forma de identificar o objeto (bem óbvio).
Os ID's podem ser gerados de várias formas dependendo do banco utilizado. O Postgresql, por exemplo, utiliza sequences. O MySQL tem um campo autoincrement e assim por diante.

Existem vários tipos de "generators". Veja esse link ou veja o meu outro post.


@
Column:
Essa anotação simplesmente indica qual coluna da tabela a propriedade irá referenciar. Por padrão todos os atributos da classe são pripriedades de tabelas.

@
ManyToOne:
esse atributo faz as relações entre as classes.

@
JoinColumn:
essa anotação indica qual coluna da classe Pessoa referencia a classe Endereço.

Agora um desenho para melhorar a compreensão:



3º Passo: Classe/Arquivo de configuração:

Você deve estar se perguntando:

- Por que esse retardado colocou "'classe/arquivo de configuração" ?

Simples! Existem as duas formas de configurar o hibernate. Na verdade são 3.. heheheh

hibernate.cfg.xml ou hibernate.properties: Até chegar o annotations e jpa o hibernate era configurado através de um arquivo xml ou .properties. Neste arquivo estão as informaões de conexão com o banco e as classes que serão mapeadas. Utiliza-se esse arquivo quando vamos utilizar somente o Hibernate Core.
persistence.xml: A especificação EJB3 definiu o arquivo padrão para configuração do mapemaneto objeto relacional. Este arquivo é semelhanto ao hibernate.cfg.xml ( e tambem foi baseado nele). Utiliza-se esse arquivo quando vamos utilizar o EntityManager.
Configuração programática (classe): Uma alternativa ao antigo hibernate.cfg.xml. Todas as configurações informadas no arquivo de configuração do hibernate, podem ser setadas em tempo de execução.

Nosso hibernate.cfg.xml

Vamos ver primeiro o arquivo de configuração.

Crie um arquivo "hibernate.cfg.xml" dentro da pasta src do seu projeto.

OBS inútil: esse arquivo do hibernate pode ter outro nome. É obrigatório o arquivo conter "cfg.xml".
Ex: "qualauernome.cfg.xml"
Mas o nome mais comum é "hibernate.cfg.xml".
Veja como fica o meu projeto no netbeans:


Criado o arquivo vamos ver a maldita configuração:
Explicação
connection.driver_class: Nome da classe do driver que será utilizado. No meu caso estou utilizando o postgresql.

connection.url: URL para conexão com o banco. connection.username: nome do usuário para conexão com o banco connection.password: senha para conexão com o banco
Até aqui são configuraçoes normais que você já deve ter usado para criar conexões com o banco via JDBC dirto.

connection.pool_size
: Configuração do pool de conexão. No nosso caso o hibernate manterá sempre 1 conexão com o banco.

dialect (Importantíssimo): O hibernate gera o sql dinamicamente de acordo com o banco de dados utilizado. A forma do Hibernate saber para qual banco gerar o SQL é o "dialect". Veja aqui a tabela de "dialetos" do hibernate.
cache.provider_class: O hibernate possui um podero sistema de Cahce de objetos. Eu particularmente nunca utilizei. Se alguem quiser se aprofundar veja em:
show_sql: Com o valor "true" exibe todos os comandos SQL executados pelo hibernate no console da IDE e no arquivo de LOG, caso configurado.
Ótimo para achar erros.

hbm2ddl.auto(maravilhoso): Essa cara aqui é muito bom. Esta ferramenta do hibernate gera o schema para o banco de dados, ou seja, ele cria o banco de dados com os seus relacionados, chaves primárias, etc.. a partir das classes configuradas no hibernate. Essa ferramente é executado quando criamos o SessionFactory que veremos a seguir.

Algums valores:
create-drop: Cria as tabelas do banco quando o SessionFactory é iniciado e deleta a base de dados quao termina a executação. Muito cuidado ao usar essa configração com o banco de dados de produção..hehehehe

update
: Atualizar colunas e tabelas do banco de dados. Essa configuração não deleta nenuma coluna, somente insere.
OBS: É necessário já estar criado o "database".


"mapping class"
:
Bom esse trecho não é bem uma configuração. Aqui estamos adicionando as classes que serão mapeadas no hibernate. Todas as classe que iremos mapear no hibernate tem que ser adicionadas na configuração.


Agora que foi entendido a configuração do hibernate vamos ver como fazer essa mesma configuração na classe:



Nessa classe criamos uma instância da classe AnnotationConfiguration que é a classe do hibernate que recebe configurações iguais ao do XML.

Veja que chamei o método "setProperty" para setar as propriedades.


4º Passo: Iniciar o Hibernate.

Eu criei uma classe chamda Hibernate
Config com os métodos iniciarHibernateClasse(mostrado acima) e iniciarHibernateXML, abaixo.
A lógica para istânciar um objeto SessionFactory é a mesma com o arquivo de configuação e para a classe.

Criar o objto AnnotationConfiguration

Setar as configurações.
Classe: setar as configurações a partir do método
setProperty

Arquivo cfg.xml: chamar o método configure() da classe AnnotationConfiguration. Este método irá carregar as configurações do arquivo e retornar um objeto do tipo Configuration.

Chamar o método
Classe: chamar o método "buildSessionFactory()" da classe AnnotationConfiguration.
Arquivo: chamar o método "buildSessionFactory()" do objeto retornado do método "configure()"


Se ficiu confuso esses passos veja a classe que vai ajudar.


Bom.. mais uma vez fica aqui meu pedido de críticas e sugestões...

No mais era isso...

Abração!




26 de ago. de 2007

O que é o hibernate ?





Hibernate. É bem simples entender pra que serve esse bicho: Mapeamento Objeto Relacional

Para os mais experientes falar que o Hibernate faz a "ponte" entre o conceito Relacional com o Orientado a Objetos é fácil. Mas tem bastante gente que não cosegue enxergar isso.


Agora veja da seguinte forma. Temos uma tabela, o exemplo clássico, "Pessoa"
Bom ai temos uma tablea com 3 colunas. Transformar isso em objeto é fácil.
Seria um objeto da seguinte forma: Difícil fazer o "Mapemaneto Objeto Relacional" ??

Agora imagine este relacionamento:
Por favor, ignore o fato de ter feito um ER em uma ferramento de UML... :D
Você consegue enxergar que uma pessoa tem um carro e um endereço?? E que este carro tem um modelo ?? Transformar issto em objeto ainda continua fácil.

Mas você já imaginou o código necessário para passar estes dados para objetos ?!

Veja:





















Muitos vão olhar o código e dizer "Isso não é difícil" ou "Isto eu faço!". Realmente não é nada de outro mundo.
Mas imagine um projeto grande, com mais de 800 entidades persistentes. Qualquer programador fiacaria louco !!!



Agora veja o mesmo código com Hibernate:













O quê?! É isso mesmo ??? Sim!!

Claro, tem uma pequena parte que não esta neste código. A configuração do hibernate. Mas as consultas são simples assim.

O que eu mostrei até aqui é uma parte do que o Hibernate faz, agora vou fazer um apêndice sobre JPA.


Java Persistence API - JPA

"Java Persistence API é a interface padrão para mapeamento objeto/relacional e gerenciamento de persistência da plataforma Java EE 5.0"

Bom, espero q agora o termo "mapeamento objeto relacional" seja claro para todo mundo.

JPA define um comportamento, um contrato, de como deve ser o mapeamento objeto relacional e o gerenciamento de persistência de objetos java. Veja bem:
define um contrato. A implementação pode ser feita por qualquer um.

Eu li no blog Beyond Click uma comparação perfeita. JPA está para persistência assim como JDBC está para conexão com banco de dados.

As mais famosas implementações JPA são Hibenate e TopLink, existem outras.


Voltando ao hibernate... algumas de suas funcionalidades:

Persistência transparente
Não é necessário executar os comandos SQL de Insert, Update e Delete. O hibernate executa os médoto "save(Object obj)" , "update(Object obj)" e "delete(Object obj)".
Ou seja, ele salva, atualiza ou deleta objetos.

Consulta Fácil
O hibernate possui uma lingugem própria de consulta, o HQL. Esta linguamgem é equivalente a um SQL orientado a objetos. Facilita muuuiiiiiiiiitttoooo as consultas de objetos.

Cache de objetos
O hibernate, se for configurado para isso, trabalha com Cache de objetos.
Se um usuário consultou os dados da pessoa ID 1 no banco. Essa consulta fica em memória. Caso outro usuário consulte os dados da pessoa ID 1 o hibernate retorna os valores do Cache, não realizando uma nova consulta na base.
O isso significa um ganho de desempenho para aplicações de grande porte.

Existem outras!!


Como ele faz isso??
Essa parte que é interessante. O hibernate faz um mapemaneto entre classes java e tabelas no banco de dados.

Veja:

Classe Pessoa















Arquivo de Configuração da classe Pessoa


Esse arquivo xml realiza o tal Mapeamento. É nesse arquivo que esta toda a informação do objeto que será persistido ( inserido no banco de dados).

Este arquivo esta nos dizendo que o objeto Pessoa será inserido na tabela Pessoa. Que o atributo nome, da classe pessoa, representa a coluna nome na tabela Pessoa, e assim por diante.

Esse arquivo XML existe para cada Entidade Persistente. Uma entidade persistente é um objeto que será inserido no banco de dados.


Estrutura do Hibernate
Abaixo está uma foto que tirei so site do hibernate de como é a sua estrutura.




Entity Manager
EntityManager também faz parte da JPA. Esse pacote contem implementações do gerencimaneto de persistência, ciclo de vida dos objetos, a Java Persistence Quary Language e as configurações.
É um JAR com classes que fazem isso escrito ai em cima....hehehe

Hibernate Core

Este o núcleo do hibernate. Imagine o Hibernate Core como o Java SE da paltaforma Java. São os recursos básicos do hibernate, utilzido pelas demais API's.

Hibernate Annotations
O hibernate, como qualquer outro framework para mapeamento objeto relacional, precisa de informarções (chamdados de "meta dados") para transformar tabelas relacionais de uma base de dados em
objetos.
Antes de lançar o Java 5.0, com o recurso de Annotations, esses "meta dados" eram informados em arquivos XML, com o Java 5.0, o XML foi substituído por "annotatinos". Que fazem o mesmo papel do XML, só que agora na prória Classe.
O Hibernate Annotations extende as Annotações padrão da JPA.


É bom saber que o hibernate com XML ainda é muito utilizado.



Espero que quem não conhecia o hibernate possa ter entendido o que o hibernate é.


No decorrer dos próximos argitos irei aprofundar alguns dos assutnos que escrevi aqui.


Abraço!

fui...

Hibernate - da teoria à prática

Dae gurizada!!

Bom, faz tempo que não paro para escrever algo de útil. Tenho um monte de "artigos rascunhos" no meu blog que nunca ternimo.

Hoje, domingo chuvoso, estava assintindo nada na tv e resolvi escrever uma série de artigos sobre o Hibernate, framework que sou apaixonado! E também sobre JPA.

Esse artigos irão abordar os seguintes tópicos:

  • O que é o hibernate ? Introdução ao objetivo do framework hibernate, conceito de mapeamento objeto-relacional e exemplos comparativos entre aplicações utilizando hibernate X JDBC "na mão".
  • Aplicação exemplo 1.Aplicação onde vamos criar relacionamentos simples (one-to-many) e criar algumas telas CRUD.
  • Aplicação exemplo 2. Aplicação onde serão realizadas consultas utilizando a API Criteria, Fetching Lazy ( consultas preguisosas) e relacionamentos many-to-many.
  • Aplicação exemplo 3. Aqui ja teremos um conceito básico e sólido sobre como utilizar o hibernate. Vamos trabalhar com consultas agregadas.

Acredito que para aprender deve-se sempre optar pela prática. Então resovli fazer artigos simples, mas com aplicações.

Espero que seja de ajuda para quem é iniciante.

No mais era isso..

Assim que o primeiro artigo estiver pronto, será liberado.

fui!


20 de abr. de 2007

Certificação "opensource", por que não?








Esses dias me organizando ( contando os $$ ) para certificação, me surgiu uma dúvida. Por que não pode existir uma Certificação "OpenSource"? Não sei se OpenSource é o termo mais adequado, mas acho que representa bem a idéia.

Por que não existe uma Certificação onde a Comunidade de desenvolvedores, analistas, etc.. resolvem o que ser avaliado ??
Já param pra imaginar quantas pessoas com talento, caráter e sem R$ ou sem interesse existem por ai ?

Ou melhor, se você que está lendo isso já fez alguma seleção para alguma vaga. Já pegou alguém certificado que não teinha o seu perfil ??

Isso não é uma crítica às certificações Java. Acho as certificações ótimas! Realmente quem passa não pode se dizer leigo no assunto. E se não for isso que queira avaliar num desenvolvedor ?

A certificação java foca em "atividades críticas no desenvolvimento e arquitetura de aplicações". Mas e o resto ?

Imaginem uma empresa que não se preocupa se ">>" vai deslocar bit para esquerda ou para direita, não utiliza EJB e o interesse é avaliar aqualidade do trabalho (boas práticas) , por exemplo.

Do ponto de vista desta empresa é interessante:
  • Avaliar quanto o indivíduo conhece Spring, Hibernate, Struts, JSF, Ajax, JUnit, Lazlo ou qualquer outro "treco" que eu utilize no projeto.
  • Avaliar se ele utiliza boas práticas no desenvolvimento.
  • Até avaliar se o cara utiliza de forma coerente Exceptions..

Isso existe ?


Imaginem só, quanto mais facilitado o acesso às certificações melhor seria a visão
de todos perante o mercado de trabalho.

Dois pontos de vista diferentes:

Desempregado:
- Para mim me candidatar a vaga X precisor passar por o teste A, B e o C. Bom eu tenho uma meta!!

Empresa:
- Para esta vaga, no mínimo o indivíduo tem que passar pelo teste X, Y e o Z.


Resumindo. A Certificação "OpenSource" seria criada não pelo "criador", mas sim por pessoas (lógico com uma certa experiência e qualificação), que no dia-a-dia convivem com Desenvolvedores de todos os níveis.

O que vocês acham ?? Vai ou não vai ??


14 de abr. de 2007

Ler e gravar arquivos em java

Parece besta, mas já vi algumas pessoas com dúvidas..

Existem diversas formas em java para ler e gravar arquivos. Vou mostrar uma que me parece a mais simples.

Tando para ler ou gravar são utilizados 3 objetos.

- File
- Writer ou Reader
- Objeto para controlar o buffer

Gravar um arquivo:







Ler um arquivo:




Tae uma forma bem simples para trabalhar com arquivos...

Abraço!

13 de abr. de 2007

Ordenar objetos em Java








Hoje tive que ordenar objetos de uma Collection. Essa coleção era resultado de uma consulta muito louca usando a api Criteria do Hibernate, por isso não consegui utilizar um simples ORDER BY.


Para resolver meu problema utilizei as API's
Commons Collection e BeanUtil do Jakarta.

O código ficou assim:


List<BeanComparator> sortFields = new ArrayList();
sortFields.add(new BeanComparator("semestre"));
sortFields.add(new BeanComparator("nome"));

ComparatorChain multiSort = new ComparatorChain(sortFields);
java.util.Collections.sort(disciplinas,multiSort);

Tirei o exemplo do Porta JavaFree, só não achei o link mais

Este código é bem simples.

Primeiro criei uma list de BeanComparator. BeanComparator é utilizado em conjunto pela classe ComparatorChain para ordenar uma list por vários campos. Nome meu caso nome e semestre.

Era isso!

28 de mar. de 2007

Datas em Java - Ainda existe dúvida ?

Esse post está Deprcated! hehehe..

Tenho visto pelos fóruns e listas da vida muitas dúvidas quanto a datas em java, isso me motivou a este post.
A própria JDK já vem com ferramentas para realizar trabalhos simples com datas.
Já ouviu falar na classe Calendar ??
Classe calendar oferece algumas operações básicas com datas.

1º) Desmembrar data
Você já deve ter visto que métods da classe java.utill.Date como: getHour() , getMonth() , getYear() e muitos outros estão
Deprecated.
Que faz esse trabalho é a classe java.util.Calendar.
Pra não esquecer sempre que você cria um objeto java.util.Date ele pega por padrão a data e hora atual da máquina. A mesma coisa acontece quando se cria uma instancia de Calendar. Continuando...
Abaixo vai um exemplo de código que pega dia, mês, ano, minutos e segundos da data atual.

public static void main(String[] args) {
Calendar calendar = Calendar.getInstance();

int dia = calendar.get(Calendar.DATE);
int mes = calendar.get(Calendar.MONTH);
int ano = calendar.get(Calendar.YEAR);

System.out.println("Dia: " + dia);
System.out.println("Mês: " + mes);
System.out.println("Ano: " + ano);
}

Atenção: o mês inicia com zero, ou seja, Janeiro = 0, fevereiro = 1, etc...
2º) Acrescentar e remover dias, mes, anos, horas, minutos...
Através do método add(), você pode acrescentar ou remover datas.
Mas como?? não existe o método remove()!!!
Para remover é só passar o int negativo, conforme exemplos:

public static void main(String[] args) {
Calendar calendar = Calendar.getInstance();
calendar.add( Calendar.DAY_OF_MONTH , 5); //adicionar 5 dias do mês
calendar.add( Calendar.HOUR , -2);//diminuir 2 horas
calendar.add( Calendar.YEAR, -18); //diminuir 18 anos

int dia = calendar.get(Calendar.DATE);
int mes = calendar.get(Calendar.MONTH);
int ano = calendar.get(Calendar.YEAR);

System.out.println("Dia: " + dia);
System.out.println("Mês: " + mes);
System.out.println("Ano: " + ano);
}

3º) Comparar datas
Outra possibilidade é saber se uma data é maior ou menor que outra.
Para isto existe o método comparTo().
Exemplo:
public static void main(String[] args) {

//eu
java.util.Date dataAtual = new java.util.Date();

java.util.Calendar calendar = java.util.Calendar.getInstance();
calendar.add(Calendar.YEAR , -18);

// ele
java.util.Date data18AnosAtras= calendar.getTime();

int result = dataAtual.compareTo( data18AnosAtras );

System.out.println(result);

}


O que eu fiz?!
Criei uma data atual com new Date(). Após removi 18 anos (
calendar.add(Calendar.YEAR , -18) ) e peguei outra data.
Depois chamei o métod compareTo() para saber se o objeto
data18AnosAtras era maior ou mernor que dataAtual.
O resultado no console foi 1. (?????)

Veja que chamei a data atual de EU e a outra data de ELE. Isso é para facilitar o entendimento.
O que o métod compareTo() faz?? ele faz a seguinte pergunta:

Eu sou maior ou menor que ele ?
Resposta: 1

-1 = "eu sou menorl"
0 = "eu sou igual"
1 = "eu sou maior"

Era isso...
Espero ter tirado algumas dúvidas.

LEMBRANDO: CRÍTICAS SEMPRE SÃO BEM VINDAS!!!

Abraço!

19 de mar. de 2007

JPA/Hibernate com Postgresql








Utilizo hibernate com postgresql há alguns anos. Uma dificuldade que sempre tive nas ferramentas para geração dos antigos XML’s e, agora, as classes anotadas é a sequence.

Nenhuma ferramenta que utilizei até hoje trouxe solução para isso.
O resultado disso é alterar o tipo do id.

Sendo assim segue exemplo do XML e de um classe anotada utilizando as sequences do postgres.

No postgres foi criada a seguinte tabela:










PESSOA

id serial

nome varchar(50)

SEQUENCE
pessoa_id_seq


Na aplicação a seguinte classe:









Exemplo do mapemento desta classe com XML:










Exemplo do mapemento com ANNOTATIONS:








No hibernate toda classe persistente deve ter o atributo id, que será utilizado para garantir a integridade dos objetos.

Esse id pode ser gerado de diversas formas, exemplo:

  • sequence
  • native
  • increment
  • identity
  • native

Para obter os detalhes desses tipos de geradores de id, acesse o site do
Hibernate

No exemplo acima utilizamos a sequence. o parâmetro generator, utilizado no XML e com Annotations identifica qual será o gerador do id que o hibernate deverá utilizar., mas para isso é necessário informar o nome da sequence que será utilizada para a respectiva classe.

Espero ter ajudado de alguma forma.

Abraço à todos!