Documentation updates for Jakarta Persistence 3.2.

[anija-anil]

This issue proposes documentation updates related to EclipseLink changes for Jakarta Persistence 3.2.

1.Package Changes in EclipseLink

EclipseLink has updated the package for the following four classes.

• org.eclipse.persistence.config.SessionCustomizer -> org.eclipse.persistence.sessions.SessionCustomizer
• org.eclipse.persistence.config.DescriptorCustomizer ->org.eclipse.persistence.descriptors.DescriptorCustomizer
• org.eclipse.persistence.config.CacheIsolationType ->org.eclipse.persistence.annotations.CacheIsolationType
• org.eclipse.persistence.config.PropertiesUtils ->org.eclipse.persistence.internal.helper.PropertiesUtils




2. Instant Type Mapping Change

EclipseLink changed the mapping of Instant from BLOB to TIMESTAMP, so
customers must either update or regenerate their DDL files to use the new
column type, or override the mapping to keep the old type

Where to Apply These Updates

These updates should be added to a new Open Liberty documentation page that mirrors the structure and content of the existing WebSphere Liberty JPA overview page:
https://www.ibm.com/docs/en/was-liberty/core?topic=jpa-java-persistence-api-feature-overview

Specifically:

1. Add a new section under "JPA Feature Compatibility" for Jakarta Persistence 3.2 (jpa-3.2).
2. Include the package changes and mapping change described above in this new section.

[ramkumar-k-9286]

My mistake

@anija-anil

This issue needs to be added to the Liberty repository, as the page to be updated is located in Liberty Core.

You can add the issue here (https://github.ibm.com/websphere/liberty-docs/issues) and assign it to me.

Regards,
Ramkumar

[anija-anil]

We need that document to be available in Open Liberty.

[ramkumar-k-9286]

Hi @anija-anil

The suggested information has been added to the differences page.

Draft link: https://docs-draft-openlibertyio.mqj6zf7jocq.us-south.codeengine.appdomain.cloud/docs/latest/reference/diff/jakarta-ee11-diff.html#persist

Please review the same and let me know if you are ok with the content or if we need to add more information in the section.

If that is the case, please explain what changes need to be made ( in this issue), so that those changes can be made.

Regards,
Ramkumar.

[ramkumar-k-9286]

Additional information shared by @anija-anil on slack.

Addition :

---

• Supports for subqueries in the select, from and join clauses.
• Allow Java records as Embeddable Types.
• Provides programmatic way to perform Schema Management.
• Improvements of JPQL/Criteria API - add additional functions and operations such as left(), right, replace, || operator, cast, union, union all, intersect, intersect all, except, except allImproves type safety of the find() and refresh() methods.
• Added comment and check to @table and @column

Deprecation:

---

• Deprecates usage of Calendar, Date, Time, Timestamp, Temporal,MapKeyTemporal and TemporalType in new applications in favour of java.time API.
• Deprecates multiselect methods in CriteriaQuery. The preference is to use array or tuple method defined in CriteriaBuilder
• Deprecates use of Byte{} and Character{} arrays types for basic attributes, in favor of primitive array types.
• Deprecates addSubclassSubgraph() in EntityGraph for removal; addTreatedSubgraph() method should be used as direct replacement.
• Deprecates addSubgraph(Attribute, Class) and addKeySubgraph() in Graph / EntityGraph / SubGraph for removal; addTreatedSubgraph(Attribute, Class) and addMapKeySubgraph() methods should be used as direct replacements.
• Deprecates jakarta.persistence.spi.PersistenceUnitTransactionType for removal; jakarta.persistence.PersistenceUnitTransactionType methods should be used as direct replacement.
• Deprecates default public no-arg constructor in Jakarta.persistence.Persistence and PERSISTENCE_PROVIDER and providers fields in this class for removal with no constraint. This class is not designed for extensibility.

For this doc update , add New additions and removals.

[ramkumar-k-9286]

Hi @anija-anil

The suggested additional information has been added to the differences page.

Draft link: https://docs-draft-openlibertyio.mqj6zf7jocq.us-south.codeengine.appdomain.cloud/docs/latest/reference/diff/jakarta-ee11-diff.html#persist

Please review the same and let me know if you are ok with the content or if we need to add more information in the section.

If that is the case, please explain what changes need to be made ( in this issue), so that those changes can be made.

If you are satisfied with the changes, please add the Developer Reviewed label.

Regards,
Ramkumar.

[anija-anil]

The changes look good overall. There is just a minor correction needed:
In the Behavioral Changes section, there is a typo.
Please change
e EclipseLink persistence... → The EclipseLink persistence...

[ramkumar-k-9286]

Hi @anija-anil

The correction has been done.

Draft link: https://docs-draft-openlibertyio.mqj6zf7jocq.us-south.codeengine.appdomain.cloud/docs/latest/reference/diff/jakarta-ee11-diff.html#persist

If you are satisfied with the changes, please add the Developer Reviewed label.

Regards,
Ramkumar.