Hibernate
/
hibernate-orm
mirror of https://github.com/hibernate/hibernate-orm
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

HHH-12082 - Fix some errors and formatting issues in the User Guide

This commit is contained in:
shen dongsheng 2017-11-07 11:11:38 +08:00 committed by Vlad Mihalcea
parent 8530584fad
commit 0b04430fdd
5 changed files with 14 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
documentation/src/main/asciidoc/userguide/chapters/domain/collections.adoc
View File

@ -626,7 +626,7 @@ include::{sourcedir}/type/TimestampEpochType.java[tags=collections-map-custom-ke
----
The `TimestampEpochType` allows us to map a Unix timestamp since epoch to a `java.util.Date`.
But, without the `@MapKeyType` Hibernate annotation, it would nt be possible to customize the `Map` key type.
But, without the `@MapKeyType` Hibernate annotation, it would not be possible to customize the `Map` key type.
[[collections-map-key-class]]
===== Maps having an interface type as the key

2
documentation/src/main/asciidoc/userguide/chapters/jdbc/Database_Access.adoc
View File

@ -121,7 +121,7 @@ Note that Hikari only supports JDBC standard isolation levels (apparently).
[IMPORTANT]
====
The built-in connection pool is not supported supported for use.
The built-in connection pool is not supported for use in a production system.
====
This section is here just for completeness.

2
documentation/src/main/asciidoc/userguide/chapters/pc/PersistenceContext.adoc
View File

@ -326,7 +326,7 @@ include::{extrasdir}/pc-managed-state-dynamic-update-example.sql[]
----
====
The dynamic update allows you to set just the columns sthat were modified in the associated entity.
The dynamic update allows you to set just the columns that were modified in the associated entity.
[[pc-refresh]]
=== Refresh entity state

15
documentation/src/main/asciidoc/userguide/chapters/transactions/Transactions.adoc
View File

@ -162,11 +162,16 @@ See the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hi
It defines a single method, `currentSession()`, by which the implementation is responsible for tracking the current contextual session.
Out-of-the-box, Hibernate comes with three implementations of this interface:
`org.hibernate.context.internal.JTASessionContext`:: current sessions are tracked and scoped by a `JTA` transaction.
The processing here is exactly the same as in the older JTA-only approach. See the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/context/internal/JTASessionContext.html[Javadocs] for more details.
* `org.hibernate.context.internal.ThreadLocalSessionContext`:current sessions are tracked by thread of execution. See the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/context/internal/ThreadLocalSessionContext.html[Javadocs] for more details.
* `org.hibernate.context.internal.ManagedSessionContext`: current sessions are tracked by thread of execution.
However, you are responsible to bind and unbind a `Session` instance with static methods on this class: it does not open, flush, or close a `Session`. See the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/context/internal/ManagedSessionContext.html[Javadocs] for details.
`org.hibernate.context.internal.JTASessionContext`::
current sessions are tracked and scoped by a `JTA` transaction.
The processing here is exactly the same as in the older JTA-only approach.
See the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/context/internal/JTASessionContext.html[Javadocs] for more details.
`org.hibernate.context.internal.ThreadLocalSessionContext`::
current sessions are tracked by thread of execution. See the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/context/internal/ThreadLocalSessionContext.html[Javadocs] for more details.
`org.hibernate.context.internal.ManagedSessionContext`::
current sessions are tracked by thread of execution.
However, you are responsible to bind and unbind a `Session` instance with static methods on this class; it does not open, flush, or close a `Session`.
See the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/context/internal/ManagedSessionContext.html[Javadocs] for details.
Typically, the value of this parameter would just name the implementation class to use.
For the three out-of-the-box implementations, however, there are three corresponding short names: _jta_, _thread_, and _managed_.

2
documentation/src/test/java/org/hibernate/userguide/pc/PersistenceContextTest.java
View File

@ -223,7 +223,7 @@ public class PersistenceContextTest extends BaseEntityManagerFunctionalTestCase
//tag::pc-managed-state-native-example[]
Person person = session.byId( Person.class ).load( personId );
person.setName("John Doe");
entityManager.flush();
session.flush();
//end::pc-managed-state-native-example[]
} );