Arquitetura Java Persistence API (JPA)
A persistência de dados é a possibilidade de manter os dados entre as execuções do aplicativo. A persistência é vital para os aplicativos corporativos por causa do acesso necessário aos bancos de dados relacionais. Os aplicativos que forem desenvolvidos para este ambiente devem gerenciar a persistência por si só ou usar soluções de terceiros para manipular as atualizações e recuperações do banco de dados com persistência. O Java™ Persistence API (JPA) fornece um mecanismo para gerenciamento de persistência e de mapeamento de objeto e funções para as especificações EJB.
A especificação JPA define o mapeamento relacional de objetos internamente, em vez de depender das implementações de mapeamento específicas do fornecedor. O JPA é baseado no modelo de programação Java que se aplica aos ambientes Java EE , mas o JPA pode funcionar dentro de um ambiente Java SE para testar funções do aplicativo.
- A API EntityManager pode persistir, atualizar, recuperar ou remover objetos de um banco de dados
- A API EntityManager e os metadados de mapeamento de objeto relacional manipulam a maioria das operações do banco de dados sem precisar gravar o código JDBC ou SQL para manter a persistência.
- A JPA fornece uma linguagem de consulta, estendendo a linguagem de consulta EJB independente (também conhecida como JPQL), que pode ser utilizada para recuperar objetos sem a gravação de consultas SQL específicas do banco de dados com o qual se está trabalhando.
O JPA é projetado para operar dentro e fora de um contêiner Java Enterprise Edition (Java EE). Ao executar a JPA em um contêiner, os aplicativos podem usar o contêiner para gerenciar o contexto de persistência. Se não houver contêiner para gerenciar a JPA, o aplicativo deverá manipular o gerenciamento do contexto de persistência sozinho. Os aplicativos projetados para persistência gerenciada por contêiner não exigem muita implementação de código para tratar a persistência, mas esses aplicativos não podem ser utilizados fora de um contêiner. Aplicativos que gerenciam sua própria persistência podem funcionar em um ambiente de container ou em um ambiente Java SE.
- Unidade de persistência
- Consiste de metadados declarativos que descrevem o relacionamento dos objetos da classe de entidade para um banco de dados relacional. O EntityManagerFactory utiliza esses dados para criar um contexto de persistência que possa ser acessado por meio do EntityManager.
- EntityManagerFactory
- Usado para criar um EntityManager para interações com o banco de dados. Os contêineres do servidor de aplicativos normalmente fornecem essa função, mas o EntityManagerFactory será necessário se você estiver utilizando a persistência gerenciada pelo aplicativo JPA. Uma instância do EntityManagerFactory representa um Contexto de Persistência.
- Contexto de persistência
- Define o conjunto de instâncias ativas que o aplicativo está manipulando atualmente. O contexto de persistência pode ser criado manualmente ou por meio de injeção.
- EntityManager
- O gerenciador de recursos que mantém a coleção ativa de objetos de entidade que estão sendo usados pelo aplicativo. O EntityManager manipula a interação do banco de dados e os metadados para mapeamentos
de objetos relacionais. Uma instância do
EntityManager representa um Contexto de Persistência. Um aplicativo em um container pode obter o EntityManager através de injeção no aplicativo ou olhando-o para cima no nome do componente Java-espaço. Se o aplicativo gerenciar
sua persistência, o EntityManager será obtido do EntityManagerFactory.Atenção: Injeção do EntityManager é suportado apenas para os seguintes artefatos:
- Beans de sessão EJB 3.x
- Beans acionados por mensagens EJB 3.x
- Servlets, Filtros de Servlet e Listeners
- Identificadores de tag JSP que implementam as interfaces javax.servlet. jsp.tagext.Tag e javax.servlet.jsp.tagext.SimpleTag
- JavaServer Faces (JSF) beans gerenciados
- a classe principal do aplicativo cliente.
- Objetos de entidade
- Uma classe Java simples que representa uma linha em uma tabela de banco de dados em sua forma mais simples. Os objetos de entidade podem ser classes concretas ou abstratas. Elas mantêm os estados utilizando propriedades ou campos.
API de Persistência Java e Contextos de Transação Local
O WebSphere fornece contextos de transação global e local a componentes gerenciados. Uma transação é sempre ativa se é um contexto de transação global (GTC) ou um contexto de transação local (LTC) com encadeamentos que verificam um componente gerenciado. Enquanto essa transação ativa não tem nenhum efeito em contextos de persistência gerenciada por aplicativo (ou seja, EntityManagers JPA adquiridos por meio de EntityManagerFactories injetados em um aplicativo via @PersistenceUnit), ela influencia contextos de persistência gerenciada por contêiner (ou seja, EntityManagers JPA injetados por meio de @PersistenceContext).
Os métodos da API JPA lançam uma TransactionRequiredException quando chamados de fora dos limites de um GTC e ainda lançam a exceção como esperado. No entanto, enquanto o LTC permanece ativo (até que um novo GTC seja iniciado ou o fim da chamada de serviço de componente seja atingido) o contexto de persistência de transações gerenciadas por contêiner (CMT) também permanece ativo. Permanecer ativo significa que as entidades buscadas (por localizar ou consulta) por um EntityManager CMT dentro dos limites de um LTC ainda são gerenciadas por esse contexto de persistência em vez de se tornarem imediatamente separadas. Esse comportamento pode surpreender alguns como uma diferença inesperada de comportamento em comparação com alguns guias de programação JPA. No entanto, uma vez que um GTC começa, o contexto de persistência mantido ativo pelo LTC é eliminado e entidades que são gerenciadas por esse contexto de persistência tornam-se separadas.