2010-10-12 16:41:27 -04:00
|
|
|
<!--
|
|
|
|
|
~ Hibernate, Relational Persistence for Idiomatic Java
|
|
|
|
|
~
|
2015-05-19 00:23:35 -04:00
|
|
|
~ License: GNU Lesser General Public License (LGPL), version 2.1 or later.
|
|
|
|
|
~ See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
|
2010-10-12 16:41:27 -04:00
|
|
|
-->
|
|
|
|
|
<body>
|
|
|
|
|
|
2013-04-15 10:50:33 -04:00
|
|
|
<h2>Hibernate O/RM JavaDocs (aggregated)</h2>
|
2010-10-12 16:41:27 -04:00
|
|
|
|
|
|
|
|
Hibernate provides both<ul>
|
|
|
|
|
<li>
|
2011-12-16 15:26:52 -05:00
|
|
|
a native API comprised centrally around {@link org.hibernate.SessionFactory} and {@link org.hibernate.Session}
|
2010-10-12 16:41:27 -04:00
|
|
|
</li>
|
|
|
|
|
<li>
|
2013-04-15 10:50:33 -04:00
|
|
|
an implementation of the Java Persistence API (JPA)
|
2012-07-12 10:33:36 -04:00
|
|
|
specification comprised centrally around {@link org.hibernate.jpa.internal.EntityManagerFactoryImpl} and
|
|
|
|
|
{@link org.hibernate.jpa.internal.EntityManagerImpl} (the Hibernate implementations of
|
2013-04-15 10:50:33 -04:00
|
|
|
{@link javax.persistence.EntityManager} and {@link javax.persistence.EntityManagerFactory}, respectively).
|
|
|
|
|
See the latest <a href="http://jcp.org/en/jsr/detail?id=338">JPA JSR</a> for details.
|
2010-10-12 16:41:27 -04:00
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<hr/>
|
|
|
|
|
|
|
|
|
|
<h3>Native API</h3>
|
2011-12-16 15:26:52 -05:00
|
|
|
In addition to SessionFactory and Session, applications using the native API will often utilize the following
|
|
|
|
|
interfaces:<ul>
|
2010-10-12 16:41:27 -04:00
|
|
|
<li>{@link org.hibernate.cfg.Configuration}</li>
|
|
|
|
|
<li>{@link org.hibernate.Transaction}</li>
|
|
|
|
|
<li>{@link org.hibernate.Query}</li>
|
|
|
|
|
<li>{@link org.hibernate.Criteria}</li>
|
|
|
|
|
<li>{@link org.hibernate.criterion.Projection}</li>
|
|
|
|
|
<li>{@link org.hibernate.criterion.Projections}</li>
|
|
|
|
|
<li>{@link org.hibernate.criterion.Criterion}</li>
|
|
|
|
|
<li>{@link org.hibernate.criterion.Restrictions}</li>
|
|
|
|
|
<li>{@link org.hibernate.criterion.Order}</li>
|
|
|
|
|
<li>{@link org.hibernate.criterion.Example}</li>
|
|
|
|
|
</ul>
|
|
|
|
|
These interfaces are fully intended to be exposed to application code.
|
2012-01-13 14:04:32 -05:00
|
|
|
<p></p>
|
2010-10-12 16:41:27 -04:00
|
|
|
<hr/>
|
|
|
|
|
|
|
|
|
|
<h3>JPA</h3>
|
|
|
|
|
The JPA interfaces are all defined by the JPA specification. For details see {@link javax.persistence}
|
2012-01-13 14:04:32 -05:00
|
|
|
<p></p>
|
2010-10-12 16:41:27 -04:00
|
|
|
<hr/>
|
|
|
|
|
|
2011-12-16 15:26:52 -05:00
|
|
|
<h3>Package Groups</h3>
|
|
|
|
|
This documentation groups packages into the following 3 categories:<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<strong>API</strong> - classes to which application code will generally bind directly.
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<strong>SPI</strong> - classes to which application developers or integrators will commonly bind directly in
|
|
|
|
|
order to develop extensions to Hibernate, or to alter its behavior in some way.
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<strong>Internal</strong> - classes which are intended only to be used by Hibernate. Use of these classes
|
|
|
|
|
outside of Hibernate specific use cases is not supported. Moreover, these contracts can change frequently
|
|
|
|
|
between releases whereas APIs and SPIs are more stable.
|
|
|
|
|
</li>
|
2010-10-12 16:41:27 -04:00
|
|
|
</ul>
|
2012-01-13 14:04:32 -05:00
|
|
|
Additionally, we highlight a 4th category <strong>Testing Support</strong> which is a set of classes useful for building
|
|
|
|
|
Hibernate test cases.
|
|
|
|
|
<p></p>
|
2010-10-12 16:41:27 -04:00
|
|
|
<hr/>
|
|
|
|
|
|
2011-12-16 15:26:52 -05:00
|
|
|
Complete Hibernate documentation may be found online at <a href="http://docs.jboss.org/hibernate/">http://docs.jboss.org/hibernate/</a>
|
2010-10-12 16:41:27 -04:00
|
|
|
|
|
|
|
|
</body>
|
