Package org.hibernate.annotations

Class QueryHints

java.lang.Object

org.hibernate.annotations.QueryHints

public class QueryHints
extends java.lang.Object

Consolidation of hints available to Hibernate JPA queries. Mainly used to define features available on Hibernate queries that have no corollary in JPA queries.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	CACHE_MODE	The cache mode to use.
static java.lang.String	CACHE_REGION	The cache region to use.
static java.lang.String	CACHEABLE	Are the query results cacheable?
static java.lang.String	CALLABLE	Is the query callable? Note: only valid for named native sql queries.
static java.lang.String	COMMENT	Defines a comment to be applied to the SQL sent to the database.
static java.lang.String	FETCH_SIZE	Defines the JDBC fetch size to use.
static java.lang.String	FETCHGRAPH	Hint providing a "fetchgraph" EntityGraph.
static java.lang.String	FLUSH_MODE	The flush mode to associate with the execution of the query.
static java.lang.String	FOLLOW_ON_LOCKING	Hint to enable/disable the follow-on-locking mechanism provided by Dialect.useFollowOnLocking(QueryParameters).
static java.lang.String	LOADGRAPH	Hint providing a "loadgraph" EntityGraph.
static java.lang.String	NATIVE_LOCKMODE	Available to apply lock mode to a native SQL query since JPA requires that Query.setLockMode(javax.persistence.LockModeType) throw an IllegalStateException if called for a native query.
static java.lang.String	NATIVE_SPACES	Hint for specifying query spaces to be applied to a native (SQL) query.
static java.lang.String	PASS_DISTINCT_THROUGH	Hint to enable/disable the pass-distinct-through mechanism.
static java.lang.String	READ_ONLY	Should entities returned from the query be set in read only mode?
static java.lang.String	TIMEOUT_HIBERNATE	Apply a Hibernate query timeout, which is defined in seconds.
static java.lang.String	TIMEOUT_JPA	Apply a JPA query timeout, which is defined in milliseconds.

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CACHE_MODE

public static final java.lang.String CACHE_MODE

The cache mode to use.

See Also:

Query.setCacheMode(org.hibernate.CacheMode), SQLQuery.setCacheMode(org.hibernate.CacheMode), Constant Field Values

CACHE_REGION

public static final java.lang.String CACHE_REGION

The cache region to use.

See Also:

Query.setCacheRegion(java.lang.String), SQLQuery.setCacheRegion(java.lang.String), Constant Field Values

CACHEABLE

public static final java.lang.String CACHEABLE

Are the query results cacheable?

See Also:

Query.setCacheable(boolean), SQLQuery.setCacheable(boolean), Constant Field Values

CALLABLE

public static final java.lang.String CALLABLE

Is the query callable? Note: only valid for named native sql queries.

See Also:

Constant Field Values

COMMENT

public static final java.lang.String COMMENT

Defines a comment to be applied to the SQL sent to the database.

See Also:

Query.setComment(java.lang.String), SQLQuery.setComment(java.lang.String), Constant Field Values

FETCH_SIZE

public static final java.lang.String FETCH_SIZE

Defines the JDBC fetch size to use.

See Also:

Query.setFetchSize(int), SQLQuery.setFetchSize(int), Constant Field Values

FLUSH_MODE

public static final java.lang.String FLUSH_MODE

The flush mode to associate with the execution of the query.

See Also:

Query.setFlushMode(org.hibernate.FlushMode), SQLQuery.setFlushMode(javax.persistence.FlushModeType), Session.setFlushMode(org.hibernate.FlushMode), Constant Field Values

READ_ONLY

public static final java.lang.String READ_ONLY

Should entities returned from the query be set in read only mode?

See Also:

Query.setReadOnly(boolean), SQLQuery.setReadOnly(boolean), Session.setReadOnly(java.lang.Object, boolean), Constant Field Values

TIMEOUT_HIBERNATE

public static final java.lang.String TIMEOUT_HIBERNATE

Apply a Hibernate query timeout, which is defined in seconds.

See Also:

Query.setTimeout(int), SQLQuery.setTimeout(int), Constant Field Values

TIMEOUT_JPA

public static final java.lang.String TIMEOUT_JPA

Apply a JPA query timeout, which is defined in milliseconds.

See Also:

Constant Field Values

NATIVE_LOCKMODE

public static final java.lang.String NATIVE_LOCKMODE

Available to apply lock mode to a native SQL query since JPA requires that Query.setLockMode(javax.persistence.LockModeType) throw an IllegalStateException if called for a native query.

Accepts a LockModeType or a LockMode

See Also:

Constant Field Values

FETCHGRAPH

public static final java.lang.String FETCHGRAPH

Hint providing a "fetchgraph" EntityGraph. Attributes explicitly specified as AttributeNodes are treated as FetchType.EAGER (via join fetch or subsequent select). Note: Currently, attributes that are not specified are treated as FetchType.LAZY or FetchType.EAGER depending on the attribute's definition in metadata, rather than forcing FetchType.LAZY.

See Also:

Constant Field Values

LOADGRAPH

public static final java.lang.String LOADGRAPH

Hint providing a "loadgraph" EntityGraph. Attributes explicitly specified as AttributeNodes are treated as FetchType.EAGER (via join fetch or subsequent select). Attributes that are not specified are treated as FetchType.LAZY or FetchType.EAGER depending on the attribute's definition in metadata

See Also:

Constant Field Values

FOLLOW_ON_LOCKING

public static final java.lang.String FOLLOW_ON_LOCKING

Hint to enable/disable the follow-on-locking mechanism provided by Dialect.useFollowOnLocking(QueryParameters). A value of true enables follow-on-locking, whereas a value of false disables it. If the value is null, the the Dialect strategy is going to be used instead.

Since:

5.2

See Also:

Constant Field Values

PASS_DISTINCT_THROUGH

public static final java.lang.String PASS_DISTINCT_THROUGH

Hint to enable/disable the pass-distinct-through mechanism. A value of true enables pass-distinct-through, whereas a value of false disables it. When the pass-distinct-through is disabled, the HQL and JPQL distinct clause is no longer passed to the SQL statement.

Since:

5.2

See Also:

Constant Field Values

NATIVE_SPACES

public static final java.lang.String NATIVE_SPACES

Hint for specifying query spaces to be applied to a native (SQL) query. Passed value can be any of:

• List of the spaces
• array of the spaces
• String "whitespace"-separated list of the spaces

See Also:

SynchronizeableQuery, Constant Field Values