Persistencia de Yakarta

Un ejemplo de clase de entidad con metadatos ORM declarados mediante anotaciones (las declaraciones de importación y los métodos setter/getter se omiten para simplificar).

@Entity public class Person { @Id private long id ; private String firstName ; private String lastName ; private int age ; }

La @Entityanotación declara que la clase representa una entidad. @IdDeclara el atributo que actúa como clave primaria de la entidad. Se pueden usar anotaciones adicionales para declarar metadatos adicionales (por ejemplo, cambiar el nombre de la tabla predeterminada en la @Tableanotación) o para crear asociaciones entre entidades.

La especificación EJB 3.0 (que forma parte de la plataforma Java EE 5) incluía una definición de la API de persistencia de Java. Sin embargo, los desarrolladores no necesitan un contenedor EJB ni un servidor de aplicaciones Java EE para ejecutar aplicaciones que utilicen esta API de persistencia. ^{[ 5 ]} Las futuras versiones de la API de persistencia de Java se definirán en una especificación y un JSR independientes , en lugar de en la especificación/JSR de EJB.

La API de persistencia de Java reemplaza la solución de persistencia de EJB 2.0 CMP (Container-Managed Persistence).

La API de persistencia de Java se desarrolló, en parte, para unificar la API de objetos de datos de Java y la API de persistencia gestionada por el contenedor (CMP) de EJB 2.0. La mayoría de los productos que admiten ambas API también admiten la API de persistencia de Java.

La API de persistencia de Java especifica la persistencia únicamente para sistemas de gestión de bases de datos relacionales, centrándose en el mapeo objeto-relacional (ORM). Algunos proveedores de JPA admiten otros modelos de bases de datos , aunque esto queda fuera del alcance del diseño de JPA. La sección de introducción de la especificación JPA establece: "El objetivo técnico de este trabajo es proporcionar una herramienta de mapeo objeto-relacional para el desarrollador de aplicaciones Java que utilice un modelo de dominio Java para gestionar una base de datos relacional". ^{[ 6 ]}

La especificación Java Data Objects admite ORM, así como persistencia en otros tipos de modelos de bases de datos, por ejemplo, bases de datos de archivos planos y bases de datos NoSQL , incluidas bases de datos de documentos , bases de datos de grafos y muchos otros almacenes de datos.

Hibernate, fundado por Gavin King, proporciona un marco de mapeo objeto-relacional de código abierto para Java . Las versiones 3.2 y posteriores proporcionan una implementación para la API de persistencia de Java. ^{[ 7 ] [ 8 ]} King representó a JBoss en JSR 220, ^{[ 9 ]} el grupo de expertos de JCP encargado del desarrollo de JPA. Esto dio lugar a una controversia y especulación continuas en torno a la relación entre JPA e Hibernate. Sun Microsystems declaró ^{[ 10 ]} que las ideas provenían de varios marcos, incluidos Hibernate y Java Data Objects .

Spring Data JPA es una implementación de la abstracción de repositorio que es un componente clave del diseño orientado al dominio basado en el framework de aplicaciones Java Spring . Admite de forma transparente todas las implementaciones de JPA disponibles y admite operaciones CRUD , así como la ejecución conveniente de consultas a la base de datos. ^{[ 11 ] : 47 [ 12 ]}

El desarrollo de una nueva versión de JPA 2.0 comenzó en julio de 2007 en el Java Community Process como JSR 317. JPA 2.0 fue aprobada como versión final el 10 de diciembre de 2009. El objetivo de JPA 2.0 era abordar características presentes en algunos de los proveedores ORM más populares, pero que no lograron la aprobación por consenso para JPA 1.0.

Las principales características incluidas fueron:

• Funcionalidad de mapeo objeto-relacional ampliada
  • Soporte para colecciones de objetos incrustados, vinculados en el ORM con una relación de muchos a uno.
  • Listas ordenadas
  • Combinaciones de tipos de acceso
• Una API de consulta de criterios
• Estandarización de sugerencias SQL
• Estandarización de metadatos adicionales para respaldar la generación de DDL.
• Soporte para la validación
• Compatibilidad con caché de objetos compartidos.

Proveedores que admiten JPA 2.0:

• Batoo JPA
• DataNucleus (anteriormente JPOX)
• EclipseLink (anteriormente Oracle TopLink )
• IBM , para WebSphere Application Server ^{[ 13 ]}
• JBoss con Hibernate
• Base de datos de objetos
• OpenJPA
• Base de datos orientada
• Versant Corporation JPA ( base de datos de objetos ) ^{[ 14 ]}

El desarrollo de la versión 2.1 de JPA comenzó en julio de 2011 como JSR 338. JPA 2.1 fue aprobada como versión final el 22 de mayo de 2013.

Las principales características incluidas fueron:

• Convertidores que permiten conversiones de código personalizadas entre tipos de bases de datos y objetos.
• Actualización/eliminación de criterios para permitir actualizaciones y eliminaciones masivas a través de la API de criterios
• Gráficos de entidades para la recuperación o fusión parcial o específica de objetos.
• Mejoras en JPQL/Criteria, como subconsultas aritméticas, funciones genéricas de bases de datos, cláusula ON de unión y la opción TREAT.
• Generación de esquemas
• Compatibilidad con procedimientos almacenados

Proveedores que admiten JPA 2.1:

• Núcleo de datos
• Enlace Eclipse
• Hibernar
• OpenJPA (a partir de la versión 2.2.0)

El desarrollo de JPA 2.2, una versión de mantenimiento, comenzó en 2017 bajo la norma JSR 338. La revisión de mantenimiento fue aprobada el 19 de junio de 2017.

Las principales características incluidas fueron:

• La adición de @Repeatable a todas las anotaciones relevantes.
• Compatibilidad con el uso de anotaciones JPA en metaanotaciones
• Transmisión de resultados de consultas
• La capacidad de los AttributeConverters para ser inyectables mediante CDI.
• Compatibilidad con tipos de fecha y hora de Java 8

Proveedores que admiten JPA 2.2:

• DataNucleus (a partir de la versión 5.1)
• EclipseLink (a partir de la versión 2.7)
• Hibernate (a partir de la versión 5.3)
• OpenJPA (a partir de la versión 3.0)

JPA pasó a llamarse Jakarta Persistence en 2019 y la versión 3.0 se lanzó en 2020. Esto incluyó el cambio de nombre de paquetes y propiedades, pasando de javax.persistence a jakarta.persistence.

Proveedores que admiten Jakarta Persistence 3.0:

• DataNucleus (a partir de la versión 6.0)
• EclipseLink (a partir de la versión 3.0)
• Hibernate (a partir de la versión 5.5)
• OpenJPA (a partir de la versión 4.0)

La versión 3.1 se publicó en 2022. ^{[ 3 ]} Forma parte de Jakarta EE 10 y, por lo tanto, requiere al menos Java 11 para ejecutarse. Añade una mejor gestión de UUID, varias funciones JPQL nuevas para operaciones matemáticas y de fecha/hora, y otros pequeños cambios. ^{[ 15 ]}

Proveedores que admiten Jakarta Persistence 3.1:

• DataNucleus (a partir de la versión 6.0)
• EclipseLink (desde la versión 4.0) ^{[ 16 ]}
• Hibernate (desde la versión 6.0) ^{[ 17 ]}
• OpenJPA (a partir de la versión 4.0)

La versión 3.2 se lanzó en 2024. ^{[ 4 ]} Introdujo una gran cantidad de mejoras en la API junto con algunas mejoras en el lenguaje de consulta. ^{[ 18 ] [ 19 ]}

Proveedores que admiten Jakarta Persistence 3.2:

• EclipseLink (desde la versión 5.0) ^{[ 19 ]}
• Hibernate (desde la versión 7.0) ^{[ 19 ]}

• Sitio web oficial
• Documentación para la versión final de la especificación EJB3 (denominada JSR220)
• Página de persistencia de GlassFish. Enlace obsoleto archivado el 12/01/2013 en archive.today.
• Página de persistencia de JCP

• Javadoc de API de persistencia de Java EE 6
• Tutorial de la API de persistencia de Java EE 6
• Javadoc de API de persistencia de Java EE 7
• Tutorial de la API de persistencia de Java EE 7
• Tutorial sobre persistencia en Java EE 5
• Guía de especificaciones de Jakarta EE - Explicación de la persistencia
• Guía de inicio de Jakarta EE: Cómo almacenar y recuperar datos usando Jakarta Persistence
• Tutorial oficial de Jakarta EE: Introducción a la persistencia de Yakarta