diff --git a/hibernate-core/src/main/javadoc/overview.html b/hibernate-core/src/main/javadoc/overview.html index a2a4cd710d..9d10f69f7b 100644 --- a/hibernate-core/src/main/javadoc/overview.html +++ b/hibernate-core/src/main/javadoc/overview.html @@ -56,7 +56,7 @@

Note that since Hibernate 5.2, the native API extends the JPA API rather than wrapping it. - For example,SessionFactory extends EntityManagerFactory, and + For example, SessionFactory extends EntityManagerFactory, and Session extends EntityManager.

@@ -75,6 +75,36 @@ The full power of Hibernate can only be unlocked via judicious use of these extra annotations.

+

Bootstrapping Hibernate

+ +

+ There are four basic ways to obtain an instance of Hibernate: +

+ +

+ All major Java application servers and microservice frameworks come with built-in support for + Hibernate. Such container environments also typically feature facilities to automatically + manage the lifecycle of a {@code EntityManager} or {@code Session} and its association with + container-managed transactions. +

+

Popular extension points

@@ -105,6 +135,11 @@ {@link org.hibernate.context.spi} defines support for context-bound "current" sessions and contextual multi-tenancy, + +

+ More advanced extension points include: +

+ +

+ More advanced extension points include: +

+