Platform and Dependency Requirements
OpenJPA 4.2.0 requires Java 17 or later at build and run time (4.1.x required Java 11). All jars contain Java 17 class files.
Java 21 and Java 25 runtimes are supported; class files of newer JDKs are read through xbean-asm9-shaded 4.30.
The jakarta.persistence:jakarta.persistence-api dependency was raised from 3.1.0 to 3.2.0 (Jakarta EE 11 level). Applications must update explicit dependencies on the API and recompile.
Custom wrappers implementing jakarta.persistence interfaces (EntityManager, EntityManagerFactory, Query, CriteriaBuilder, PersistenceUnitInfo, …) must implement the new 3.2 methods.
The persistence_3_2.xsd and orm_3_2.xsd schemas are bundled and selected for documents declaring version="3.2"; version="3.1" documents are still not accepted (use 3.0 or 3.2).
XML column mapping (XMLValueHandler) and the detection of XML-mapped value classes now use jakarta.xml.bind (JAXB 4) instead of javax.xml.bind (JAXB 2). The optional dependencies are jakarta.xml.bind:jakarta.xml.bind-api 4.0.x and a JAXB 4 runtime such as com.sun.xml.bind:jaxb-impl 4.0.x.
Value classes that are still annotated with javax.xml.bind.annotation annotations are no longer recognized as XML column types and silently fall back to the default (serialized) mapping.
Migrate such classes to jakarta.xml.bind.annotation.
The managed JDBC driver versions used for testing were raised: MySQL Connector/J 9.x (com.mysql:mysql-connector-j, driver class com.mysql.cj.jdbc.Driver), MariaDB Connector/J 3.5.x, Microsoft mssql-jdbc 13.x and Derby 10.16.x (which itself requires Java 17). MySQLDictionary now also recognises com.mysql.cj.jdbc.exceptions.MySQLTimeoutException as a timeout exception, so lock and query timeouts are classified correctly with Connector/J 8 and later.
Drivers are not shipped with OpenJPA; see Compatible Database Matrix for the tested database and driver versions.
Build-only changes: the Maven profile test-h2-2 was removed (use test-h2), and the legacy JPA 1.0 / 2.0 TCK profiles in openjpa-integration/tck were replaced by the Jakarta Persistence 3.2 TCK runner (-Ptck32-profile, run-tck32.sh).