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`	Deprecated. (since 5.4) Use `GraphSemantic.FETCH`'s `GraphSemantic.getJpaHintName()` instead
`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`	Deprecated. (since 5.4) Use `GraphSemantic.LOAD`'s `GraphSemantic.getJpaHintName()` instead
`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_JAKARTA_JPA`	Apply a JPA query timeout, which is defined in milliseconds.
`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
  - TIMEOUT_JAKARTA_JPA
```
public static final java.lang.String TIMEOUT_JAKARTA_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
```
@Deprecated
public static final java.lang.String FETCHGRAPH
```
    Deprecated.
    (since 5.4) Use GraphSemantic.FETCH's GraphSemantic.getJpaHintName() instead
    
    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.
  - LOADGRAPH
```
@Deprecated
public static final java.lang.String LOADGRAPH
```
    Deprecated.
    (since 5.4) Use GraphSemantic.LOAD's GraphSemantic.getJpaHintName() instead
    
    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
  - 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 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

Class QueryHints

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CACHE_MODE

CACHE_REGION

CACHEABLE

CALLABLE

COMMENT

FETCH_SIZE

FLUSH_MODE

READ_ONLY

TIMEOUT_HIBERNATE

TIMEOUT_JPA

TIMEOUT_JAKARTA_JPA

NATIVE_LOCKMODE

FETCHGRAPH

LOADGRAPH

FOLLOW_ON_LOCKING

PASS_DISTINCT_THROUGH

NATIVE_SPACES