Gestionar el archivo persistence.xml

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

Archivo persistence.xml de ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd">
     <persistence-unit name="QuickStart">
          <class>quickstart.demo.model.Address</class>
          <class>quickstart.demo.model.Item</class>
     </persistence-unit>
</persistence>

Puede gestionar este archivo mediante el editor XML o a través del editor de persistence.xml.

El editor de persistence.xml

Pestaña General del editor de persistence.xml

Nota:

Dependiendo de su implementación de JPA (por ejemplo, EclipseLink), las páginas siguientes pueden estar disponibles en el Editor de persistence.xml:

  • General – Utilice esta página para definir las clases, los archivos de correlación y los archivos JAR para la unidad de persistencia.

  • Conexión – Utilice esta página para definir el origen de datos (elementos JTA y no JTA) para el proyecto.

  • 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 memoria caché.

  • Registro de anotaciones – Utilice esta página para definir las propiedades del registro 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 propiedades relacionadas con DDL.

  • Propiedades – Utilice esta página para añadir o eliminar propiedades específicas del proveedor.

  • Fuente – Utilice esta página para ver o modificar el origen XML del archivo persistence.xml.

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.

    Pestaña General del Editor persistence.xml

    Pestaña General del editor de persistence.xml

  3. Complete cada campo de la página General.

  4. 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.

    Pestaña Conexión del Editor de persistence.xml

    Pestaña Conexión del Editor de persistence.xml

  5. Complete cada campo de la página Conexión.

  6. 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.

    Pestaña Personalización del Editor de persistence.xml

    Pestaña Personalización del Editor de persistence.xml

  7. Complete cada campo de la página Personalización.

Las páginas adicionales pueden estar disponibles para el editor de persistence.xml, en función del proveedor JPA. Consulte "Editor de persistence.xml" para obtener más información.

Consulta relacionada

Tareas relacionadas

Conceptos relacionados