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

lightly reword javadoc for a setting

This commit is contained in:
Gavin King 2023-07-24 14:27:19 +02:00
parent aacf2af486
commit 1d54f179b2
1 changed files with 15 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
hibernate-core/src/main/java/org/hibernate/cfg/AvailableSettings.java
View File

@ -2414,19 +2414,24 @@ public interface AvailableSettings {
/** /**
* When enabled, specifies that {@linkplain org.hibernate.query.Query queries} * When enabled, specifies that {@linkplain org.hibernate.query.Query queries}
* created through {@link jakarta.persistence.EntityManager#createQuery(CriteriaQuery)}, * created via {@link jakarta.persistence.EntityManager#createQuery(CriteriaQuery)},
* {@link jakarta.persistence.EntityManager#createQuery(CriteriaUpdate)} or * {@link jakarta.persistence.EntityManager#createQuery(CriteriaUpdate)} or
* {@link jakarta.persistence.EntityManager#createQuery(CriteriaDelete)} * {@link jakarta.persistence.EntityManager#createQuery(CriteriaDelete)} must
* must create a copy of the passed object such that the resulting {@link jakarta.persistence.Query} * create a copy of the passed criteria query object such that the resulting
* is not affected by any mutations to the original criteria query. * {@link jakarta.persistence.Query} object is not affected by mutation of the
* original {@linkplain CriteriaQuery criteria query}.
* <p> * <p>
* If disabled, it is assumed that users do not mutate the criteria query afterwards * If disabled, it's assumed that the client does not mutate the criteria query
* and due to that, no copy will be created, which will improve performance. * after calling {@code createQuery()}. Thus, in the interest of performance, no
* copy is created.
* <p> * <p>
* When bootstrapping Hibernate through the native bootstrap APIs this setting is disabled * The default behavior depends on how Hibernate is bootstrapped:
* i.e. no copies are created to not hurt performance. * <ul>
* When bootstrapping Hibernate through the JPA SPI this setting is enabled. * <li>When bootstrapping Hibernate through the native bootstrap APIs, this setting
* When enabled, criteria query objects are copied, as required by the Jakarta Persistence specification. * is disabled, that is, no copy of the criteria query object is made.
* <li>When bootstrapping Hibernate through the JPA SPI, this setting is enabled so
* that criteria query objects are copied, as required by the JPA specification.
* </ul>
* *
* @since 6.0 * @since 6.0
*/ */