Olá, tudo bom? Como vão vocês?
Este artigo é o primeiro de uma série ao qual vou ensiná-los a trabalhar com a Java Persistence API 2.0 (JPA 2.0). Dúvidas e críticas são bem vindas.
Preparando o ambiente
Se você tem experiência com instruções SQL, JPA é fácil de entender. A JPA trabalha com objetos diretamente e converte as suas instruções para SQL através da JDBC, de modo a executar no banco de dados.
JPA na prática começará com um ambiente de trabalho simples, onde teremos as execuções fora do ambiente Java EE.
O banco de dados
O banco de dados utilizado será o MySQL. Você pode baixar a versão 5.1, utilizada no artigo, aqui.
Preparando o banco de dados do exemplo
Abra o terminal do MySQL com seu usuário e senha ROOT (aquela que você configurou na instalação).
Crie o banco de dados executando o seguinte comando:
create database jpapratica;
Baixando e descompactando o driver JDBC
No mesmo local onde baixamos o MySQL, existe a versão atual do driver JDBC, chamado de Connector/J 5.1. Baixe o arquivo e o descompacte. O arquivo JAR do qual iremos precisar será:
mysql-connector-java-5.1.10-bin.jar
O ambiente de trabalho
Os exemplos desenvolvidos serão criados no Eclipse IDE 3.6 M4, ao qual teremos uma breve explicação de como criar projetos JPA.
Baixando o Eclipse
No momento em que este artigo é criado, o Eclipse IDE 3.6 ainda está em desenvolvimento. Esta versão foi escolhida por possuir suporte a JPA 2.0. O pacote que vamos usar é o Eclipse IDE for Java EE Developers.
Figura 1. Download do pacote Eclipse IDE 3.6 para Java EE
A biblioteca JPA
O EclipseLink é a biblioteca oficial da Java Persistence API 2.0. Você pode baixá-la clicando aqui. O arquivo baixado para o exemplo é o EclipseLink 2.0.0 Installer Zip.
Ao baixar o arquivo, descompacte-o. Você precisará das seguintes bibliotecas:
- eclipselink.jar
- javax.persistence_2.0.0.v200911271158.jar
Criando o projeto
No Eclipse, na view Project Explorer, clique com o direito e selecione New>JPA Project.
Figura 2. Criando um projeto JPA no Eclipse
Na caixa de diálogo New JPA Project, digite o nome do projeto em Project name. No exemplo que usaremos será chamado de JpaNaPratica. Em Configuration, mantenha em Minimal JPA 2.0 Configuration. Clique no botão Next para prosseguir.
Figura 3. Primeira etapa da criação do projeto
A segunda etapa mantenha como está, prosseguindo com o botão Next.
Figura 4. Segunda etapa da criação do projeto
As bibliotecas do EclipseLink no projeto
Na terceira etapa, você vai configurar o EclipseLink 2.0. Para isso, clique no ícone Manage libraries.
Figura 5. Terceira etapa da criação do projeto - Clicando no ícone Manage libraries
Na caixa de diálogo Preferences, clique no botão New.
Figura 6. Caixa de diálogo Preferences - Botão New
Na caixa de diálogo New User Library digite EclipseLink e confirme no botão OK.
Figura 7. Caixa de diálogo New User Library
Ao retornar a caixa de diálogo Preferences, clique no botão Add JARs e selecione as bibliotecas do EclipseLink.
Figura 8. Caixa de diálogo Preferences - botão Add JARs
Após selecioná-las, confirme a caixa de diálogo no botão OK.
Figura 9. Biblioteca EclipseLink com os JARs adicionados
Ao retornar ao diálogo de criação do seu projeto, marque a biblioteca EclipseLink que agora está lá.
Figura 10. Biblioteca EclipseLink adicionada na criação do projeto
A conexão no Eclipse e a biblioteca do banco de dados no projeto
Abaixo, em Connection, clique em Add connection.
Figura 11. Detalhe em Add Connection na criação do projeto
Na caixa de diálogo New Connection Profile, selecione o MySQL e dê o nome da sua conexão em Name. Prossiga clicando no botão Next.
Figura 12. Caixa de diálogo New Connection Profile
Na próxima etapa, você precisa adicionar definir o driver JDBC do banco de dados MySQL. Clique no ícone 
(New Driver Definition).
Figura 13. Detalhe da localização do ícone New Driver Definition
Na caixa de diálogo New Driver Definition, você possui três abas:
Name/Type – Aqui definimos qual a versão do driver JDBC iremos usar. Neste caso, MySQL JDBC Driver.
Figura 14. Selecionando o driver JDBC do MySQL
Jar List – O local onde se encontra o arquivo JAR. Neste caso, remova o atual, clicando em Remove JAR/Zip e adicione o que foi baixado em Add JAR/Zip.
Figura 15. Adicionando o path para o arquivo JDBC do MySQL
Properties – Podemos configurar a conexão ao banco de dados. Coloque os dados do seu banco de dados utilizado no exemplo deste artigo.
Figura 16. Propriedades da conexão ao banco de dados do exemplo
Após configurar o seu driver e conexão com o banco de dados, confirme no botão OK.
Retornando ao diálogo New Connection Profile, agora com as configurações do seu banco de dados preenchidas, marque Save password.
Figura 17. Dados para a conexão preenchidos
Clique no botão Test Connection e, se estiver com tudo funcionando perfeitamente, verá uma mensagem de sucesso.
Figura 18. Conexão executada com sucesso
Terminadas estas configurações, seu perfil de conexão está pronto. Pode finalizar o diálogo clicando em Finish.
Figura 19. Caixa de diálogo New Connection Profile com dados da conexão
Retornando a criação do projeto, em New JPA Project, agora você possui todas as informações necessárias para criar o projeto JPA. Clique no botão Finish para gerar o projeto.
Figura 20. Etapa final do diálogo New JPA Project com tudo preenchido
O Eclipse desejará colocar a perspectiva associada ao tipo de projeto. Basta confirmar em Yes.
Figura 21. Autorizando a mudança de perspectiva
O projeto gerado é mostrado na Figura a seguir:
Figura 22. Projeto JPA gerado
Adicionando a biblioteca JDBC no projeto
Embora, para configurar o projeto JPA, você criou uma conexão com o MySQL, esta apenas funciona no Eclipse IDE. Para adicionar no seu projeto a biblioteca JDBC, clique com o direito do mouse sobre ele e selecione Properties no menu de contexto.
Na caixa de diálogo Properties, vá em Java Build Path, na aba Libraries e clique em Add Library.
Figura 23. Caixa de diálogo Properties, em Java Build Path, na aba Libraries
Na caixa de diálogo Add Library, selecione Connectivity Driver Definition e clique no botão Next.
Figura 24. Caixa de diálogo Add Library, em Connectivity Driver Definition
Na segunda etapa, selecione a configuração do MySQL que fez para o Eclipse, em Available Driver Definitions e confirme no botão Finish.
Figura 25. Seleção da configuração do MySQL em Available Driver Definitions
Agora você possui a biblioteca JDBC também em seu projeto. Agora confirme a caixa de diálogo e seu projeto estará pronto para trabalhar com a JPA 2.0.
Figura 26. Detalhe da biblioteca JDBC do MySQL adicionada ao projeto
Em JPA 2.0 na Prática – Parte 2, vocês verão como configurar, criar entidades e executar operações em JPA que serão refletidas no banco de dados do MySQL.
Bons Códigos!