Introdu��o ao EntityManager

Na nova Java Persistence Specification, o EntityManager � o serviço central para todas as aç�es de persist�ncia. Entidades s�o objetos de Java claros que s�o alocados como qualquer outro objeto Java. Eles n�o ficam persistentes explicitamente at� seu c�digo interagir com o EntityManager para os fazer persistente. O EntityManager administra o O/R que o mapea entre uma classe de entidade e uma fonte de dados subjacente. O EntityManager prov� APIs para criar consultas, buscando objetos, sincronizando objetos, e inserindo objetos no banco de dados. Tamb�m pode prover caching e pode administrar a interaç�o entre uma entidade e serviços transacionais em um ambiente Java EE como JTA. O EntityManager � firmemente integrado com Java EE e EJB mas n�o � limitado a estes ambientes; pode ser usado em programas de Java SE.

Persistence Contexts

Começaremos atrav�s de uma introduç�o das condiç�es do core do JPA. Uma unidade de persist�ncia ou persistence-unit � uma configuraç�o nomeada de classes de entidade. Um contexto de persist�ncia � um gerenciamento de Entidades onde, todo contexto de persist�ncia � associado com uma unidade de persist�ncia. Entendendo o contexto de persist�ncia � a chave para entender o EntityManager. Uma inclus�o de entidade ou exclus�o de um contexto de persist�ncia, determinar�o no resultado de qualquer operaç�es persistentes nisto.

Se o contexto de persist�ncia participa em uma transaç�o, que est� na mem�ria, o estado das entidades gerenciadas ser� sincronizado ao banco de dados. Ainda apesar do papel importante que faz, o contexto de persist�ncia nunca � realmente vis�vel � aplicaç�o. Sempre � acessado indiretamente pelo EntityManager e assumido que estar l� quando n�s precisarmos dele.

Persistence Unit

Um EntityManager mapea um conjunto de classes a um banco de dados particular. Este conjunto de classes � chamado de persistence unit (unidade de persist�ncia).

Antes de voc� poder pensar at� mesmo em criar ou consultar entidades com um entity manager, voc� tem que aprender a empacotar uma unidade de persist�ncia para uso, dentro de um ambiente Java SE ou Java EE.

Uma unidade de persist�ncia est� definida em um arquivo chamado persistence.xml. Este arquivo � um descriptor de desenvolvimento exigido no JPA. Um arquivo de persistence.xml pode definir um ou mais unidades de persist�ncia. Este arquivo fica situado no diret�rio META-INF em:

Ambientes SE, esta pasta fica no classpath da aplicaç�o. Em uma aplicaç�o web, este diret�rio fica localizado nas pasta WEB-INF\classes\META-INF

Na Listagem 1 temos um exemplo de um arquivo persistence.xml.


<?xml version="1.0" encoding="UTF-8"?>
<persistence version="1.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:
xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence 
http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd">
  <persistence-unit name="novoExemploPU" transaction-type="RESOURCE_LOCAL">
    <provider>oracle.toplink.essentials.ejb.cmp3.EntityManagerFactoryProvider
    </provider>
    <class>teste.Empresas</class>
    <class>teste.Cartoes</class>
    <properties>
      <property name="toplink.jdbc.url" value="jdbc:mysql://localhost:3306/devmedia"/>
      <property name="toplink.jdbc.user" value="root"/>
      <property name="toplink.jdbc.driver" value="com.mysql.jdbc.Driver"/>
      <property name="toplink.jdbc.password" value="123456"/>
    </properties>
  </persistence-unit>
</persistence>

Listagem 1. Arquivo persistence.xml

Voc� deve especificar suas classes de Entidades dentro no arquivo persistence.xml (persistence unit), como mostrado no c�digo.

Vamos analisar como obter acesso de um EntityManager, para poder inserir, atualizar, remover e consultar um bean de entidade no seu bancos de dados. Embora voc� possa usar uma interface de f�brica em Java EE, esta plataforma prov� algumas caracter�sticas adicionais que fazem isto mais f�cil e menos �rduo de administrar instancias de EntityManager.

EntityManagerFactory

EntityManagers podem ser criado ou podem ser obtidos de um EntityManagerFactory. Em uma aplicaç�o Java SE, voc� tem que usar um EntityManagerFactory para criar instancias de um EntityManager. Usar o factory n�o � uma exig�ncia em um ambiente Java EE.

Obtendo um EntityManagerFactory em um ambiente Java SE

Em um ambiente Java SE, a classe javax.persistence.Persistence � respons�vel por amarrar um EntityManagerFactory, como mostra a Listagem 2.


public class Persistence {
   public static EntityManagerFactory createEntityManagerFactory(
           String unitName
   );
   public static EntityManagerFactory createEntityManagerFactory(
           String unitName,
           java.util.Map
 properties
   );

Listagem 2. Classe javax.persistence.Persistence

A classe javax.persistence.Persistence procura descriptors da distribuiç�o persistence.xml dentro de seu classpath de Java. O par�metro do unitName que voc� passa dentro permitir� que a execuç�o da persistencia encontre um EntityManagerFactory que combine o nome dado.


EntityManagerFactory factory = Persistence.createEntityManagerFactory("novoExemploPU");
...
factory.close( );

Em Java EE, obter um EntityManagerFactory pode ser injetado diretamente em um campo ou em um m�todo setter do seu EJBs usando a anotaç�o @javax.persistence.PersistenceUnit, como mostra a Listagem 3.


import javax.persistence.*;
import javax.ejb.*;
 
@Stateless
public MyBean implements MyBusinessInterface {
 
   @PersistenceUnit(unitName="novoExamploPU")
   private EntityManagerFactory factory;
 
   private EntityManagerFactory factory2;
 
   @PersistenceUnit(unitName="novoExemploOutroDB")
   public void setFactory2(EntityManagerFactory f) {
      this.factory2 = f;
   }

Listagem 3. Anotaç�o @javax.persistence.PersistenceUnit

Fizemos uma breve introduç�o a alguns conceitos dentro do JPA como tecnologia utilizada na camada de persist�ncia.

Refer�ncias:

Enterprise JavaBeans 3.0 5� Ediç�o.

Introdu��o ao EntityManager

Na nova Java Persistence Specification, o EntityManager é o serviço central para todas as ações de persistência.

Persistence Contexts

Persistence Unit

EntityManagerFactory

Obtendo um EntityManagerFactory em um ambiente Java SE

Artigos relacionados