Query (hibernate-core JavaDocs)

All Classes

Summary:
Nested |
Field |
Constr |
Method

Detail:
Field |
Constr |
Method

All Superinterfaces:

BasicQueryContract, CommonQueryContract, Query, TypedQuery<R>

All Known Subinterfaces:

NativeQuery<T>, NativeQueryImplementor<T>, ProcedureCallImplementor<R>, Query<R>, QueryImplementor<R>, SQLQuery<T>

Deprecated.
(since 5.2) use Query instead
```
@Deprecated
public interface Query<R>
extends TypedQuery<R>, CommonQueryContract
```
Represents an HQL/JPQL query or a compiled Criteria query

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`Query<R>`	`addQueryHint(String hint)` Deprecated. Add a DB query hint to the SQL.
`Type`	`determineProperBooleanType(int position, Object value, Type defaultType)` Deprecated. added only to allow default method definition for deprecated methods here.
`Type`	`determineProperBooleanType(String name, Object value, Type defaultType)` Deprecated. added only to allow default method definition for deprecated methods here.
`CacheMode`	`getCacheMode()` Deprecated. Obtain the CacheMode in effect for this query.
`String`	`getCacheRegion()` Deprecated. Obtain the name of the second level query cache region in which query results will be stored (if they are cached, see the discussion on `isCacheable()` for more information).
`String`	`getComment()` Deprecated. Obtain the comment currently associated with this query.
`Integer`	`getFetchSize()` Deprecated. Obtain the JDBC fetch size hint in effect for this query.
`FlushModeType`	`getFlushMode()` Deprecated. For users of the Hibernate native APIs, we’ve had to rename this method as defined by Hibernate historically because the JPA contract defines a method of the same name, but returning the JPA `FlushModeType` rather than Hibernate’s `FlushMode`.
`FlushMode`	`getHibernateFlushMode()` Deprecated. Obtain the FlushMode in effect for this query.
`LockOptions`	`getLockOptions()` Deprecated. Obtains the LockOptions in effect for this query.
`String[]`	`getNamedParameters()` Deprecated. (since 5.2) use `ParameterMetadata.getNamedParameterNames()`
`ParameterMetadata`	`getParameterMetadata()` Deprecated. Access to information about query parameters.
`String`	`getQueryString()` Deprecated. Get the query string.
`String[]`	`getReturnAliases()` Deprecated. (since 5.2) use `Tuple` if you need access to "result variables".
`Type[]`	`getReturnTypes()` Deprecated. (since 5.2) with no replacement; to be removed in 6.0
`Integer`	`getTimeout()` Deprecated. Obtain the query timeout <b>in seconds</b>.
`boolean`	`isCacheable()` Deprecated. Are the results of this query eligible for second level query caching? This is different that second level caching of any returned entities and collections.
`boolean`	`isReadOnly()` Deprecated. Should entities and proxies loaded by this Query be put in read-only mode? If the read-only/modifiable setting was not initialized, then the default read-only/modifiable setting for the persistence context is returned instead.
`Iterator<R>`	`iterate()` Deprecated. Return the query results as an <tt>Iterator</tt>.
`List<R>`	`list()` Deprecated. Return the query results as a <tt>List</tt>.
`ScrollableResults`	`scroll()` Deprecated. Return the query results as <tt>ScrollableResults</tt>.
`ScrollableResults`	`scroll(ScrollMode scrollMode)` Deprecated. Return the query results as ScrollableResults.
`default Query<R>`	`setBigDecimal(int position, BigDecimal val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setBigDecimal(String name, BigDecimal val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setBigInteger(int position, BigInteger val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setBigInteger(String name, BigInteger val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setBinary(int position, byte[] val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setBinary(String name, byte[] val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setBoolean(int position, boolean val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setBoolean(String name, boolean val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setByte(int position, byte val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setByte(String name, byte val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`Query<R>`	`setCacheable(boolean cacheable)` Deprecated. Enable/disable second level query (result) caching for this query.
`Query<R>`	`setCacheMode(CacheMode cacheMode)` Deprecated. (Re)set the current CacheMode in effect for this query.
`Query<R>`	`setCacheRegion(String cacheRegion)` Deprecated. Set the name of the cache region where query results should be cached (if cached at all).
`default Query<R>`	`setCalendar(int position, Calendar val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setCalendar(String name, Calendar value)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setCalendarDate(int position, Calendar val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setCalendarDate(String name, Calendar value)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setCharacter(int position, char val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setCharacter(String name, char val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`Query<R>`	`setComment(String comment)` Deprecated. Set the comment for this query.
`default Query<R>`	`setDate(int position, Date val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setDate(String name, Date val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setDouble(int position, double val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setDouble(String name, double val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`Query<R>`	`setEntity(int position, Object val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`Query<R>`	`setEntity(String name, Object val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`Query<R>`	`setFetchSize(int fetchSize)` Deprecated. Sets a JDBC fetch size hint for the query.
`Query<R>`	`setFirstResult(int startPosition)` Deprecated.
`default Query<R>`	`setFloat(int position, float val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setFloat(String name, float val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`Query<R>`	`setFlushMode(FlushMode flushMode)` Deprecated. (since 5.2) use `setHibernateFlushMode(org.hibernate.FlushMode)` instead
`Query<R>`	`setFlushMode(FlushModeType flushMode)` Deprecated.
`default Query<R>`	`setHibernateFlushMode(FlushMode flushMode)` Deprecated. (Re)set the current FlushMode in effect for this query.
`Query<R>`	`setHint(String hintName, Object value)` Deprecated.
`default Query<R>`	`setInteger(int position, int val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setInteger(String name, int val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setLocale(int position, Locale val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setLocale(String name, Locale val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`Query<R>`	`setLockMode(LockModeType lockMode)` Deprecated.
`Query<R>`	`setLockMode(String alias, LockMode lockMode)` Deprecated. Set the LockMode to use for specific alias (as defined in the query’s <tt>FROM</tt> clause).
`Query<R>`	`setLockOptions(LockOptions lockOptions)` Deprecated. Set the lock options for the query.
`default Query<R>`	`setLong(int position, long val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setLong(String name, long val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`Query<R>`	`setMaxResults(int maxResult)` Deprecated.
`Query<R>`	`setParameter(int position, Calendar value, TemporalType temporalType)` Deprecated.
`Query<R>`	`setParameter(int position, Date value, TemporalType temporalType)` Deprecated.
`Query<R>`	`setParameter(int position, Object val)` Deprecated. Bind a positional query parameter using its inferred Type.
`Query<R>`	`setParameter(int position, Object val, Type type)` Deprecated. Bind a value to a JDBC-style query parameter.
`<P> Query<R>`	`setParameter(int position, P val, TemporalType temporalType)` Deprecated. Bind a positional query parameter as some form of date/time using the indicated temporal-type.
`Query<R>`	`setParameter(Parameter<Calendar> param, Calendar value, TemporalType temporalType)` Deprecated.
`Query<R>`	`setParameter(Parameter<Date> param, Date value, TemporalType temporalType)` Deprecated.
`<T> Query<R>`	`setParameter(Parameter<T> param, T value)` Deprecated.
`<P> Query<R>`	`setParameter(QueryParameter<P> parameter, P val, TemporalType temporalType)` Deprecated. Bind a query parameter as some form of date/time using the indicated temporal-type.
`<P> Query<R>`	`setParameter(QueryParameter<P> parameter, P val, Type type)` Deprecated. Bind a query parameter using the supplied Type
`<T> Query<R>`	`setParameter(QueryParameter<T> parameter, T val)` Deprecated. Bind a query parameter using its inferred Type.
`Query<R>`	`setParameter(String name, Calendar value, TemporalType temporalType)` Deprecated.
`Query<R>`	`setParameter(String name, Date value, TemporalType temporalType)` Deprecated.
`Query<R>`	`setParameter(String name, Object val)` Deprecated. Bind a named query parameter using its inferred Type.
`Query<R>`	`setParameter(String name, Object val, Type type)` Deprecated. Bind a named query parameter using the supplied Type
`<P> Query<R>`	`setParameter(String name, P val, TemporalType temporalType)` Deprecated. Bind a named query parameter as some form of date/time using the indicated temporal-type.
`Query<R>`	`setParameterList(int position, Collection values)` Deprecated.
`Query<R>`	`setParameterList(int position, Collection values, Type type)` Deprecated.
`Query<R>`	`setParameterList(int position, Object[] values)` Deprecated.
`Query<R>`	`setParameterList(int position, Object[] values, Type type)` Deprecated.
`<P> Query<R>`	`setParameterList(QueryParameter<P> parameter, Collection<P> values)` Deprecated. Bind multiple values to a query parameter using its inferred Type.
`Query<R>`	`setParameterList(String name, Collection values)` Deprecated. Bind multiple values to a named query parameter.
`Query<R>`	`setParameterList(String name, Collection values, Type type)` Deprecated. Bind multiple values to a named query parameter.
`Query<R>`	`setParameterList(String name, Object[] values)` Deprecated. Bind multiple values to a named query parameter.
`Query<R>`	`setParameterList(String name, Object[] values, Type type)` Deprecated. Bind multiple values to a named query parameter.
`default Query<R>`	`setParameters(Object[] values, Type[] types)` Deprecated. (since 5.2) Bind values individually
`Query<R>`	`setProperties(Map bean)` Deprecated. Bind the values of the given Map for each named parameters of the query, matching key names with parameter names and mapping value types to Hibernate types using heuristics.
`Query<R>`	`setProperties(Object bean)` Deprecated. Bind the property values of the given bean to named parameters of the query, matching property names with parameter names and mapping property types to Hibernate types using heuristics.
`Query<R>`	`setReadOnly(boolean readOnly)` Deprecated. Set the read-only/modifiable mode for entities and proxies loaded by this Query.
`Query<R>`	`setResultTransformer(ResultTransformer transformer)` Deprecated. (since 5.2)
`default Query<R>`	`setSerializable(int position, Serializable val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setSerializable(String name, Serializable val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setShort(int position, short val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setShort(String name, short val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setString(int position, String val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setString(String name, String val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setText(int position, String val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setText(String name, String val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setTime(int position, Date val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setTime(String name, Date val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`Query<R>`	`setTimeout(int timeout)` Deprecated. Set the query timeout <b>in seconds</b>.
`default Query<R>`	`setTimestamp(int position, Date val)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`default Query<R>`	`setTimestamp(String name, Date value)` Deprecated. (since 5.2) use `setParameter(int, Object)` or `setParameter(int, Object, Type)` instead
`R`	`uniqueResult()` Deprecated. Convenience method to return a single instance that matches the query, or `null` if the query returns no results.

Methods inherited from interface javax.persistence.TypedQuery
getResultList, getResultStream, getSingleResult

Methods inherited from interface javax.persistence.Query
executeUpdate, getFirstResult, getHints, getLockMode, getMaxResults, getParameter, getParameter, getParameter, getParameter, getParameters, getParameterValue, getParameterValue, getParameterValue, isBound, unwrap

Method Detail

getQueryString
```
String getQueryString()
```
Deprecated.

Get the query string.

Returns:

the query string

getHibernateFlushMode
```
FlushMode getHibernateFlushMode()
```
Deprecated.

Obtain the FlushMode in effect for this query. By default, the query inherits the FlushMode of the Session from which it originates.

Specified by:

getHibernateFlushMode in interface BasicQueryContract

Returns:

The query FlushMode.

See Also:

FlushMode

setHibernateFlushMode
```
default Query<R> setHibernateFlushMode(FlushMode flushMode)
```
Deprecated.

(Re)set the current FlushMode in effect for this query.

Specified by:

setHibernateFlushMode in interface BasicQueryContract

Parameters:

flushMode - The new FlushMode to use.

Returns:

this, for method chaining

See Also:

getHibernateFlushMode()

setFlushMode
```
@Deprecated
Query<R> setFlushMode(FlushMode flushMode)
```
Deprecated. (since 5.2) use setHibernateFlushMode(org.hibernate.FlushMode) instead

(Re)set the current FlushMode in effect for this query.

Specified by:

setFlushMode in interface BasicQueryContract

Parameters:

flushMode - The new FlushMode to use.

Returns:

this, for method chaining

See Also:

getHibernateFlushMode()

getFlushMode
```
FlushModeType getFlushMode()
```
Deprecated.

For users of the Hibernate native APIs, we’ve had to rename this method as defined by Hibernate historically because the JPA contract defines a method of the same name, but returning the JPA FlushModeType rather than Hibernate’s FlushMode. For the former behavior, use Query.getHibernateFlushMode() instead.

Specified by:

getFlushMode in interface Query

Returns:

The FlushModeType in effect for this query.

getCacheMode
```
CacheMode getCacheMode()
```
Deprecated.

Obtain the CacheMode in effect for this query. By default, the query inherits the CacheMode of the Session from which is originates.

Note
The CacheMode here only effects reading/writing of the query cache, not the entity/collection caches.

Specified by:

getCacheMode in interface BasicQueryContract

Returns:

The query CacheMode.

See Also:

Session.getCacheMode(), CacheMode

setCacheMode
```
Query<R> setCacheMode(CacheMode cacheMode)
```
Deprecated.

(Re)set the current CacheMode in effect for this query.

Specified by:

setCacheMode in interface BasicQueryContract

Parameters:

cacheMode - The new CacheMode to use.

Returns:

this, for method chaining

See Also:

getCacheMode()

isCacheable

boolean isCacheable()

Deprecated.

Are the results of this query eligible for second level query caching? This is different that second level caching of any returned entities and collections.

Note	the query being "eligible" for caching does not necessarily mean its results will be cached. Second level query caching still has to be enabled on the `SessionFactory` for this to happen. Usually that is controlled by the `hibernate.cache.use_query_cache` configuration setting.

Specified by:: isCacheable in interface BasicQueryContract
Returns:: true if the query results are eligible for caching, false otherwise.
See Also:: AvailableSettings.USE_QUERY_CACHE

setCacheable
```
Query<R> setCacheable(boolean cacheable)
```
Deprecated.

Enable/disable second level query (result) caching for this query.

Specified by:

setCacheable in interface BasicQueryContract

Parameters:

cacheable - Should the query results be cacheable?

Returns:

this, for method chaining

See Also:

isCacheable()

getCacheRegion
```
String getCacheRegion()
```
Deprecated.

Obtain the name of the second level query cache region in which query results will be stored (if they are cached, see the discussion on isCacheable() for more information). null indicates that the default region should be used.

Specified by:

getCacheRegion in interface BasicQueryContract

Returns:

The specified cache region name into which query results should be placed; null indicates the default region.

setCacheRegion
```
Query<R> setCacheRegion(String cacheRegion)
```
Deprecated.

Set the name of the cache region where query results should be cached (if cached at all).

Specified by:

setCacheRegion in interface BasicQueryContract

Parameters:

cacheRegion - the name of a query cache region, or null to indicate that the default region should be used.

Returns:

this, for method chaining

See Also:

getCacheRegion()

getTimeout
```
Integer getTimeout()
```
Deprecated.

Obtain the query timeout in seconds. This value is eventually passed along to the JDBC query via Statement.setQueryTimeout(int). Zero indicates no timeout.

Specified by:

getTimeout in interface BasicQueryContract

Returns:

The timeout in seconds

See Also:

Statement.getQueryTimeout(), Statement.setQueryTimeout(int)

setTimeout
```
Query<R> setTimeout(int timeout)
```
Deprecated.

Set the query timeout in seconds.

NOTE it is important to understand that any value set here is eventually passed directly through to the JDBC Statement which expressly disallows negative values. So negative values should be avoided as a general rule.

Specified by:

setTimeout in interface BasicQueryContract

Parameters:

timeout - the timeout in seconds

Returns:

this, for method chaining

See Also:

getTimeout()

getFetchSize
```
Integer getFetchSize()
```
Deprecated.

Obtain the JDBC fetch size hint in effect for this query. This value is eventually passed along to the JDBC query via Statement.setFetchSize(int). As defined b y JDBC, this value is a hint to the driver to indicate how many rows to fetch from the database when more rows are needed.

NOTE : JDBC expressly defines this value as a hint. It may or may not have any effect on the actual query execution and ResultSet processing depending on the driver.

Specified by:

getFetchSize in interface BasicQueryContract

Returns:

The timeout in seconds

See Also:

Statement.getFetchSize(), Statement.setFetchSize(int)

setFetchSize
```
Query<R> setFetchSize(int fetchSize)
```
Deprecated.

Sets a JDBC fetch size hint for the query.

Specified by:

setFetchSize in interface BasicQueryContract

Parameters:

fetchSize - the fetch size hint

Returns:

this, for method chaining

See Also:

getFetchSize()

isReadOnly
```
boolean isReadOnly()
```
Deprecated.

Should entities and proxies loaded by this Query be put in read-only mode? If the read-only/modifiable setting was not initialized, then the default read-only/modifiable setting for the persistence context is returned instead.

Specified by:

isReadOnly in interface BasicQueryContract

Returns:

true if the entities and proxies loaded by the query will be put in read-only mode; false otherwise (they will be modifiable)

See Also:

setReadOnly(boolean), PersistenceContext.isDefaultReadOnly()

setReadOnly
```
Query<R> setReadOnly(boolean readOnly)
```
Deprecated.

Set the read-only/modifiable mode for entities and proxies loaded by this Query. This setting overrides the default setting for the persistence context.

Specified by:

setReadOnly in interface BasicQueryContract

Parameters:

readOnly - true indicates that entities and proxies loaded by the query are to be put in read-only mode; false indicates that entities and proxies loaded by the query will be put in modifiable mode

Returns:

this, for method chaining

See Also:

PersistenceContext.isDefaultReadOnly(), PersistenceContext.setDefaultReadOnly(boolean), Session.setDefaultReadOnly(boolean)

getReturnTypes
```
@Deprecated
Type[] getReturnTypes()
```
Deprecated. (since 5.2) with no replacement; to be removed in 6.0

Return the Hibernate types of the query results.

Specified by:

getReturnTypes in interface BasicQueryContract

Returns:

an array of types

getLockOptions
```
LockOptions getLockOptions()
```
Deprecated.

Obtains the LockOptions in effect for this query.

Returns:

The LockOptions

See Also:

LockOptions

setLockOptions
```
Query<R> setLockOptions(LockOptions lockOptions)
```
Deprecated.

Set the lock options for the query. Specifically only the following are taken into consideration:<ol> <li>LockOptions.getLockMode()</li> <li>LockOptions.getScope()</li> <li>LockOptions.getTimeOut()</li> </ol> For alias-specific locking, use setLockMode(String, LockMode).

Parameters:

lockOptions - The lock options to apply to the query.

Returns:

this, for method chaining

See Also:

getLockOptions()

setLockMode
```
Query<R> setLockMode(String alias,
 LockMode lockMode)
```
Deprecated.

Set the LockMode to use for specific alias (as defined in the query’s <tt>FROM</tt> clause).

The alias-specific lock modes specified here are added to the query’s internal LockOptions.

The effect of these alias-specific LockModes is somewhat dependent on the driver/database in use. Generally speaking, for maximum portability, this method should only be used to mark that the rows corresponding to the given alias should be included in pessimistic locking (LockMode.PESSIMISTIC_WRITE).

Parameters:

alias - a query alias, or "this" for a collection filter

lockMode - The lock mode to apply.

Returns:

this, for method chaining

See Also:

getLockOptions()

getComment
```
String getComment()
```
Deprecated.

Obtain the comment currently associated with this query. Provided SQL commenting is enabled (generally by enabling the hibernate.use_sql_comments config setting), this comment will also be added to the SQL query sent to the database. Often useful for identifying the source of troublesome queries on the database side.

Returns:

The comment.

setComment
```
Query<R> setComment(String comment)
```
Deprecated.

Set the comment for this query.

Parameters:

comment - The human-readable comment

Returns:

this, for method chaining

See Also:

getComment()

addQueryHint
```
Query<R> addQueryHint(String hint)
```
Deprecated.

Add a DB query hint to the SQL. These differ from JPA’s QueryHint, which is specific to the JPA implementation and ignores DB vendor-specific hints. Instead, these are intended solely for the vendor-specific hints, such as Oracle’s optimizers. Multiple query hints are supported; the Dialect will determine concatenation and placement.

Parameters:

hint - The database specific query hint to add.

iterate
```
Iterator<R> iterate()
```
Deprecated.

Return the query results as an <tt>Iterator</tt>. If the query contains multiple results per row, the results are returned in an instance of <tt>Object[]</tt>. Entities returned as results are initialized on demand. The first SQL query returns identifiers only. 

Returns:

the result iterator

scroll
```
ScrollableResults scroll()
```
Deprecated.

Return the query results as <tt>ScrollableResults</tt>. The scrollability of the returned results depends upon JDBC driver support for scrollable <tt>ResultSet</tt>s.



You should call ScrollableResults.close() after processing the <tt>ScrollableResults</tt> so that the underlying resources are deallocated right away.

Returns:

the result iterator

See Also:

ScrollableResults

scroll
```
ScrollableResults scroll(ScrollMode scrollMode)
```
Deprecated.

Return the query results as ScrollableResults. The scrollability of the returned results depends upon JDBC driver support for scrollable ResultSets.



You should call ScrollableResults.close() after processing the <tt>ScrollableResults</tt> so that the underlying resources are deallocated right away.

Parameters:

scrollMode - The scroll mode

Returns:

the result iterator

See Also:

ScrollableResults, ScrollMode

list
```
List<R> list()
```
Deprecated.

Return the query results as a <tt>List</tt>. If the query contains multiple results per row, the results are returned in an instance of <tt>Object[]</tt>.

Returns:

the result list

uniqueResult
```
R uniqueResult()
```
Deprecated.

Convenience method to return a single instance that matches the query, or null if the query returns no results.

Returns:

the single result or <tt>null</tt>

Throws:

NonUniqueResultException - if there is more than one matching result

getParameterMetadata
```
ParameterMetadata getParameterMetadata()
```
Deprecated.

Access to information about query parameters.

Returns:

information about query parameters.

getNamedParameters
```
@Deprecated
String[] getNamedParameters()
```
Deprecated. (since 5.2) use ParameterMetadata.getNamedParameterNames()

Return the names of all named parameters of the query.

Returns:

the parameter names, in no particular order

setParameter
```
<T> Query<R> setParameter(QueryParameter<T> parameter,
 T val)
```
Deprecated.

Bind a query parameter using its inferred Type. If the parameter is defined in such a way that the Type cannot be inferred from its usage context then use of this form of binding is not allowed, and setParameter(QueryParameter, Object, Type) should be used instead

Parameters:

parameter - The query parameter memento

val - the possibly-null parameter value

Returns:

this, for method chaining

setParameter
```
<T> Query<R> setParameter(Parameter<T> param,
 T value)
```
Deprecated.

Specified by:

setParameter in interface Query

Specified by:

setParameter in interface TypedQuery<R>

setParameter
```
Query<R> setParameter(String name,
 Object val)
```
Deprecated.

Bind a named query parameter using its inferred Type. If the parameter is defined in such a way that the Type cannot be inferred from its usage context then use of this form of binding is not allowed, and setParameter(String, Object, Type) should be used instead

Specified by:

setParameter in interface Query

Specified by:

setParameter in interface TypedQuery<R>

Parameters:

name - the parameter name

val - the (possibly-null) parameter value

Returns:

this, for method chaining

setParameter
```
Query<R> setParameter(int position,
 Object val)
```
Deprecated.

Bind a positional query parameter using its inferred Type. If the parameter is defined in such a way that the Type cannot be inferred from its usage context then use of this form of binding is not allowed, and setParameter(int, Object, Type) should be used instead

Specified by:

setParameter in interface Query

Specified by:

setParameter in interface TypedQuery<R>

Parameters:

position - the position of the parameter in the query string, numbered from <tt>0</tt>.

val - the possibly-null parameter value

Returns:

this, for method chaining

setParameter
```
 Query<R> setParameter(QueryParameter parameter,
 P val,
 Type type)
```
Deprecated.

Bind a query parameter using the supplied Type

Parameters:

parameter - The query parameter memento

val - the possibly-null parameter value

type - the Hibernate type

Returns:

this, for method chaining

setParameter
```
Query<R> setParameter(String name,
 Object val,
 Type type)
```
Deprecated.

Bind a named query parameter using the supplied Type

Parameters:

name - the name of the parameter

val - the possibly-null parameter value

type - the Hibernate type

Returns:

this, for method chaining

setParameter
```
Query<R> setParameter(int position,
 Object val,
 Type type)
```
Deprecated.

Bind a value to a JDBC-style query parameter.

Parameters:

position - the position of the parameter in the query string, numbered from <tt>0</tt>.

val - the possibly-null parameter value

type - the Hibernate type

Returns:

this, for method chaining

setParameter
```
 Query<R> setParameter(QueryParameter parameter,
 P val,
 TemporalType temporalType)
```
Deprecated.

Bind a query parameter as some form of date/time using the indicated temporal-type.

Parameters:

parameter - The query parameter memento

val - the possibly-null parameter value

temporalType - the temporal-type to use in binding the date/time

Returns:

this, for method chaining

setParameter
```
 Query<R> setParameter(String name,
 P val,
 TemporalType temporalType)
```
Deprecated.

Bind a named query parameter as some form of date/time using the indicated temporal-type.

Parameters:

name - the parameter name

val - the possibly-null parameter value

temporalType - the temporal-type to use in binding the date/time

Returns:

this, for method chaining

setParameter
```
 Query<R> setParameter(int position,
 P val,
 TemporalType temporalType)
```
Deprecated.

Bind a positional query parameter as some form of date/time using the indicated temporal-type.

Parameters:

position - the position of the parameter in the query string, numbered from <tt>0</tt>.

val - the possibly-null parameter value

temporalType - the temporal-type to use in binding the date/time

Returns:

this, for method chaining

setParameterList
```
 Query<R> setParameterList(QueryParameter parameter,
 Collection values)
```
Deprecated.

Bind multiple values to a query parameter using its inferred Type. The Hibernate type of the parameter values is first detected via the usage/position in the query and if not sufficient secondly guessed from the class of the first object in the collection. This is useful for binding a list of values to an expression such as <tt>foo.bar in (:value_list)</tt>.

Parameters:

parameter - the parameter memento

values - a collection of values to list

Returns:

this, for method chaining

setParameterList
```
Query<R> setParameterList(String name,
 Collection values)
```
Deprecated.

Bind multiple values to a named query parameter. The Hibernate type of the parameter is first detected via the usage/position in the query and if not sufficient secondly guessed from the class of the first object in the collection. This is useful for binding a list of values to an expression such as <tt>foo.bar in (:value_list)</tt>.

Parameters:

name - the name of the parameter

values - a collection of values to list

Returns:

this, for method chaining

setParameterList

Query<R> setParameterList(int position,
                          Collection values)

Deprecated.

setParameterList
```
Query<R> setParameterList(String name,
 Collection values,
 Type type)
```
Deprecated.

Bind multiple values to a named query parameter. This is useful for binding a list of values to an expression such as <tt>foo.bar in (:value_list)</tt>.

Parameters:

name - the name of the parameter

values - a collection of values to list

type - the Hibernate type of the values

Returns:

this, for method chaining

setParameterList

Query<R> setParameterList(int position,
                          Collection values,
                          Type type)

Deprecated.

setParameterList
```
Query<R> setParameterList(String name,
 Object[] values,
 Type type)
```
Deprecated.

Bind multiple values to a named query parameter. This is useful for binding a list of values to an expression such as <tt>foo.bar in (:value_list)</tt>.

Parameters:

name - the name of the parameter

values - a collection of values to list

type - the Hibernate type of the values

Returns:

this, for method chaining

setParameterList

Query<R> setParameterList(int position,
                          Object[] values,
                          Type type)

Deprecated.

setParameterList
```
Query<R> setParameterList(String name,
 Object[] values)
```
Deprecated.

Bind multiple values to a named query parameter. The Hibernate type of the parameter is first detected via the usage/position in the query and if not sufficient secondly guessed from the class of the first object in the array. This is useful for binding a list of values to an expression such as <tt>foo.bar in (:value_list)</tt>.

Parameters:

name - the name of the parameter

values - a collection of values to list

Returns:

this, for method chaining

setParameterList

Query<R> setParameterList(int position,
                          Object[] values)

Deprecated.

setProperties
```
Query<R> setProperties(Object bean)
```
Deprecated.

Bind the property values of the given bean to named parameters of the query, matching property names with parameter names and mapping property types to Hibernate types using heuristics.

Parameters:

bean - any JavaBean or POJO

Returns:

this, for method chaining

setProperties
```
Query<R> setProperties(Map bean)
```
Deprecated.

Bind the values of the given Map for each named parameters of the query, matching key names with parameter names and mapping value types to Hibernate types using heuristics.

Parameters:

bean - a java.util.Map

Returns:

this, for method chaining

setMaxResults
```
Query<R> setMaxResults(int maxResult)
```
Deprecated.

Specified by:

setMaxResults in interface Query

Specified by:

setMaxResults in interface TypedQuery<R>

setFirstResult
```
Query<R> setFirstResult(int startPosition)
```
Deprecated.

Specified by:

setFirstResult in interface Query

Specified by:

setFirstResult in interface TypedQuery<R>

setHint
```
Query<R> setHint(String hintName,
 Object value)
```
Deprecated.

Specified by:

setHint in interface Query

Specified by:

setHint in interface TypedQuery<R>

setParameter

Query<R> setParameter(Parameter<Calendar> param,
                      Calendar value,
                      TemporalType temporalType)

Deprecated.

Specified by:: setParameter in interface Query
Specified by:: setParameter in interface TypedQuery<R>

setParameter

Query<R> setParameter(Parameter<Date> param,
                      Date value,
                      TemporalType temporalType)

Deprecated.

Specified by:: setParameter in interface Query
Specified by:: setParameter in interface TypedQuery<R>

setParameter

Query<R> setParameter(String name,
                      Calendar value,
                      TemporalType temporalType)

Deprecated.

Specified by:: setParameter in interface Query
Specified by:: setParameter in interface TypedQuery<R>

setParameter

Query<R> setParameter(String name,
                      Date value,
                      TemporalType temporalType)

Deprecated.

Specified by:: setParameter in interface Query
Specified by:: setParameter in interface TypedQuery<R>

setParameter

Query<R> setParameter(int position,
                      Calendar value,
                      TemporalType temporalType)

Deprecated.

Specified by:: setParameter in interface Query
Specified by:: setParameter in interface TypedQuery<R>

setParameter

Query<R> setParameter(int position,
                      Date value,
                      TemporalType temporalType)

Deprecated.

Specified by:: setParameter in interface Query
Specified by:: setParameter in interface TypedQuery<R>

setFlushMode
```
Query<R> setFlushMode(FlushModeType flushMode)
```
Deprecated.

Specified by:

setFlushMode in interface Query

Specified by:

setFlushMode in interface TypedQuery<R>

setLockMode
```
Query<R> setLockMode(LockModeType lockMode)
```
Deprecated.

Specified by:

setLockMode in interface Query

Specified by:

setLockMode in interface TypedQuery<R>

setString
```
@Deprecated
default Query<R> setString(int position,
 String val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional String-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setCharacter
```
@Deprecated
default Query<R> setCharacter(int position,
 char val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional char-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setBoolean
```
@Deprecated
default Query<R> setBoolean(int position,
 boolean val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional boolean-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setByte
```
@Deprecated
default Query<R> setByte(int position,
 byte val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional byte-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setShort
```
@Deprecated
default Query<R> setShort(int position,
 short val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional short-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setInteger
```
@Deprecated
default Query<R> setInteger(int position,
 int val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional int-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setLong
```
@Deprecated
default Query<R> setLong(int position,
 long val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional long-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setFloat
```
@Deprecated
default Query<R> setFloat(int position,
 float val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional float-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setDouble
```
@Deprecated
default Query<R> setDouble(int position,
 double val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional double-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setBinary
```
@Deprecated
default Query<R> setBinary(int position,
 byte[] val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional binary-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setText
```
@Deprecated
default Query<R> setText(int position,
 String val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional String-valued parameter using streaming.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setSerializable
```
@Deprecated
default Query<R> setSerializable(int position,
 Serializable val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional binary-valued parameter using serialization.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setLocale
```
@Deprecated
default Query<R> setLocale(int position,
 Locale val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional Locale-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setBigDecimal
```
@Deprecated
default Query<R> setBigDecimal(int position,
 BigDecimal val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional BigDecimal-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setBigInteger
```
@Deprecated
default Query<R> setBigInteger(int position,
 BigInteger val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional BigDecimal-valued parameter.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setDate
```
@Deprecated
default Query<R> setDate(int position,
 Date val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional Date-valued parameter using just the Date portion.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setTime
```
@Deprecated
default Query<R> setTime(int position,
 Date val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional Date-valued parameter using just the Time portion.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setTimestamp
```
@Deprecated
default Query<R> setTimestamp(int position,
 Date val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional Date-valued parameter using the full Timestamp.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setCalendar
```
@Deprecated
default Query<R> setCalendar(int position,
 Calendar val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional Calendar-valued parameter using the full Timestamp portion.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setCalendarDate
```
@Deprecated
default Query<R> setCalendarDate(int position,
 Calendar val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a positional Calendar-valued parameter using just the Date portion.

Parameters:

position - The parameter position

val - The bind value

Returns:

this, for method chaining

setString
```
@Deprecated
default Query<R> setString(String name,
 String val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named String-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setCharacter
```
@Deprecated
default Query<R> setCharacter(String name,
 char val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named char-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setBoolean
```
@Deprecated
default Query<R> setBoolean(String name,
 boolean val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named boolean-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setByte
```
@Deprecated
default Query<R> setByte(String name,
 byte val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named byte-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setShort
```
@Deprecated
default Query<R> setShort(String name,
 short val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named short-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setInteger
```
@Deprecated
default Query<R> setInteger(String name,
 int val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named int-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setLong
```
@Deprecated
default Query<R> setLong(String name,
 long val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named long-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setFloat
```
@Deprecated
default Query<R> setFloat(String name,
 float val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named float-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setDouble
```
@Deprecated
default Query<R> setDouble(String name,
 double val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named double-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setBinary
```
@Deprecated
default Query<R> setBinary(String name,
 byte[] val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named binary-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setText
```
@Deprecated
default Query<R> setText(String name,
 String val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named String-valued parameter using streaming.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setSerializable
```
@Deprecated
default Query<R> setSerializable(String name,
 Serializable val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named binary-valued parameter using serialization.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setLocale
```
@Deprecated
default Query<R> setLocale(String name,
 Locale val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named Locale-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setBigDecimal
```
@Deprecated
default Query<R> setBigDecimal(String name,
 BigDecimal val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named BigDecimal-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setBigInteger
```
@Deprecated
default Query<R> setBigInteger(String name,
 BigInteger val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named BigInteger-valued parameter.

Parameters:

name - The parameter name

val - The bind value

Returns:

this, for method chaining

setDate
```
@Deprecated
default Query<R> setDate(String name,
 Date val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind the val (time is truncated) of a given Date object to a named query parameter.

Parameters:

name - The name of the parameter

val - The val object

Returns:

this, for method chaining

setTime
```
@Deprecated
default Query<R> setTime(String name,
 Date val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind the time (val is truncated) of a given Date object to a named query parameter.

Parameters:

name - The name of the parameter

val - The val object

Returns:

this, for method chaining

setTimestamp
```
@Deprecated
default Query<R> setTimestamp(String name,
 Date value)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind the value and the time of a given Date object to a named query parameter.

Parameters:

name - The name of the parameter

value - The value object

Returns:

this, for method chaining

setCalendar
```
@Deprecated
default Query<R> setCalendar(String name,
 Calendar value)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named Calendar-valued parameter using the full Timestamp.

Parameters:

name - The parameter name

value - The bind value

Returns:

this, for method chaining

setCalendarDate
```
@Deprecated
default Query<R> setCalendarDate(String name,
 Calendar value)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind a named Calendar-valued parameter using just the Date portion.

Parameters:

name - The parameter name

value - The bind value

Returns:

this, for method chaining

setEntity
```
@Deprecated
Query<R> setEntity(int position,
 Object val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind an instance of a mapped persistent class to a JDBC-style query parameter. Use setParameter(int, Object) for null values.

Parameters:

position - the position of the parameter in the query string, numbered from <tt>0</tt>.

val - a non-null instance of a persistent class

Returns:

this, for method chaining

setEntity
```
@Deprecated
Query<R> setEntity(String name,
 Object val)
```
Deprecated. (since 5.2) use setParameter(int, Object) or setParameter(int, Object, Type) instead

Bind an instance of a mapped persistent class to a named query parameter. Use setParameter(String, Object) for null values.

Parameters:

name - the name of the parameter

val - a non-null instance of a persistent class

Returns:

this, for method chaining

determineProperBooleanType

@Deprecated
Type determineProperBooleanType(int position,
                                            Object value,
                                            Type defaultType)

Deprecated. added only to allow default method definition for deprecated methods here.

determineProperBooleanType

@Deprecated
Type determineProperBooleanType(String name,
                                            Object value,
                                            Type defaultType)

Deprecated. added only to allow default method definition for deprecated methods here.

setResultTransformer
```
@Deprecated
Query<R> setResultTransformer(ResultTransformer transformer)
```
Deprecated. (since 5.2)

Set a strategy for handling the query results. This can be used to change "shape" of the query result.

Parameters:

transformer - The transformer to apply

Returns:

this (for method chaining)

getReturnAliases
```
@Deprecated
String[] getReturnAliases()
```
Deprecated. (since 5.2) use Tuple if you need access to "result variables".

setParameters
```
@Deprecated
default Query<R> setParameters(Object[] values,
 Type[] types)
```
Deprecated. (since 5.2) Bind values individually

Bind values and types to positional parameters. Allows binding more than one at a time; no real performance impact.

The number of elements in each array should match. That is, element number-0 in types array corresponds to element-0 in the values array, etc,

Parameters:

types - The types

values - The values

Returns:

this, for method chaining

Skip navigation links

All Classes

Summary:
Nested |
Field |
Constr |
Method

Detail:
Field |
Constr |
Method

Interface Query<R>

Method Summary

Methods inherited from interface javax.persistence.TypedQuery

Methods inherited from interface javax.persistence.Query

Method Detail

getQueryString

getHibernateFlushMode

setHibernateFlushMode

setFlushMode

getFlushMode

getCacheMode

setCacheMode

isCacheable

setCacheable

getCacheRegion

setCacheRegion

getTimeout

setTimeout

getFetchSize

setFetchSize

isReadOnly

setReadOnly

getReturnTypes

getLockOptions

setLockOptions

setLockMode

getComment

setComment

addQueryHint

iterate

scroll

scroll

list

uniqueResult

getParameterMetadata

getNamedParameters

setParameter

setParameter

setParameter

setParameter

setParameter

setParameter

setParameter

setParameter

setParameter

setParameter

setParameterList

setParameterList

setParameterList

setParameterList

setParameterList

setParameterList

setParameterList

setParameterList

setParameterList

setProperties

setProperties

setMaxResults

setFirstResult

setHint

setParameter

setParameter

setParameter

setParameter

setParameter

setParameter

setFlushMode

setLockMode

setString

setCharacter

setBoolean

setByte

setShort

setInteger

setLong

setFloat

setDouble

setBinary

setText

setSerializable