Java Persistence Architecture API (JPA): O que é, como baixar, instalar, configurar e testar

1 - Introdução

O Java Persistence Architecture API (JPA) é uma especificação Java para acessar, persistir (gravar) e gerenciar dados entre objetos/classes Java e o banco de dados relacional. O JPA foi definido inicialmente como parte da especificação EJB 3.0 como uma substituição para a especificação EJB 2 CMP Entity Beans. Hoje, O JPA é a abordagem padrão para o mapeamento objeto-relacional (Object to Relational Mapping (ORM)) na indústria de sistemas em Java.

Importante lembrar que o JPA é somente uma especificação, não um produto. E como tal, não consegue realizar a persistência de dados. Ele é somente um conjunto de interfaces e, portanto, requer uma implementação. Há várias implementações open source e comerciais do JPA que podemos adotar e usar em nossas aplicações. Além disso, espera-se que todos os servidores de aplicação Java EE ofereçam suporte a JPA. Finalmente, um banco de dados é outro requisito que não pode faltar. O JPA sozinho não produz os resultados esperados, a saber, a obtenção, leitura e persistência de dados em um banco de dados.

O JPA permite que um POJO ou POJOs (Plain Old Java Objects - classes simples) sejam facilmente persistidos sem a necessidade de implementar quaisquer interfaces ou métodos, como era exigido na especificação EJB 2 CMP. O mapeamento objeto-relacional de um objeto pode ser definido, em JPA, por meio de anotações (annotations) padrão ou XML que definem como a classe Java é mapeada para uma tabela no banco de dados relacional. Temos também uma API EntityManager de tempo de execução para processar queries (consultas) e transações nos objetos e, consequentemente, no banco de dados. O JPA define também uma linguagem de query a nível de objetos chamada de JPQL que permite reconstruir objetos a partir de suas informações no banco de dados.

2 - Qual implementação devo usar?

Atualmente há várias implementações interessantes de JPA. Entre estas podemos citar: EclipseLink (Eclipse), TopLink (Oracle), Hibernate (RedHat), TopLink Essentials (Glassfish), Kodo (Oracle), Open JPA (Apache) e Ebean (SourceForge). É claro que cada um alega possuir suas vantagens em relação aos demais. Não entrarei neste mérito. Fica a cargo do leitor decidir qual vai usar. Para este artigo, contudo, usarei a implementação do Glassfish, ou seja, o TopLink Essentials.

3 - Baixando, instalando e configurando o TopLink Essentials

Durante a autoria deste artigo, a implementação JPA do Glassfish é uma das mais populares entre os desenvolvedores Java. Por esta razão vamos baixá-la. Para isso, aponte seu navegador para http://glassfish.dev.java.net/downloads/persistence/JavaPersistence.html e localize a seção Milestone binary builds. O arquivo a ser baixado é glassfish-persistence-installer-v2-b58g.jar (ou parecido), com o tamanho de 2,9 Mb. Hora de tomar um cafezinho.

Finalizado o download, mova o arquivo para uma pasta na raiz de seu sistema (ou o diretório que preferir). Em meu sistema optei por "c:\jpa".

Hora de instalar o TopLink Essentials. Abra um janela de comando, navegue até o diretório "c:\jpa" e dispare o comando:

java -Xmx256m -jar glassfish-persistence-installer-v2-b58g.jar

Como resultado da execução deste comando nós teremos a seguinte estrutura de diretórios:

glassfish-persistence glassfish-persistence\README glassfish-persistence\3RD-PARTY-LICENSE.txt glassfish-persistence\LICENSE.txt glassfish-persistence\toplink-essentials-agent.jar glassfish-persistence\toplink-essentials.jar

Hora de configurar. Tudo que temos que fazer é adicionar os JARs toplink-essentials-agent.jar e toplink-essentials.jar no CLASSPATH de nosso sistema.

4 - Testando o TopLink Essentials

Hora de testar o TopLink Essentials. Para isso usaremos uma aplicação Java SE bem simples. Veja o código:

import javax.persistence.*; public class Estudos{ public static void main(String[] args){ EntityManagerFactory emf; EntityManager em; // se compilar e executar é sinal de que // o TopLink Essentials já pode ser usado à // vontade System.out.println("Parece que está tudo ok!\n\n"); System.exit(0); } }

O que fizemos neste exemplo foi importar as classes e interfaces do pacote javax.persistence, a saber, EntityManager, EntityManagerFactory, Persistence, EntityTransaction, Query, etc. Após o import nós declaramos objetos das interfaces EntityManagerFactory e EntityManager.

E isso é tudo. Se você seguiu todos os passos anteriores atentamente, já está pronto para iniciar seus estudos de JPA. Boa jornada.

Graduado em Ciência da Computação pela UNIP (Universidade Paulista) e atualmente morando em Goiânia-GO. Desde 1998 tem atuado no desenvolvimento de sistemas, seja como responsável principal ou como freelancer ou consultor. Entre as linguagens que já desenvolveu pode-se incluir Java, Delphi, C++, Python, Perl, PHP, Ruby, etc. Alguns projetos já desenvolvidos incluem salas de chat, fóruns, sistemas de gerenciamento de notícias, blogs, sistemas de helpdesk, sites corporativos, sistemas acadêmicos e financeiros. É o proprietário e principal editor de conteúdo do site Arquivo de Códigos.

Atua também como professor do curso de Sistemas de Informação da Faculdade Delta (http://www.faculdadedelta.edu.br)

Este usuário atua como freelancer Veja a relação de freelancers

Use este formulário para inserir um novo comentário para este artigo ou tutorial. É preciso estar logado no site. Se você já um usuário registrado, efetue o login no menu esquerdo de nossas páginas.

Título do comentário:

Seu comentário:

Dicas de formatação: Não é permitido código HTML nos comentários. No entanto, você pode conseguir boas formatações usando: [b][/b] - para negrito [ul][/ul] - para listas não ordenadas [li][/li] - para itens da lista [pre][/pre] - para exibir trechos de códigos-fonte (de forma a manter a formatação e facilitar a leitura)

Quer aprender Java? Comece instalando, testando o SDK e escrevendo o seu primeiro programa Java

Gerenciadores de Layout - Apresentando BorderLayout

Gerenciadores de Layout - Apresentando FlowLayout

Aprenda a manipular bases de dados MySQL usando Java :: Obtendo uma conexão com o banco de dados MySQL

Java Persistence Architecture API (JPA): O que é, como baixar, instalar, configurar e testar

Aprenda a manipular bases de dados MySQL usando Java :: Baixando, instalando e testando o driver para a conexão Java + MySQL

Aprenda a manipular bases de dados MySQL usando Java :: Entendendo como programas Java se conectam a uma base de dados

Aprenda a manipular bases de dados MySQL usando Java :: Introdução

Recursos de autoboxing e unboxing - O que são e quando devo usar?

Apache Tomcat - Estrutura básica de uma aplicação web desenvolvida em Java

MySQL - Como instalar o MySQL Query Browser no Windows

Apache Tomcat - Atualizando e desinstalando aplicações web no Apache Tomcat

Adobe Flex - Escrevendo um sistema de login de usuários usando Flex + PHP

Python - Acessando o banco de dados MySQL a partir de Python usando o MySQLdb

GTK+ - Escrevendo sua primeira aplicação gráfica usando GTK+ e C no Linux Ubuntu

Groovy - Como baixar, instalar e escrever sua primeira aplicação usando Groovy

Ruby - Instalando e executando o Ruby no Linux Ubuntu

Apache Tomcat - Usando o container e servidor web Apache Tomcat - Introdução

Java - Aprenda a manipular bases de dados MySQL usando Java :: Introdução

Java - Aprenda a manipular bases de dados MySQL usando Java :: Baixando, instalando e testando o driver para a conexão Java + MySQL

AJAX - O objeto XMLHttpRequest e o XML DOM

Ruby - Escrevendo seu primeiro programa em Ruby

Ruby - Instalando e executando Ruby no Windows

Adobe Flex - Conhecendo o Flex Builder - Da instalação à primeira aplicação

Tipos de dados da linguagem Java