Jakarta Persistence 3.1

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

The release contains following changes:

• 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

Requires Java SE 11 or newer (aligned with Jakarta EE 10).

• Jakarta Persistence 3.1 Release Record
• 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)
• 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

单击下面的规范以访问规范文档、Javadoc、技术兼容性工具包(TCK)以及每个版本的规范的兼容实现.

Platform and Profile 规范

Jakarta EE Platform and Profile 规范是各个规范的总括规范。Jakarta EE Platform 包括大多数单独的规范，而 Profile 规范包括用于开发Web平台和微服务体系结构的单独规范.

单独规范

每个单独的规范都描述了实现企业Java应用程序的特定方面的标准化方式.