org.hibernate.annotations

Class QueryHints

java.lang.Object

org.hibernate.annotations.QueryHints

public class QueryHints
extends 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 String	CACHE_MODE The cache mode to use.
static String	CACHE_REGION The cache region to use.
static String	CACHEABLE Are the query results cacheable?
static String	CALLABLE Is the query callable? Note: only valid for named native sql queries.
static String	COMMENT Defines a comment to be applied to the SQL sent to the database.
static String	FETCH_SIZE Defines the JDBC fetch size to use.
static String	FETCHGRAPH Hint providing a "fetchgraph" EntityGraph.
static String	FLUSH_MODE The flush mode to associate with the execution of the query.
static String	LOADGRAPH Hint providing a "loadgraph" EntityGraph.
static 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 String	READ_ONLY Should entities returned from the query be set in read only mode?
static String	TIMEOUT_HIBERNATE Apply a Hibernate query timeout, which is defined in seconds.
static 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 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 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 String CACHEABLE

Are the query results cacheable?

See Also:

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

CALLABLE

public static final String CALLABLE

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

See Also:

Constant Field Values

COMMENT

public static final 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 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 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 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 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 String TIMEOUT_JPA

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

See Also:

Constant Field Values

NATIVE_LOCKMODE

public static final 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 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 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