Sobre unidades de persistência

Consulte também

Uma unidade de persistência será necessária se você estiver usando persistência de Java na aplicação. Uma unidade de persistência é uma coleção de propriedades com nome exclusivo que são usadas para determinar como um conjunto específico de entidades em uma aplicação é gerenciado e persistente.

As unidades de persistência são definidas no arquivo persistence.xml. Pode haver mais uma unidade de persistência definida em persistence.xml, mas cada uma delas deve ter um nome exclusivo.

Propriedades especificadas em uma unidade persistência incluem as seguintes:

As unidades de persistência podem ser empacotadas como parte de um arquivo WAR ou JAR-EJB, ou como um arquivo JAR que pode então ser incluído na aplicação.

Escopo da unidade de persistência

O escopo de uma unidade de persistência é determinado pela localização do persistence.xml. Quando você usar um assistente para criar uma unidade de persistência, o IDE cria persistence.xml no local apropriado para o escopo. Por exemplo, se você usar o IDE para criar uma unidade de persistência para um módulo EJB, o IDE gera persistence.xml no diretório src/conf para o módulo EJB. Quando o JAR EJB é construído, ele empacota persistence.xml no diretório META-INF do JAR EJB. O escopo da unidade de persistência é o conjunto de classes no arquivo JAR EJB.

Se o escopo não for especificado explicitamente em uma unidade de persistência, por padrão todas as entidades no arquivo JAR EJB estarão dentro do escopo da unidade de persistência definido em persistence.xml.

Observações:

Provedor de persistências

Um provedor de persistência refere-se a uma implementação da API de persistência de Java. O provedor de persistência é uma biblioteca que oferece a funcionalidade para que objetos sejam persistentes na aplicação.

O provedor de persistência TopLink Essentials está incluído no IDE. TopLink Essentials é a implementação de referência e o provedor de persistências Java padrão no Sun Java System Application Server Platform Edition 9 e GlassFish. O provedor de persistências TopLink Essentials é uma biblioteca que consiste em toplink-essentials.jar e toplink-essentials-agent.jar. Você pode usar TopLink Essentials como provedor ou especificar um outro provedor de persistência.

"Data Source"

Uma fonte de dados refere-se ao banco de dados em que entidades de persistências estão armazenadas. A fonte de dados deve estar registrada no servidor e especificada com o nome JNDI. Se as transações forem transações JTA gerenciadas por contêiner, a fonte de dados deve ser uma fonte de dados JTA. Se as transações forem gerenciadas por aplicação, a fonte de dados será especificada de acordo com a conexão do banco de dados JDBC registrada no IDE.

Em ambientes Java SE, o banco de dados é especificado usando uma fonte de dados ou outros meios, dependendo dos requisitos do provedor de persistência usado.

Tipos de transações

Uma unidade de persistência especifica como as transações são gerenciadas na aplicação. O tipo de transação usado depende do contêiner de destino. Se você estiver implantando em um contêiner de Java EE, as transações podem ser gerenciadas pelo contêiner ou pela aplicação. Se não estiver implantando em um contêiner de Java EE, as transações devem ser gerenciadas pela aplicação.

Consulte também
Trabalhando com aplicações empresariais
Criando uma unidade de persistência
Sobre a persistência de Java
Sobre gerenciadores de entidades

Notificações legais