Gestionar el archivo persistence.xml

Cuando se crea un proyecto, Eclipse crea el archivo META-INF\persistence.xml en el directorio del proyecto.

Puede crear un archivo persistence.xml de apéndice en el directorio META-INF al crear un proyecto JPA (consulte el apartado "Crear un proyecto JPA"). Puede gestionar este archivo mediante el editor XML o a través del editor de persistence.xml.


Nota:

Dependiendo de su implementacion de JPA (por ejemplo, EclipseLink), las páginas adicionales siguientes pueden estar disponibles en el editor de persistence.xml:
  • Personalización

    Utilice esta página para definir propiedades relacionadas con el seguimiento de cambios y la personalización de sesiones.

  • Memoria caché

    Utilice esta página para definir las propiedades de almacenamiento en memoria caché.

  • Anotaciones

    Utilice esta página para definir las propiedades de anotaciones.

  • Opciones

    Utilice esta página para definir las propiedades de base de datos de destino y de sesión.

  • Generación de esquema

    Utilice esta página para definir las propiedades relacionadas con DDL.

Para proyectos que utilizan la implementación JPA de EclipseLink, la página Conexiones también incluye propiedades de agrupación de conexiones JDBC.

Si el proyecto utiliza la plataforma Genérica, sólo están disponibles las páginas General, Conexión, Propiedades y Fuente.


Para utilizar el editor de persistence.xml:

  1. Abra el archivo persistence.xml. Se visualizará la página General del editor.

  2. Utilice la página General para definir los atributos relacionados con el elemento <persistent-unit> de los archivos persistence.xml, así como los elementos <provider> y <class> (descritos en la tabla siguiente).


    Sugerencia:

    La página Código fuente del editor de persistence.xml permite visualizar y editar el archivo XML original.

    Propiedad Descripción Elemento definido
    Nombre Especifique el nombre de la unidad de persistencia. <persistence-unit name = "<Nombre>">
    Proveedor de persistencia Especifique el nombre del proveedor de persistencia. <provider>
    Descripción Especifique una descripción de esta unidad de persistencia. Esta propiedad es opcional. <description>
    Clases gestionadas Añada o elimine las clases gestionadas por medio de la unidad de persistencia. <class>
      Excluir clases no listadas Seleccione incluir todas las clases de entidad anotadas en la raíz de la unidad de persistencia. <exclude-unlisted-classes>
    Archivos de correlación XML Añada o elimine los archivos XML de correlación de objeto/relacionales que definen las clases gestionadas por medio de la unidad de persistencia. <mapping-file>
    Archivos JAR Añadir o eliminar archivos JAR y bibliotecas adicionales

  3. Utilice la página Conexión para definir los elementos <jta-data-source> y <non-jta-data-source> del siguiente modo:

    Para configurar el origen JTA (API de transacción Java) utilizado por el proveedor de persistencia:

    1. Seleccione JTA en la lista Tipo de transacción.

    2. Especifique el nombre JNDI global del origen de datos.

    Para configurar un origen de datos no JTA:

    1. Seleccione Local de recurso en la lista Tipo de transacción.

    2. Especifique el nombre JNDI global del origen de datos.


      Nota:

      Seleccione Default() para utilizar el origen de datos suministrado por el contenedor.

    Para los proyectos que utilizan la plataforma Genérica, también puede definir el controlador de agrupaciones de conexión de EclipseLink, el controlador de agrupaciones de conexión, el URL, el nombre de usuario y la contraseña.

  4. Utilice la tabla de la página Propiedades para establecer el elemento <properties> específico del proveedor.

    Para añadir elementos <property>:

    1. Pulse Añadir.

    2. Especifique los atributos <name> y <value> para el elemento <property> utilizando los campos Nombre y Valor de la tabla.

    Para eliminar un elemento <property>, seleccione una propiedad definida en la tabla y luego pulse Eliminar.


    Nota:

    Si el proyecto utiliza la plataforma EclipseLink, la página Conexión también incluye parámetros para agrupación de conexiones JDBC.

Consulta relacionada

Editor de persistence.xml

 

Tarea relacionada

Sincronizar clases

 

Concepto relacionado

El archivo persistence.xml