Gerir o ficheiro persistence.xml

Quando o utilizador cria um projecto, o Eclipse cria um ficheiro META-INF\persistence.xml no directório do projecto.

Pode criar um ficheiro persistence.xml apêndice no directório META-INF ao criar um projecto do JPA (consulte "Criar um projecto do JPA"). Pode gerir este ficheiro através do editor de XML (consulte ) ou através do Editor persistence.xml.


Nota:

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

    Utilize esta página para definir propriedades de rastreio de alterações e do personalizador de sessão.

  • Colocação em Memória Cache

    Utilize esta página para definir propriedades de colocação em memória cache.

  • Registar

    Utilize esta página para definir propriedades da acção registar.

  • Opções

    Utilize esta página para definir propriedades de sessão e de base de dados destino.

  • Geração de Esquemas

    Utilize esta página para definir propriedades relativas a DDL.

Para projectos que utilizem a implementação JPA EclipseLink, a página Ligações também inclui propriedades do conjunto de ligações JDBC.

Se o projecto utilizar a plataforma Generic, só estarão disponíveis as páginas Geral, Ligação, Propriedades e Origem.


Para utilizar o Editor persistence.xml:

  1. Abra o ficheiro persistence.xml. Aparece a página Geral do editor.

  2. Utilize a página Geral para definir os ficheiros persistence.xml de atributos relativos à<unidade-persistência>, bem como os elementos <fornecedor> e <classe> (descritos na tabela seguinte.


    Sugestão:

    A página Código Fonte do Editor persistence.xml permite ver e editar o ficheiro XML em bruto.

    Propriedade Descrição Elemento Definido
    Nome Introduza o nome da unidade de persistência. <nome da unidade-persistência = "<Nome>">
    Fornecedor de Persistência Introduza o nome do fornecedor de persistência. <fornecedor>
    Descrição Introduza uma descrição para esta unidade de persistência. Trata-se de uma propriedade opcional. <descrição>
    Classes Geridas Adicionar ou remover as classes geridas com a unidade de persistência. <classe>
      Excluir Classes Não Listadas Seleccione para incluir todas as classes de entidades anotadas na raiz da unidade de persistência. <excluir-classes-não-listadas>
    Ficheiros de Correlação XML Adicionar ou remover os ficheiros XML de correlação relacional/ de objectos que definem as classes geridas com a unidade de persistência. <ficheiro-correlação>
    Ficheiros  JAR Adicionar ou remover ficheiros JAR e bibliotecas adicionais

  3. Utilize a página Ligação para definir os elementos <origem-dados-jta> e <origem-dados-alheia-jta> como se segue:

    Para configurar a origem da JTA (Java Transaction API) utilizado pelo fornecedor de persistência:

    1. Seleccione JTA na lista Tipo de Transacção.

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

    Para configurar uma origem de dados alheia à JTA:

    1. Seleccione Recurso Local na lista Tipo de Transacção.

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


      Nota:

      Seleccione Default() para utilizar a origem de dados facultada pelo contentor.

    Para projectos que utilizem a plataforma Generic, pode também definir o controlador de conjunto de ligações EclipseLink, controlador do conjunto de ligações, URL, nome de utilizador e palavra-passe.

  4. Utilize a tabela na página Propriedades para definir o elemento <properties>, específico do revendedor.

    Para adicionar elementos <property>:

    1. Faça clique em Adicionar.

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

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


    Nota:

    Se o projecto utilizar a plataforma EclipseLink, a página de ligação também inclui parâmetros para conjuntos de ligações JDBC.

Referências relacionadas

Editor persistence.xml

 

Tarefa relacionada

Sincronizar classes

 

Conceito relacionado

O ficheiro persistence.xml