Hibernate
/
hibernate-orm
mirror of https://github.com/hibernate/hibernate-orm
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Upgrade the Migration Guide for 5.6

This commit is contained in:
Sanne Grinovero 2021-08-27 15:22:59 +01:00
parent 5e4b3bd321
commit ae80deb63c
1 changed files with 10 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
migration-guide.adoc
View File

@ -1,29 +1,21 @@
= 5.5 Migration Guide
= 5.6 Migration Guide
:toc:
This guide discusses migration from Hibernate ORM version 5.4 to version 5.5. For migration from
earlier versions, see any other pertinent migration guides as well.
== Background
This guide discusses migration from Hibernate ORM version 5.5 to version 5.5.
For migration from other versions, see https://github.com/hibernate/hibernate-orm/wiki/Migration-Guides .
== Known changes
This version is very similar to Hibernate ORM 5.4; essentially it includes all bugfixes that have been
applied to the 5.4 maintenance releases, and on top of this it introduces support for the Jakarta Persistence
API (in addition the the JPA APIs we already support).
This version is very similar to Hibernate ORM 5.5, with the exception of having removed some long standing deprecated features.
=== Javassist removed
=== Dom4J based XML mapping
It is no longer an option to choose Javassist as implementation used for the bytecode enhancement of entities.
Byte Buddy has been the default for some time, and Javassist has been deprecated for some time and now has been removed.
The implementation of Hibernate's parsing of XML mapping definitions has been entirely reimplemented based on
JAXB rather than DOM4J, making progress to remove this ancient dependency.
No specific issues are known at this time.
This should have no functional impact on applications; the only exception being that it's not longer valid to
configure `hibernate.bytecode.provider=javassist`: remove the property if you're using this.
=== Removed the ability to disable "enhanced proxies"
A side effect is that Hibenate ORM no longer lists javassist among its dependencies.
The "enhanced proxies" feature has been introduced as a performance improving feature in 5.3 initially, at
which time it was optional.
Since then, many more corner cases have been fixed and this feature is now always enabled. Enjoy the improvements!
No changes are expected to be needed in user code to benefit from this.