Hibernate documentation is organized into several guides that cover specific topics. This guide provides links to all the guides to give some direction on where to look for information.
This is still very much a work in progress. Help is definitely welcome! |
User Guides
-
For information on bootstrapping Hibernate
-
For bootstrapping a SessionFactory, see the Native Bootstrapping Guide
-
For bootstrapping a Hibernate EntityManagerFactory (JPA), see the JPA Bootstrapping Guide
-
For (semi-deprecated) bootstrapping of a SessionFactory using the legacy Configuration approach, see the Legacy Bootstrapping Guide
-
-
For information on generated (non-identifier) values, see the Generated Values Guide
-
For information on logging, see Logging Guide
-
For information on how to use the latest version of Hibernate ORM on WildFly, see Using Hibernate ORM on Wildfly
-
Others coming soon
Tooling
-
See the Metamodel Generator Guide for details on generating a JPA "Static Metamodel"
-
see the Bytecode Enhancement Guide for information on bytecode enhancement
-
Guide on the Gradle plugin coming soon
-
Guide on the Ant tasks coming soon
-
Guide on the Maven plugin coming soon
Integrator Guides
-
The Service Registries Guide discusses Hibernate Service and ServiceRegistry contracts.
-
Providers of custom
SessionFactory
implementations should see Custom SessionFactory and Session Implementations Guide -
Others coming soon
Helping
-
These "topical guides" are developed using Asciidoctor. Meanwhile the legacy Hibernate reference manuals are written in DocBook. The conversion of knowledge into the "topical guide" format will take time and is an ongoing process. A huge way to help would be to create topical guide(s) and pull over the relevant information from the corresponding reference information. See the Jira task for a list of ideas
-
Reporting/fixing problems. Report any typos or inaccurate information to the Hibernate ORM Jira using the documentation component. Follow the same guidelines for contributing fixes and improvements as for contributing source code.