Gerenciando o Arquivo persistence.xml

Ao criar um projeto, o Eclipse criar o arquivo META-INF\persistence.xml no diretório do projeto.

Você pode criar um arquivo stub persistence.xml no diretório META-INF ao criar um projeto JPA (consulte "Criando um Novo Projeto JPA"). É possível gerenciar este arquivo através do editor XML (consulte ) ou através do Editor de persistence.xml.


Nota:

Dependendo da sua implementação JPA (por exemplo, EclipseLink), as seguintes páginas adicionais podem estar disponíveis no Editor persistence.xml
  • Customização

    Utilize esta página para definir propriedades relacionadas ao customizador de sessão e rastreio de alteração.

  • Armazenamento em Cache

    Utilize esta página para definir as propriedades de armazenamento em cache.

  • Registro

    Utilize esta página para definir as propriedades de criação de log.

  • Opções

    Utilize esta página para definir a sessão e as propriedades do banco de dados de destino.

  • Geração de Esquema

    Utilize esta página para definir as propriedades relacionadas ao DDL.

Para projetos que utilizam a implementação JPA do EclipseLink, a página Conexões também inclui as propriedades do conjunto de conexão JDBC.

Se o projeto utilizar a plataforma Genérica, então somente as páginas Geral, Conexão, Propriedades e Origem estão disponíveis.


Para utilizar o Editor persistence.xml:

  1. Abra o arquivo peristence.xml. A página Geral do editor é aberta.

  2. Use a página Geral para definir os arquivos persistence.xml, atributos relacionados a <unidade-de-persistência>, assim como os elementos <provedor>, e <classe> (descritos na tabela a seguir).


    Dica:

    A página Origem do Editor persistence.xml permite visualizar e editar o arquivo XML bruto.

    Propriedade Descrição Elemento Definido
    Nome Digite o nome da unidade de persistência. <persistence-unit name = "<Name>">
    Provedor de Persistência Digite o nome do provedor de persistência. <provider>
    Descrição Digite uma descrição para esta unidade de persistência. Esta é uma propriedade opcional. <description>
    Classes Gerenciadas Inclua ou remova as classes gerenciadas através da unidade de persistência. <class>
      Excluir Classes Não Listadas Selecione para incluir todas as classes de entidade anotadas na raiz da unidade de persistência. <exclude-unlisted-classes>
    Arquivos de Mapeamento XML Inclua ou remova o objeto/arquivos XML de mapeamento relacional para definir as classes gerenciadas através da unidade de persistência. <mapping-file>
    Arquivos  JAR Inclua ou remova bibliotecas e arquivos JAR adicionais

  3. Utilize a página Conexão para definir os elementos <jta-data-source> e <non-jta-data-source> da seguinte forma:

    Para configurar a origem JTA (Java Transaction API) utilizada pelo provedor de persistência:

    1. Selecione JTA a partir da lista Tipo de Transação.

    2. Digite o nome JNDI global da origem de dados.

    Para configurar uma origem de dados não-JTA:

    1. Selecione Local de Recurso a partir da lista Tipo de Transação.

    2. Digite o nome JNDI global da origem de dados.


      Nota:

      Selecione Default() para utilizar a origem de dados fornecida pelo contêiner.

    Para objetos que usam a plataforma Genérica, também é possível definir o driver do conjunto de conexões EclipseLink, driver do conjunto de conexões, URL, nome e senha de usuário.

  4. Utilize a tabela na página Propriedades para configurar o elemento <properties> específico de fornecedor.

    Para incluir elementos <property>:

    1. Clique em Incluir.

    2. Digite os atributos <name> e <value> para o elemento <property> utilizando os campos Nome e Valor da tabela.

    Para remover um elemento <property>, selecione uma propriedade definida na tabela e, em seguida, clique em Remover.


    Nota:

    Se o projeto utilizar a plataforma EclipseLink, a página de conexão também incluirá parâmetros para o conjunto de conexões JDBC.

Referência Relacionada

Editor persistence.xml

 

Tarefa Relacionada

Sincronizando Classes

 

Conceito Relacionado

O Arquivo persistence.xml