Jakarta Persistence 3.1

Release for Jakarta EE 10

Jakarta Persistence defines a standard for management of persistence and object/relational mapping in Java(R) environments.

New features, enhancements or additions

• EntityManagerFactory and EntityManager interfaces extend java.lang.AutoCloseable interface
• Fixes ClassTransformer.transform to throw Persistence API specific exception
• Adds support for java.util.UUID and GenerationType.UUID
• Adds CEILING, EXP, FLOOR, LN, POWER, ROUND, and SIGN numeric functions to Jakarta Persistence QL and ceiling(), exp(), floor(), ln(), power(), round(), and sign() to Criteria API
• Adds LOCAL DATE, LOCAL DATETIME, and LOCAL TIME functions to Jakarta Persistence QL and corresponding localDate(), localDateTime(), and localTime() to Criteria API
• Adds EXTRACT function to Jakarta Persistence QL
• Adds support for Expressions as conditions in Criteria CASE expressions
• Adds missing definition of single_valued_embeddable_object_field in Jakarta Persistence QL BNF
• Clarifies mixing types of query input parameters
• Clarifies definition of the Basic type
• Clarifies the order of parameters in the LOCATE function
• Clarifies SqlResultSetMapping with multiple EntityResults and conflicting aliases

Removals, deprecations or backwards incompatible changes

• None

Minimum Java SE Version

Java SE 11 or higher

Details

• Jakarta Persistence 3.1 Release Record
  • Jakarta EE Platform 10 Release Plan
• Jakarta Persistence 3.1 Specification Document (PDF)
• Jakarta Persistence 3.1 Specification Document (HTML)
• Jakarta Persistence 3.1 Javadoc
• Jakarta Persistence 3.1 XML Schemas
  • XML Schema for the persistence configuration file
  • XML Schema for the persistence object/relational mapping file
• Jakarta Persistence 3.1 TCK (sig, sha, pub)
  • Unique constraint creation (Issue #388) Jakarta Persistence 3.1.1 TCK (sig, sha, pub)
  • Wrong typed comparison expressions in TCK (Issue #391) Jakarta Persistence 3.1.2 TCK (sig, sha, pub)
  • Wrong query result type in TCK tests (Issue #579) Jakarta Persistence 3.1.3 TCK (sig, sha, pub)
  • Multiple fetch joins for same attribute (Issue #591) Jakarta Persistence 3.1.4 TCK (sig, sha, pub)
  • Should not set version on entity manually (Issue #632) , Derived identity TCK tests rely on unspecified cascading behavior (Issue #637) Jakarta Persistence 3.1.5 TCK (sig, sha, pub)
  • TCK should not redefine table on single table inheritance subclass (Issue #644) Jakarta Persistence 3.1.6 TCK (sig, sha, pub)
• Maven coordinates
  • jakarta.persistence:jakarta.persistence-api:jar:3.1.0
• Compatible Implementations used for ratification
  • EclipseLink 4.0.0-M3

Compatible Implementations

• EclipseLink 4.0.0-M3
• Hibernate ORM 6.0.0.Final

Ballots

Release Review

The Specification Committee Ballot concluded successfully on 2022-04-06 with the following results.

The ballot was run in the jakarta.ee-spec mailing list

Plan Review

The Specification Committee Ballot concluded successfully on 2021-04-28 with the following results.

The ballot was run in the jakarta.ee-spec mailing list