org.hibernate.engine

Class QueryParameters

java.lang.Object

org.hibernate.engine.QueryParameters

public final class QueryParameters
extends java.lang.Object

Author:

Gavin King

Constructor Summary

Constructors

Constructor and Description
QueryParameters()
QueryParameters(Type[] positionalParameterTypes, java.lang.Object[] postionalParameterValues)
QueryParameters(Type[] positionalParameterTypes, java.lang.Object[] positionalParameterValues, LockOptions lockOptions, RowSelection rowSelection, boolean isReadOnlyInitialized, boolean readOnly, boolean cacheable, java.lang.String cacheRegion, java.lang.String comment, boolean isLookupByNaturalKey, ResultTransformer transformer)
QueryParameters(Type[] positionalParameterTypes, java.lang.Object[] positionalParameterValues, java.util.Map namedParameters, LockOptions lockOptions, RowSelection rowSelection, boolean isReadOnlyInitialized, boolean readOnly, boolean cacheable, java.lang.String cacheRegion, java.lang.String comment, java.io.Serializable[] collectionKeys, java.lang.Object optionalObject, java.lang.String optionalEntityName, java.io.Serializable optionalId, ResultTransformer transformer)
QueryParameters(Type[] positionalParameterTypes, java.lang.Object[] positionalParameterValues, java.util.Map namedParameters, LockOptions lockOptions, RowSelection rowSelection, boolean isReadOnlyInitialized, boolean readOnly, boolean cacheable, java.lang.String cacheRegion, java.lang.String comment, java.io.Serializable[] collectionKeys, ResultTransformer transformer)
QueryParameters(Type[] positionalParameterTypes, java.lang.Object[] postionalParameterValues, java.util.Map namedParameters, java.io.Serializable[] collectionKeys)
QueryParameters(Type[] positionalParameterTypes, java.lang.Object[] postionalParameterValues, java.lang.Object optionalObject, java.lang.String optionalEntityName, java.io.Serializable optionalObjectId)
QueryParameters(Type[] positionalParameterTypes, java.lang.Object[] postionalParameterValues, java.io.Serializable[] collectionKeys)
QueryParameters(Type type, java.lang.Object value)

Method Summary

Methods

Modifier and Type	Method and Description
QueryParameters	createCopyUsing(RowSelection selection)
java.lang.String	getCacheRegion()
java.io.Serializable[]	getCollectionKeys()
java.lang.String	getComment()
Type[]	getFilteredPositionalParameterTypes()
java.lang.Object[]	getFilteredPositionalParameterValues()
java.lang.String	getFilteredSQL()
LockOptions	getLockOptions()
java.util.Map	getNamedParameters()
java.lang.String	getOptionalEntityName()
java.io.Serializable	getOptionalId()
java.lang.Object	getOptionalObject()
Type[]	getPositionalParameterTypes()
java.lang.Object[]	getPositionalParameterValues()
ResultTransformer	getResultTransformer()
RowSelection	getRowSelection()
ScrollMode	getScrollMode()
boolean	hasAutoDiscoverScalarTypes()
boolean	hasRowSelection()
boolean	isCacheable()
boolean	isCallable()
boolean	isNaturalKeyLookup()
boolean	isReadOnly() Should entities and proxies loaded by the Query be put in read-only mode? The read-only/modifiable setting must be initialized via QueryParameters#setReadOnly(boolean) before calling this method.
boolean	isReadOnly(SessionImplementor session) Should entities and proxies loaded by the Query be put in read-only mode? If the read-only/modifiable setting was not initialized (i.e., QueryParameters#isReadOnlyInitialized() == false), then the default read-only/modifiable setting for the persistence context is returned instead.
boolean	isReadOnlyInitialized() Has the read-only/modifiable mode been explicitly set?
void	processFilters(java.lang.String sql, java.util.Map filters, SessionFactoryImplementor factory)
void	processFilters(java.lang.String sql, SessionImplementor session)
void	setAutoDiscoverScalarTypes(boolean autodiscovertypes)
void	setCacheable(boolean b)
void	setCacheRegion(java.lang.String cacheRegion)
void	setCallable(boolean callable)
void	setCollectionKeys(java.io.Serializable[] collectionKeys)
void	setComment(java.lang.String comment)
void	setLockOptions(LockOptions lockOptions)
void	setNamedParameters(java.util.Map map)
void	setNaturalKeyLookup(boolean isNaturalKeyLookup)
void	setOptionalEntityName(java.lang.String optionalEntityName)
void	setOptionalId(java.io.Serializable optionalId)
void	setOptionalObject(java.lang.Object optionalObject)
void	setPositionalParameterTypes(Type[] types)
void	setPositionalParameterValues(java.lang.Object[] objects)
void	setReadOnly(boolean readOnly) Set the read-only/modifiable mode for entities and proxies loaded by the query.
void	setRowSelection(RowSelection selection)
void	setScrollMode(ScrollMode scrollMode)
void	traceParameters(SessionFactoryImplementor factory)
void	validateParameters()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

QueryParameters

public QueryParameters()

QueryParameters

public QueryParameters(Type type,
               java.lang.Object value)

QueryParameters

public QueryParameters(Type[] positionalParameterTypes,
               java.lang.Object[] postionalParameterValues,
               java.lang.Object optionalObject,
               java.lang.String optionalEntityName,
               java.io.Serializable optionalObjectId)

QueryParameters

public QueryParameters(Type[] positionalParameterTypes,
               java.lang.Object[] postionalParameterValues)

QueryParameters

public QueryParameters(Type[] positionalParameterTypes,
               java.lang.Object[] postionalParameterValues,
               java.io.Serializable[] collectionKeys)

QueryParameters

public QueryParameters(Type[] positionalParameterTypes,
               java.lang.Object[] postionalParameterValues,
               java.util.Map namedParameters,
               java.io.Serializable[] collectionKeys)

QueryParameters

public QueryParameters(Type[] positionalParameterTypes,
               java.lang.Object[] positionalParameterValues,
               LockOptions lockOptions,
               RowSelection rowSelection,
               boolean isReadOnlyInitialized,
               boolean readOnly,
               boolean cacheable,
               java.lang.String cacheRegion,
               java.lang.String comment,
               boolean isLookupByNaturalKey,
               ResultTransformer transformer)

QueryParameters

public QueryParameters(Type[] positionalParameterTypes,
               java.lang.Object[] positionalParameterValues,
               java.util.Map namedParameters,
               LockOptions lockOptions,
               RowSelection rowSelection,
               boolean isReadOnlyInitialized,
               boolean readOnly,
               boolean cacheable,
               java.lang.String cacheRegion,
               java.lang.String comment,
               java.io.Serializable[] collectionKeys,
               ResultTransformer transformer)

QueryParameters

public QueryParameters(Type[] positionalParameterTypes,
               java.lang.Object[] positionalParameterValues,
               java.util.Map namedParameters,
               LockOptions lockOptions,
               RowSelection rowSelection,
               boolean isReadOnlyInitialized,
               boolean readOnly,
               boolean cacheable,
               java.lang.String cacheRegion,
               java.lang.String comment,
               java.io.Serializable[] collectionKeys,
               java.lang.Object optionalObject,
               java.lang.String optionalEntityName,
               java.io.Serializable optionalId,
               ResultTransformer transformer)

Method Detail

hasRowSelection

public boolean hasRowSelection()

getNamedParameters

public java.util.Map getNamedParameters()

getPositionalParameterTypes

public Type[] getPositionalParameterTypes()

getPositionalParameterValues

public java.lang.Object[] getPositionalParameterValues()

getRowSelection

public RowSelection getRowSelection()

getResultTransformer

public ResultTransformer getResultTransformer()

setNamedParameters

public void setNamedParameters(java.util.Map map)

setPositionalParameterTypes

public void setPositionalParameterTypes(Type[] types)

setPositionalParameterValues

public void setPositionalParameterValues(java.lang.Object[] objects)

setRowSelection

public void setRowSelection(RowSelection selection)

getLockOptions

public LockOptions getLockOptions()

setLockOptions

public void setLockOptions(LockOptions lockOptions)

traceParameters

public void traceParameters(SessionFactoryImplementor factory)
                     throws HibernateException

Throws:

HibernateException

isCacheable

public boolean isCacheable()

setCacheable

public void setCacheable(boolean b)

getCacheRegion

public java.lang.String getCacheRegion()

setCacheRegion

public void setCacheRegion(java.lang.String cacheRegion)

validateParameters

public void validateParameters()
                        throws QueryException

Throws:

QueryException

getComment

public java.lang.String getComment()

setComment

public void setComment(java.lang.String comment)

getScrollMode

public ScrollMode getScrollMode()

setScrollMode

public void setScrollMode(ScrollMode scrollMode)

getCollectionKeys

public java.io.Serializable[] getCollectionKeys()

setCollectionKeys

public void setCollectionKeys(java.io.Serializable[] collectionKeys)

getOptionalEntityName

public java.lang.String getOptionalEntityName()

setOptionalEntityName

public void setOptionalEntityName(java.lang.String optionalEntityName)

getOptionalId

public java.io.Serializable getOptionalId()

setOptionalId

public void setOptionalId(java.io.Serializable optionalId)

getOptionalObject

public java.lang.Object getOptionalObject()

setOptionalObject

public void setOptionalObject(java.lang.Object optionalObject)

isReadOnlyInitialized

public boolean isReadOnlyInitialized()

Has the read-only/modifiable mode been explicitly set?

Returns:

true, the read-only/modifiable mode was explicitly set false, the read-only/modifiable mode was not explicitly set

See Also:

setReadOnly(boolean), isReadOnly(SessionImplementor)

isReadOnly

public boolean isReadOnly()

Should entities and proxies loaded by the Query be put in read-only mode? The read-only/modifiable setting must be initialized via QueryParameters#setReadOnly(boolean) before calling this method.

Returns:

true, entities and proxies loaded by the Query will be put in read-only mode false, entities and proxies loaded by the Query will be put in modifiable mode

Throws:

java.lang.IllegalStateException - if the read-only/modifiable setting has not been initialized (i.e., isReadOnlyInitialized() == false).

See Also:

isReadOnlyInitialized(), isReadOnly(SessionImplementor), The read-only/modifiable setting has no impact on entities/proxies returned by the query that existed in the session before the query was executed.

isReadOnly

public boolean isReadOnly(SessionImplementor session)

Should entities and proxies loaded by the Query be put in read-only mode? If the read-only/modifiable setting was not initialized (i.e., QueryParameters#isReadOnlyInitialized() == false), then the default read-only/modifiable setting for the persistence context is returned instead.

Returns:

true, entities and proxies loaded by the query will be put in read-only mode false, entities and proxies loaded by the query will be put in modifiable mode

See Also:

isReadOnlyInitialized(), setReadOnly(boolean), The read-only/modifiable setting has no impact on entities/proxies returned by the query that existed in the session before the query was executed.

setReadOnly

public void setReadOnly(boolean readOnly)

Set the read-only/modifiable mode for entities and proxies loaded by the query. *

See Also:

isReadOnlyInitialized(), isReadOnly(SessionImplementor), setReadOnly(boolean), The read-only/modifiable setting has no impact on entities/proxies returned by the query that existed in the session before the query was executed.

setCallable

public void setCallable(boolean callable)

isCallable

public boolean isCallable()

hasAutoDiscoverScalarTypes

public boolean hasAutoDiscoverScalarTypes()

processFilters

public void processFilters(java.lang.String sql,
                  SessionImplementor session)

processFilters

public void processFilters(java.lang.String sql,
                  java.util.Map filters,
                  SessionFactoryImplementor factory)

getFilteredSQL

public java.lang.String getFilteredSQL()

getFilteredPositionalParameterValues

public java.lang.Object[] getFilteredPositionalParameterValues()

getFilteredPositionalParameterTypes

public Type[] getFilteredPositionalParameterTypes()

isNaturalKeyLookup

public boolean isNaturalKeyLookup()

setNaturalKeyLookup

public void setNaturalKeyLookup(boolean isNaturalKeyLookup)

setAutoDiscoverScalarTypes

public void setAutoDiscoverScalarTypes(boolean autodiscovertypes)

createCopyUsing

public QueryParameters createCopyUsing(RowSelection selection)