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 and 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	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	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), Query.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), Query.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), Query.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), Query.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), Query.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), Query.setFlushMode(org.hibernate.FlushMode), 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), Query.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), Query.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