z2-Environment

h1. Hibernate Add-on

(Since 2.3)

The Hibernate add-on provides the "Hibernate":http://hibernate.org libraries and some supporting functionality:

* The EntityManagerUtil ("source":https://redmine.z2-environment.net/projects/z2-addons/repository/z2-addons-hibernate/revisions/master/entry/org.hibernate/java/src.api/com/zfabrik/hibernate/EntityManagerUtil.java, "javadoc":http://www.z2-environment.net/javadoc/org.hibernate!2Fjava/api/com/zfabrik/hibernate/EntityManagerUtil.html): A utility class providing functionality to

** maintain an EntityManager between transaction boundaries, when integrating with the built-in transaction management (see [[How to Transaction Management]]). 

** allow JTA data source lookup via JNDI even when in a plain naming environment (with no initial context factory set), i.e. a workaround for "HHH-8818":https://hibernate.atlassian.net/browse/HHH-8818.

* The Z2JtaPlatform ("source":https://redmine.z2-environment.net/projects/z2-addons/repository/z2-addons-hibernate/revisions/master/entry/org.hibernate/java/src.api/com/zfabrik/hibernate/Z2JtaPlatform.java, "javadoc":http://www.z2-environment.net/javadoc/org.hibernate!2Fjava/api/com/zfabrik/hibernate/Z2JtaPlatform.html): A JTA Platform implementation for the built-in transaction management (see [[How to Transaction Management]]).

In order to understand how to use these, it is best to visit [[Sample-hibernate-basic]]. You do not need these supporting functions, if you chose to rely on other frameworks that support similar functionality, such as the Spring framework (see [[How to Spring]]).

The Hibernate Add-On provide Hibernate binaries by adding a fragment "org.hibernate/mvnFragment":https://redmine.z2-environment.net/projects/z2-addons/repository/z2-addons-hibernate/revisions/master/entry/org.hibernate/mvnFragment.properties (see [[How_to_Access_a_Maven_Repository]] on what that is) to the maven component repository *environment/mavenDefault* that is declared throughout in all examples and that all add-ons add to.

That is, in order to use this add on as is, you need to declare a maven component repository, as it has been done in the mentioned sample above.

h2. Version map

|_. add-on version |_. Hibernate version |

| 2.3 - 2.5 | 4.3.4.Final | "mvn roots":https://redmine.z2-environment.net/projects/z2-addons/repository/z2-addons-hibernate/revisions/v2.3/entry/org.hibernate/mvnFragment.properties |

| 2.6 | 5.3.1.Final | "mvn roots":https://redmine.z2-environment.net/projects/z2-addons/repository/z2-addons-hibernate/revisions/v2.6/entry/org.hibernate/mvnFragment.properties |