Skip to content

[HHH-18993] modify the user guide in documentation. #9521

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
+3 −4
Open

[HHH-18993] modify the user guide in documentation. #9521

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion documentation/src/main/asciidoc/userguide/chapters/locking/Locking.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ To artificially increase the version number, see the documentation for propertie

[NOTE]
====
If the version number is generated by the database, such as a trigger, use the annotation `@org.hibernate.annotations.Generated(GenerationTime.ALWAYS)` on the version attribute.
If the version number is generated by the database, such as a trigger, implement a custom generator by extending the `OnExecutionGenerator` interface, and apply it to the version attribute using a custom annotation.
====

[[locking-optimistic-timestamp]]
Expand Down
3 changes: 1 addition & 2 deletions documentation/src/main/asciidoc/userguide/chapters/pc/BytecodeEnhancement.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,8 +41,7 @@ which means that accessing `accountsPayableXrefId` will not force the loading of

[NOTE]
====
As a hopefully temporary legacy hold-over, it is currently required that all lazy singular associations (many-to-one and one-to-one) also include `@LazyToOne(LazyToOneOption.NO_PROXY)`.
The plan is to relax that requirement later.
For existing codebases, it is recommended to remove usages of @LazyToOne, such as `@LazyToOne(LazyToOneOption.NO_PROXY)`, and instead rely on default lazy loading behavior or explicitly configure fetch strategies using `@OneToOne` or `@ManyToOne` annotations with `fetch = FetchType.LAZY` where necessary, such as `@OneToOne(fetch = FetchType.LAZY)`.
====

[[BytecodeEnhancement-dirty-tracking]]
Expand Down
2 changes: 1 addition & 1 deletion documentation/src/main/asciidoc/userguide/chapters/pc/PersistenceContext.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -229,7 +229,7 @@ strategy so that we can load entities from the second-level cache, therefore ski
`withBatchSize(int batchSize)`::
This setting allows you to specify a batch size for loading the entities (e.g. how many at a time).
+
The default is to use a batch sizing strategy defined by the `Dialect.getDefaultBatchLoadSizingStrategy()` method.
The default is to use a batch sizing strategy defined by the `Dialect.getBatchLoadSizingStrategy()` method.
+
Any greater-than-one value here will override that default behavior.
`with(RootGraph<T> graph)`::
Expand Down