Package org.hibernate.query

Interface QueryProducer

All Known Subinterfaces:

EventSource, HibernateEntityManager, QueryProducerImplementor, Session, SessionImplementor, SharedSessionContract, SharedSessionContractImplementor, StatelessSession

All Known Implementing Classes:

SessionDelegatorBaseImpl

public interface QueryProducer

Contract for things that can produce Query instances. Expected implementors include Session and StatelessSession.

It defines these query creation methods in the signature defined by EntityManager. In a way it defines a subset of the EntityManager contract to be reused by both Session and StatelessSession.

Method Summary

Modifier and Type	Method	Description
Query	createNamedQuery(String name)	The JPA-defined named query creation method.
<R> Query<R>	createNamedQuery(String name, Class<R> resultClass)	The JPA-defined named, typed query creation method.
NativeQuery	createNativeQuery(String sqlString)	Create a NativeQuery instance for the given native (SQL) query
<R> NativeQuery<R>	createNativeQuery(String sqlString, Class<R> resultClass)	Create a NativeQuery instance for the given native (SQL) query using implicit mapping to the specified Java type.
NativeQuery	createNativeQuery(String sqlString, String resultSetMappingName)	Create a NativeQuery instance for the given native (SQL) query using implicit mapping to the specified Java type.
Query	createQuery(CriteriaDelete<?> deleteQuery)	Create a Query for the given JPA CriteriaDelete
<R> Query<R>	createQuery(CriteriaQuery<R> criteriaQuery)	Create a Query for the given JPA CriteriaQuery
Query	createQuery(CriteriaUpdate<?> updateQuery)	Create a Query for the given JPA CriteriaUpdate
Query	createQuery(String queryString)	Create a Query instance for the given HQL/JPQL query string.
<R> Query<R>	createQuery(String queryString, Class<R> resultClass)	Create a typed Query instance for the given HQL/JPQL query string.
NativeQuery	getNamedNativeQuery(String name)	Get a NativeQuery instance for a named native SQL query
NativeQuery	getNamedNativeQuery(String name, String resultSetMapping)	Get a NativeQuery instance for a named native SQL query
Query	getNamedQuery(String queryName)	Create a Query instance for the named query.

Method Detail

getNamedQuery

Query getNamedQuery(String queryName)

Create a Query instance for the named query.

Parameters:

queryName - the name of a pre-defined, named query

Returns:

The Query instance for manipulation and execution

Throws:

IllegalArgumentException - if a query has not been defined with the given name or if the query string is found to be invalid

createQuery

Query createQuery(String queryString)

Create a Query instance for the given HQL/JPQL query string.

Parameters:

queryString - The HQL/JPQL query

Returns:

The Query instance for manipulation and execution

See Also:

EntityManager.createQuery(String)

createQuery

<R> Query<R> createQuery(String queryString,
                         Class<R> resultClass)

Create a typed Query instance for the given HQL/JPQL query string.

Parameters:

queryString - The HQL/JPQL query

resultClass - The type of the query result

Returns:

The Query instance for manipulation and execution

See Also:

EntityManager.createQuery(String,Class)

createNamedQuery

Query createNamedQuery(String name)

The JPA-defined named query creation method. This form can represent an HQL/JPQL query or a native query.

Parameters:

name - the name of a pre-defined, named query

Returns:

The Query instance for manipulation and execution

Throws:

IllegalArgumentException - if a query has not been defined with the given name or if the query string is found to be invalid

See Also:

EntityManager.createNamedQuery(String)

createNamedQuery

<R> Query<R> createNamedQuery(String name,
                              Class<R> resultClass)

The JPA-defined named, typed query creation method. This form can only represent an HQL/JPQL query (not a native query).

Parameters:

name - the name of a query defined in metadata

resultClass - the type of the query result

Returns:

The Query instance for manipulation and execution

Throws:

IllegalArgumentException - if a query has not been defined with the given name or if the query string is found to be invalid or if the query result is found to not be assignable to the specified type

See Also:

EntityManager.createNamedQuery(String,Class)

createNativeQuery

NativeQuery createNativeQuery(String sqlString)

Create a NativeQuery instance for the given native (SQL) query

Parameters:

sqlString - a native SQL query string

Returns:

The NativeQuery instance for manipulation and execution

See Also:

EntityManager.createNativeQuery(String)

createNativeQuery

<R> NativeQuery<R> createNativeQuery(String sqlString,
                                     Class<R> resultClass)

Create a NativeQuery instance for the given native (SQL) query using implicit mapping to the specified Java type.

Parameters:

sqlString - Native (SQL) query string

resultClass - The Java entity type to map results to

Returns:

The NativeQuery instance for manipulation and execution

See Also:

EntityManager.createNativeQuery(String,Class)

createNativeQuery

NativeQuery createNativeQuery(String sqlString,
                              String resultSetMappingName)

Create a NativeQuery instance for the given native (SQL) query using implicit mapping to the specified Java type.

Parameters:

sqlString - Native (SQL) query string

resultSetMappingName - The explicit result mapping name

Returns:

The NativeQuery instance for manipulation and execution

See Also:

EntityManager.createNativeQuery(String,Class), SqlResultSetMapping

getNamedNativeQuery

NativeQuery getNamedNativeQuery(String name)

Get a NativeQuery instance for a named native SQL query

Parameters:

name - The name of the pre-defined query

Returns:

The NativeQuery instance for manipulation and execution

getNamedNativeQuery

NativeQuery getNamedNativeQuery(String name,
                                String resultSetMapping)

Get a NativeQuery instance for a named native SQL query

Parameters:

name - The name of the pre-defined query

Returns:

The NativeQuery instance for manipulation and execution

createQuery

<R> Query<R> createQuery(CriteriaQuery<R> criteriaQuery)

Create a Query for the given JPA CriteriaQuery

See Also:

EntityManager.createQuery(CriteriaQuery)

createQuery

Query createQuery(CriteriaUpdate<?> updateQuery)

Create a Query for the given JPA CriteriaUpdate

See Also:

EntityManager.createQuery(CriteriaUpdate)

createQuery

Query createQuery(CriteriaDelete<?> deleteQuery)

Create a Query for the given JPA CriteriaDelete

See Also:

EntityManager.createQuery(CriteriaDelete)