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

HHH-10664 - Prep 6.0 feature branch - merge hibernate-entitymanager into hibernate-core (test fixup)

This commit is contained in:
Steve Ebersole 2016-05-03 12:21:11 -05:00
parent 0f2ced4668
commit 7b3570149d
1 changed files with 14 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
migration-guide.adoc
View File

@ -1,12 +1,21 @@
= 6.0 Migration Guide
= 5.2 Migration Guide
:toc:
This guide discusses migration from Hibernate ORM version 5.1 to version 6.0. For migration from
This guide discusses migration from Hibernate ORM version 5.1 to version 5.2. For migration from
earlier versions, see any other pertinent migration guides as well.
== Background
Lots of work has been done for 6.0. One of the things 6.0 will need is a unified view of "type systems"
including its own type system (Type, EntityPersister, CollectionPersister, etc) and JPA's type system - which
would mean unifying all of this in hibernate-core. Because of this and the other large changes slated for 6.0
we decided to release a 5.2 that showed a clear migration path to the changes in 6.0 but that still supported the
older calls and expectations as much as possible.
== Move to Java 8 for baseline
Hibernate 6.0 is built using Java 8 JDK and will require Java 8 JRE at runtime (we are investigating whether
Hibernate 5.2 is built using Java 8 JDK and will require Java 8 JRE at runtime (we are investigating whether
Java 9 will also work). This has a number of implications:
* The hibernate-java8 module has been merged into hibernate-core and the Java 8 date/time types are now natively
@ -51,10 +60,6 @@ implement JPA methods now in core I decided to implement more of a composition a
has been moved into the `org.hibernate.Cache` and `org.hibernate.engine.spi.CacheImplementor` contracts
helping implement JPA's `javax.persistence.Cache` role.
== SQM
todo - discuss
== Misc
@ -67,4 +72,5 @@ todo - discuss
are allowed to access EntityTransactions. Need a strategy to handle this
* Session#getFlushMode and Query#getFlushMode clash in terms of Hibernate (FlushMode) and JPA (FlushModeType)
returns. #getFlushMode has been altered to return JPA's FlushModeType. The Hibernate FlushMode
is still available via #getHibernateFlushMode and #setHibernateFlushMode
is still available via #getHibernateFlushMode and #setHibernateFlushMode. Same for Session#getFlushMode
and EntityManager#getFlushMode.