Criando um projeto JPA com o Eclipse e configurando o Hibernate

Nesse post vamos criar um projeto Java com o Eclipse e configur-lo de modo a possibilitar o uso de JPA em nossa aplicao. Nota: Para esse tutorial estou utilizando o Eclipse Juno, com JDK 6, Hibernate 4.1 e MySql 5.1

1 - Criar o projeto no Eclipse

V em File -> New -> Project... Na caixa NEW, selecione o assistente JPA Project Como na imagem abaixo:

Na janela seguinte, defina um nome para o projeto e repare na verso da JPA que no nosso caso a 2.0:

Um novo projeto foi criado. Repare que dentro do diretrio src, foi criado uma pasta chamada META-INF, e dentro dessa pasta, um arquivo denominado PERSISTENCE.XML. Esse um arquivo de configurao da JPA, e nele h informaes primordiais de acesso ao banco, alm de outras configuraes necessrias para o correto funcionamento dos recursos de persistncia.

2 - Adicionando as bibliotecas do Hibernate ao projeto

O segundo passo inserir as bibliotecas do Hibernate no projeto. Voc pode obt-las baixando-as do site do projeto Hibernate no sorceforge: http://sourceforge.net/projects/hibernate/files/hibernate4/ Aps baixar, descompacte o arquivo .zip. Sero usados todos os .jars das pastas required e jpa do diretrio lib. Clique com o boto direito do mouse sobre o projeto recm criado no eclipse, escolha a opo Build Path, e por fim, clique em Configure Build Path... Na janela aberta, clique no boto Add External JARs... como exibido na janela abaixo:

Escolha os jars das pastas required e jpa do diretrio lib, e clique em Abrir. Por fim, clique em OK. Obs: O mesmo dever ser feito com o driver do MySql, ou de qualquer outro banco que por ventura, esteja sendo utilizado. O driver do MySql pode ser baixado em http://dev.mysql.com/downloads/connector/j/

3 - Configurando o arquivo PERSISTENCE.XML

O prximo passo configurar o arquivo persistence.xml. Repare no contedo inicial do arquivo:
<persistence version="2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance" xmlns="http://java.sun.com/xml/ns/persistence" xsi:schemalocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd"> <persistence-unit name="JPA_TESTE"> </persistence-unit> </persistence>

Por padro, ao escolher o assistente JPA Project, um persistence-unit criado dentro

do persistence.xml com o mesmo nome do projeto. Veja que no cdigo acima, ele se chama JPA_TESTE. Voc pode alterar esse nome, mas guarde-o com carinho, pois o mesmo nome dever ser usado mais tarde. dentro do persistence-unit que iremos configurar a nossa conexo com o banco. Veja como ficar o arquivo:
<persistence version="2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance" xmlns="http://java.sun.com/xml/ns/persistence" xsi:schemalocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd"> <persistence-unit name="JPA"> <properties> <property name="javax.persistence.jdbc.url" value="jdbc:mysql://localhost/automoveis"></property> <property name="javax.persistence.jdbc.user" value="usuario"></property> <property name="javax.persistence.jdbc.password" value="senha"></property> <property name="javax.persistence.jdbc.driver" value="com.mysql.jdbc.Driver"></property> <property name="hibernate.dialect" value="org.hibernate.dialect.MySQLInnoDBDialect"></property> <property name="hibernate.hbm2ddl.auto" value="update"></property> </properties> </persistence-unit> </persistence>

Essas so as propriedades fundamentais nas configuraes da JPA: javax.persistence.jdbc.url: a url de conexo com o banco. javax.persistence.jdbc.user: o usurio com autorizao para conexo ao banco. javax.persistence.jdbc.password: a senha do usurio para conexo com banco. javax.persistence.jdbc.driver: a declarao da biblioteca utilizada na conexo ao banco. Nesse caso, estamos utilizando o MySql. hibernate.dialect: Essa uma propriedade do Hibernate, e deve ser configurada de acordo com o driver especificado. Trata-se de informar ao Hibernate, com que padro ele deve criar as instrues SQL. hibernate.hbm2ddl.auto: Outra propriedade do Hibernate. Especifica como o Hibernate deve tratar o banco de dados caso ele j exista ou ainda nem tenha sido criado. As possibilidades so:

Update Nada excludo, apenas criado. Com ele, todos os dados so simplesmente mantidos. Create-drop As tabelas so criadas pelo prprio Hibernate. Quando o cdigo for executado novamente, as tabelas so excludas e recriadas. Validate Nada excludo nem criado. Quando o cdigo executado, o Hibernate verifica se as tabelas esto criadas de acordo com as classes. Caso no, uma exception lanada. Pronto, agora temos um projeto configurado para o Hibernate. Essas so as configuraes mnimas necessrias para que possamos gozar dos imensos benefcios desse framework. Veja os prximos posts para ver alguns exemplos prticos de uso.