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
Minimum Java SE Version
Java SE 11 or higher
Details
- Jakarta Persistence 3.1 Release Record
- 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
- 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
- Compatible Implementations used for ratification
Compatible Implementations
Ballots
Release Review
The Specification Committee Ballot concluded successfully on 2022-04-06 with the following results.
| Representative |
Representative for: |
Vote |
| Kenji Kazumura |
Fujitsu |
+1 |
| Tom Watson, Emily Jiang |
IBM |
+1 |
| Ed Bratt, Dmitry Kornilov |
Oracle |
+1 |
| Andrew Pielage, Matt Gill |
Payara |
+1 |
| David Blevins, Jean-Louis Monteiro |
Tomitribe |
+1 |
| Ivar Grimstad |
EE4J PMC |
+1 |
| Marcelo Ancelmo, Martijn Verburg |
Participant Members |
+1 |
| Werner Keil |
Committer Members |
+1 |
| Jun Qian |
Enterprise Members |
+1 |
| Zhai Luchao |
Enterprise Members |
+1 |
|
Total |
10 |
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.
| Representative |
Representative for: |
Vote |
| Kenji Kazumura |
Fujitsu |
+1 |
| Dan Bandera, Kevin Sutter |
IBM |
+1 |
| Ed Bratt, Dmitry Kornilov |
Oracle |
+1 |
| Andrew Pielage, Matt Gill |
Payara |
+1 |
| Scott Stark, Mark Little |
Red Hat |
no vote |
| David Blevins, Jean-Louis Monteiro |
Tomitribe |
+1 |
| Ivar Grimstad |
EE4J PMC |
+1 |
| Marcelo Ancelmo, Martijn Verburg |
Participant Members |
+1 |
| Werner Keil |
Committer Members |
+1 |
| Dr. Jun Qian |
Enterprise Members |
+1 |
|
Total |
9 |
The ballot was run in the jakarta.ee-spec mailing list
