Hibernate (framework)

The mapping of Java classes to database tables is implemented by the configuration of an XML file or by using Java Annotations. When using an XML file, Hibernate can generate skeleton source code for the persistence classes. This is auxiliary when annotations are used. Hibernate can use the XML file or the Java annotations to maintain the database schema.

There are provided facilities to arrange one-to-many and many-to-many relationships between classes.{{sfn|Bauer|King|Gregory|2015}}{{rp|§=7|pp=140–171}} In addition to managing associations between objects, Hibernate can also manage reflexive associations wherein an object has a one-to-many relationship with other instances of the class type.

Hibernate supports the mapping of custom value types. This makes the following scenarios possible:

• Overriding the default SQL type when mapping a column to a property.
• Mapping Java Enums to columns as though they were regular properties.{{sfn|Bauer|King|Gregory|2015}}{{rp|§=5.1.7|pp=89–90}}
• Mapping a single property to multiple columns.

Definition:

Objects in an object-oriented application follow OOP principles, while objects in the back-end follow database normalization principles, resulting in different representation requirements. This problem is called "object–relational impedance mismatch". Mapping is a way of resolving the object–relational impedance mismatch problem.

Mapping informs the ORM tool of what Java class object to store in which database table.

Hibernate provides a SQL inspired language called Hibernate Query Language (HQL) for writing SQL-like queries against Hibernate's data objects. Criteria Queries are provided as an object-oriented alternative to HQL. Criteria Query is used to modify the objects and provide the restriction for the objects.{{sfn|Bauer|King|Gregory|2015}}{{rp|§=14.1.1|p=347–349}}

HQL (Hibernate Query Language) is the object-oriented version of SQL. It generates database independent queries so that there is no need to write database-specific queries. Without this capability, changing the database would require individual SQL queries to be changed as well, leading to maintenance issues.

Hibernate provides transparent persistence for Plain Old Java Objects (POJOs).{{sfn|Bauer|King|Gregory|2015}}{{rp|§=3.2.2|pp=37–38}} The only strict requirement for a persistent class is a no-argument constructor,{{sfn|Bauer|King|Gregory|2015}}{{rp|§=3.2.3|pp=39}} though not necessarily {{code|public}}. Proper behavior in some applications also requires special attention to the {{Javadoc|module=java.base|package=java.lang|class=Object|member=equals(java.lang.Object)|text=equals(Object obj)|monotype=y}} and {{Javadoc|module=java.base|package=java.lang|class=Object|member=hashCode()|text=hashCode()|monotype=y}} methods in the {{code|Object}} classes.{{cite web|title=Equals and HashCode|url=https://community.jboss.org/wiki/EqualsAndHashCode|publisher=JBoss Community|access-date=2013-12-16|archive-date=2013-12-16|archive-url=https://web.archive.org/web/20131216104403/https://community.jboss.org/wiki/EqualsAndHashCode|url-status=dead}} Hibernate recommends providing an identifier attribute, and this is planned to be a mandatory requirement in a future release.{{cite web|title=Hibernate User Guide: 2.5.5. Provide identifier attribute|url=http://docs.jboss.org/hibernate/orm/5.2/userguide/html_single/Hibernate_User_Guide.html#entity-pojo-identifier|publisher=JBoss Community}}

Collections of data objects are typically stored in Java collection classes, such as implementations of the {{Javadoc|module=java.base|package=java.util|class=Set|text=Set|monotype=y}} and {{Javadoc|module=java.base|package=java.util|class=List|text=List|monotype=y}} interfaces. Java generics, introduced in Java 5, are also supported. Hibernate can be configured to lazy load associated collections.{{sfn|Bauer|King|Gregory|2015}}{{rp|§=12.1|pp=289–293}} Lazy loading is the default as of Hibernate 3.

Related objects can be configured to cascade operations from one object to the other. For example, a parent {{code|Album}} class object can be configured to cascade its {{code|save}} and {{code|delete}} operations to its child {{code|Track}} class objects.

Hibernate can be used both in standalone Java applications and in Java EE applications using servlets, EJB session beans, and JBI service components. It can also be included as a feature in other programming languages. For example, Adobe integrated Hibernate into version 9 of ColdFusion (which runs on J2EE app servers) with an abstraction layer of new functions and syntax added into CFML.

In Hibernate jargon, an entity is a stand-alone object in Hibernate's persistent mechanism which can be manipulated independently of other objects.{{sfn|Bauer|King|Gregory|2015}}{{rp|§=4.2|pp=62–74}} In contrast, a component is subordinate to an entity and can be manipulated only with respect to that entity. For example, an Album object may represent an entity; but the Tracks object associated with the Album objects would represent a component of the Album entity, if it is assumed that Tracks can only be saved or retrieved from the database through the Album object. Unlike J2EE, Hibernate can switch databases.

Hibernate was started in 2001 by Gavin King with colleagues from Cirrus Technologies as an alternative to using EJB2-style entity beans. The original goal was to offer better persistence capabilities than those offered by EJB2; by simplifying the complexities and supplementing certain missing features.

In early 2003, the Hibernate development team began Hibernate2 releases, which offered many significant improvements over the first release.

JBoss, Inc. (now part of Red Hat) later hired the lead Hibernate developers in order to further its development.

In 2005, Hibernate version 3.0 was released. Key features included a new Interceptor/Callback architecture, user defined filters, and JDK 5.0 Annotations (Java's metadata feature). {{As of | 2010}}, Hibernate 3 (version 3.5.0 and up) was a certified implementation of the Java Persistence API 2.0 specification via a wrapper for the Core module which provides conformity with the JSR 317 standard.{{cite web|title=Hibernate 3.5.0-Final release|date=April 2010 |url=http://in.relation.to/Bloggers/Hibernate350FinalRelease|publisher=In Relation To...}}

In Dec 2011, Hibernate Core 4.0.0 Final was released. This includes new features such as [http://docs.jboss.org/hibernate/orm/5.3/userguide/html_single/Hibernate_User_Guide.html#multitenacy multi-tenancy] support, introduction of ServiceRegistry (a major change in how Hibernate builds and manages "services"), better session opening from SessionFactory, improved integration via org.hibernate.integrator.spi.Integrator and auto discovery, internationalization support, message codes in logging, and a more distinction between the API, SPI or implementation classes.{{Cite web|url=http://hibernate.org/orm/releases/|title=Releases - Hibernate ORM|website=hibernate.org}}

In December 2012, Hibernate ORM 4.1.9 Final was released.{{Cite web |url=http://in.relation.to/23792.lace |title=In Relation To... Hibernate ORM 4.1.9.Final Released |access-date=2012-12-13 |archive-url=https://web.archive.org/web/20130129164633/http://in.relation.to/23792.lace |archive-date=2013-01-29 |url-status=dead }}

In Mar 2013, Hibernate ORM 4.2 Final was released.{{Cite web |url=http://grepcode.com/snapshot/repository.jboss.org/nexus/content/repositories/releases/org.hibernate/hibernate-core/4.2.0.Final |title=GC: Hibernate-core-4.2.0.Final.jar - GrepCode Java Project Source |access-date=2014-11-27 |archive-url=https://web.archive.org/web/20141205114143/http://grepcode.com/snapshot/repository.jboss.org/nexus/content/repositories/releases/org.hibernate/hibernate-core/4.2.0.Final |archive-date=2014-12-05 |url-status=dead }}

In December 2013, Hibernate ORM 4.3.0 Final was released.{{Cite web |url=http://grepcode.com/snapshot/repository.jboss.org/nexus/content/repositories/releases/org.hibernate/hibernate-core/4.3.0.Final |title=GC: Hibernate-core-4.3.0.Final.jar - GrepCode Java Project Source |access-date=2014-11-27 |archive-url=https://web.archive.org/web/20141205112808/http://grepcode.com/snapshot/repository.jboss.org/nexus/content/repositories/releases/org.hibernate/hibernate-core/4.3.0.Final |archive-date=2014-12-05 |url-status=dead }} It features Java Persistence API 2.1.

In September 2015, Hibernate ORM 5.0.2 Final was released. It has improved bootstrapping, hibernate-java8, hibernate-spatial, Karaf support.

In November 2018, Hibernate ORM 5.1.17 Final was released. This is the final release of the 5.1 series.

In October 2018, Hibernate ORM 5.3 Final was released. It featured Java Persistence API 2.2 inheritance caching.

In December 2018, Hibernate ORM 5.4.0 Final was released.{{Cite web|url=http://hibernate.org/orm/releases/|title=Releases - Hibernate ORM|website=hibernate.org}}

In October 2022, Hibernate ORM 6.1.4 Final was released.{{Cite web |last=Boriero |first=Andrea |title=Hibernate ORM 6.1.4.Final released |url=https://in.relation.to/2022/10/05/hibernate-orm-614-final/ |access-date=2022-10-11 |website=In Relation To |date=5 October 2022 |language=en}}

The Hibernate API is provided in the Java package {{code|org.hibernate}}.{{Cite web|url=https://docs.jboss.org/hibernate/stable/core/javadocs/index.html?overview-summary.html|title=Hibernate JavaDocs|website=docs.jboss.org}}

The {{code|org.hibernate.SessionFactory}} interface is the native equivalent version of the JPA's standard {{code|EntityManagerFactory}}.{{sfn|Bauer|King|Gregory|2015}}{{rp|§=2.3|p=26}}

The {{code|org.hibernate.Session}} interface{{Cite web|url=https://docs.jboss.org/hibernate/stable/core/javadocs/org/hibernate/Session.html|title=Session (Hibernate JavaDocs)|website=docs.jboss.org}} represents a Hibernate session, i.e., the main point of the manipulation performed on the database entities. The latter activities include (among the other things) managing the persistence state (transient, persisted, detached{{Clarify|date=June 2011}}) of the objects, fetching the persisted ones from the database and the management of the transaction demarcation{{Clarify|date=June 2011}}.

A {{code|Session}} is intended to last as long as the logical transaction on the database. Due to the latter feature, {{code|Session}} implementations are not expected to be thread safe nor to be used by multiple clients.

The Hibernate software includes the following components:{{cite web|title=Hibernate: Relational Persistence for Java and .NET|url=http://www.hibernate.org/|publisher=JBoss Community}}

• Hibernate ORM (known as Hibernate Core before release 4.1{{cite web|title=Hibernate ORM 4.1.0 Release|date=9 February 2012 |url=http://in.relation.to/Bloggers/HibernateORM410Release|publisher=JBoss Community}}) – the base software for an object–relational mapping solution for Java environments{{cite web|title=HIBERNATE - Relational Persistence for Idiomatic Java|url=http://docs.jboss.org/hibernate/orm/4.1/manual/en-US/html/|publisher=JBoss Community}}
• Hibernate Annotations (merged into Hibernate Core/ORM since version 3.6{{cite web|title=No more hibernate-annotations module|date=5 April 2012 |url=http://in.relation.to/Bloggers/NoMoreHibernateannotationsModule|publisher=JBoss Community}}) – metadata that governs the transformation of data between the object-oriented model and the relational database model according to the JSR 317 Java Persistence API (JPA 2){{cite web|title=Hibernate Annotations|url=http://docs.jboss.org/hibernate/annotations/3.5/reference/en/html_single/|publisher=JBoss Community}}
• Hibernate EntityManager (merged into Hibernate Core/ORM since version 5.2{{cite web|title=hibernate-entitymanager merged into hibernate-core|url=https://github.com/hibernate/hibernate-orm/wiki/Migration-Guide---5.2#hibernate-entitymanager-merged-into-hibernate-core|publisher=JBoss Community}})– together with Hibernate Annotations, a wrapper that implements a JSR 317 Java Persistence API (JPA 2) persistence solution{{cite web|title=Hibernate EntityManager|url=http://docs.jboss.org/hibernate/entitymanager/3.6/reference/en/html_single/|publisher=JBoss Community}}
• Hibernate Envers – auditing and versioning of persistent classes{{cite web|title=Hibernate Envers – Easy Entity Auditing|url=http://docs.jboss.org/hibernate/envers/3.6/reference/en-US/html_single/|publisher=JBoss Community}}
• Hibernate OGM (Object/Grid Mapper) – an extension to store data in a NoSQL store{{cite web|title=Hibernate OGM|url=http://hibernate.org/ogm/|publisher=JBoss Community}}
• Hibernate Shards – horizontal partitioning for multiple relational databases{{cite web|title=Hibernate Shards|url=http://www.hibernate.org/subprojects/shards.html|publisher=JBoss Community}}
• While Hibernate Shards is not compatible with 4.x releases of Hibernate Core, some of the Shards capability was integrated into Core in the 4.0 release
• Hibernate Search – integrates the full text library functionality from Apache Lucene in the Hibernate and JPA model{{cite web|title=Hibernate Search|url=http://www.hibernate.org/search/|publisher=JBoss Community}}
• Hibernate Tools – a set of tools implemented as a suite of Eclipse plugins and Ant tasks included in JBoss Developer Studio{{cite web|title=Hibernate Tools for Eclipse and Ant|url=http://www.hibernate.org/tools/|publisher=JBoss Community}}
• Hibernate Validator – the reference implementation of JSR 303 Bean Validation{{cite web|title=Hibernate Validator|url=http://www.hibernate.org/validator/|publisher=JBoss Community}}{{sfn|Bauer|King|Gregory|2015}}{{rp|§=3.3.2|pp=49–51}}
• Hibernate Metamodel Generator – an annotation processor that creates JSR 317 Java Persistence API (JPA 2) static metamodel classes using the JSR 269 Pluggable Annotation Processing API{{cite web|title=Hibernate Metamodel Generator|url=http://www.hibernate.org/subprojects/jpamodelgen.html|publisher=JBoss Community}}
• NHibernate – an object–relational mapping solution for the .NET Framework{{cite web|title=NHibernate|url=http://nhforge.org/|publisher=NHibernate Forge|access-date=2011-04-26|archive-url=https://archive.today/20120712170138/http://nhforge.org/|archive-date=2012-07-12|url-status=dead}}

{{Portal|Free and open-source software|Computer programming}}

• List of JBoss software
• List of object–relational mapping software
• NHibernate
• Serialization
• Service Data Object
• MySQL
• Apache Cassandra
• Spring Framework
• MyBatis

{{reflist|35em}}

{{Refbegin|35em}}

• {{citation

|first1 = Ananda

|last1 = Linwood

|first2 = Dave

|last2 = Minter

|date = May 28, 2010

|title = Beginning Hibernate

|edition = Second

|publisher = Apress

|pages = 400

|isbn = 978-1-4302-2850-9

|url = http://www.apress.com/book/view/9781430228509

|access-date = September 4, 2010

|archive-url = https://web.archive.org/web/20101205163340/http://www.apress.com/book/view/9781430228509

|archive-date = December 5, 2010

|url-status = dead

}}

• {{citation

| first1 = Emmanuel

| last1 = Bernard

| first2 = John

| last2 = Griffin

| date = December 30, 2008

| title = Hibernate Search in Action

| edition = First

| publisher = Manning Publications

| pages = 488

| isbn = 978-1-933988-64-1

| url =

}}

• {{citation

|first1 = James

|last1 = Elliott

|first2 = Tim

|last2 = O'Brien

|date = April 22, 2008

|title = Harnessing Hibernate

|edition = First

|publisher = O'Reilly Media

|pages = 380

|isbn = 978-0-596-51772-4

|url = http://oreilly.com/catalog/9780596517724/

}}

• {{cite book | last1=Bauer | first1=Christian | last2=King | first2=Gavin | last3=Gregory | first3=Gary | title=Java Persistence with Hibernate | publisher=Manning Publications | date=November 8, 2015 | isbn=978-1-61729-045-9}}
• {{citation

|first1 = Jeff

|last1 = Linwood

|first2 = Dave

|last2 = Minter

|date = August 25, 2006

|title = Beginning Hibernate: From Novice to Professional

|edition = Third

|publisher = Apress

|pages = 360

|isbn = 1-59059-693-5

|url = http://www.apress.com/book/view/9781590596937

|access-date = April 24, 2009

|archive-url = https://web.archive.org/web/20101224001209/http://www.apress.com/book/view/9781590596937

|archive-date = December 24, 2010

|url-status = dead

}}

• {{citation

|first1 = Dave

|last1 = Minter

|first2 = Jeff

|last2 = Linwood

|date = June 27, 2005

|title = Pro Hibernate 3

|edition = First

|publisher = Apress

|pages = [https://archive.org/details/prohibernate30000mint/page/242 242]

|isbn = 1-59059-511-4

|url = https://archive.org/details/prohibernate30000mint/page/242

}}

• {{citation

| first = Will

| last = Iverson

| date = December 2, 2004

| title = Hibernate: A J2EE Developer's Guide

| edition = First

| publisher = Addison Wesley

| pages = [https://archive.org/details/hibernatej2eedev0000iver/page/384 384]

| isbn = 0-321-26819-9

| url = https://archive.org/details/hibernatej2eedev0000iver/page/384

}}

• {{citation

|first1 = Eric

|last1 = Pugh

|first2 = Joseph D.

|last2 = Gradecki

|date = October 8, 2004

|title = Professional Hibernate (Programmer to Programmer)

|edition = First

|publisher = Wrox

|pages = 456

|isbn = 0-7645-7677-1

|url = http://p2p.wrox.com/book-professional-hibernate-148/

|access-date = April 26, 2009

|archive-date = April 4, 2009

|archive-url = https://web.archive.org/web/20090404004432/http://p2p.wrox.com/book-professional-hibernate-148/

|url-status = dead

}}

• {{citation

|last1 = Bauer

|first1 = Christian

|last2 = King

|first2 = Gavin

|date = August 1, 2004

|title = Hibernate In Action

|edition = Second

|publisher = Manning Publications

|pages = [https://archive.org/details/hibernateinactio00baue/page/400 400]

|isbn = 1-932394-15-X

|url = https://archive.org/details/hibernateinactio00baue/page/400

}}

• {{citation

|first = Elliott

|last = James

|date = May 10, 2004

|title = Hibernate: A Developer's Notebook

|edition = First

|publisher = O'Reilly Media

|pages = [https://archive.org/details/hibernatedevelop00elli/page/190 190]

|isbn = 0-596-00696-9

|url = https://archive.org/details/hibernatedevelop00elli/page/190

}}

{{Refend}}

• {{Official website|https://hibernate.org/}}
• {{GitHub|hibernate}}

{{Jakarta Persistence}}

{{Java (software platform)}}

{{Authority control}}

Category:Object–relational mapping

Category:Java enterprise platform

Category:Red Hat software

Category:Persistence frameworks

Category:Software using the GNU Lesser General Public License

Category:Cross-platform free software