Top Fields Constructors Methods
org.hibernate.engine

public final Class QueryParameters

extends Object
Class Inheritance
Imports
java.io.Serializable, java.util.ArrayList, .Collection, .Iterator, .List, .Map, .StringTokenizer, org.slf4j.Logger, .LoggerFactory, org.hibernate.HibernateException, .QueryException, .ScrollMode, .LockOptions, org.hibernate.impl.FilterImpl, org.hibernate.dialect.Dialect, org.hibernate.hql.classic.ParserHelper, org.hibernate.pretty.Printer, org.hibernate.transform.ResultTransformer, org.hibernate.type.Type, org.hibernate.util.ArrayHelper

Author
Gavin King

Field Summary

Modifier and TypeField and Description
private boolean
private boolean
private String
private boolean
private Serializable[]
private String
private boolean
private boolean
private LockOptions
private static final Logger
private Map<K, V>
private String
private Serializable
private Object
private Type[]
private Object[]
private Type[]
private Object[]
private String
private boolean
private final ResultTransformer
private RowSelection
private ScrollMode

Constructor Summary

AccessConstructor and Description
public
public
public
QueryParameters(final Type[] positionalParameterTypes, final Object[] postionalParameterValues, final Object optionalObject, final String optionalEntityName, final Serializable optionalObjectId)

public
QueryParameters(final Type[] positionalParameterTypes, final Object[] postionalParameterValues)

public
QueryParameters(final Type[] positionalParameterTypes, final Object[] postionalParameterValues, final Serializable[] collectionKeys)

public
QueryParameters(final Type[] positionalParameterTypes, final Object[] postionalParameterValues, final Map<K, V> namedParameters, final Serializable[] collectionKeys)

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

public
QueryParameters(final Type[] positionalParameterTypes, final Object[] positionalParameterValues, final Map<K, V> namedParameters, final LockOptions lockOptions, final RowSelection rowSelection, final boolean isReadOnlyInitialized, final boolean readOnly, final boolean cacheable, final String cacheRegion, final String comment, final Serializable[] collectionKeys, ResultTransformer transformer)

public
QueryParameters(final Type[] positionalParameterTypes, final Object[] positionalParameterValues, final Map<K, V> namedParameters, final LockOptions lockOptions, final RowSelection rowSelection, final boolean isReadOnlyInitialized, final boolean readOnly, final boolean cacheable, final String cacheRegion, final String comment, final Serializable[] collectionKeys, final Object optionalObject, final String optionalEntityName, final Serializable optionalId, final ResultTransformer transformer)

Method Summary

Modifier and TypeMethod and Description
public QueryParameters
public String
public Serializable[]
public String
public Type[]
public Object[]
public String
public LockOptions
public Map<K, V>
public String
public Serializable
public Object
public Type[]
public Object[]
public ResultTransformer
public RowSelection
public ScrollMode
public boolean
public boolean
public boolean
public boolean
public boolean
public boolean

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
isReadOnly
()

Should entities and proxies loaded by the Query be put in read-only mode?

public boolean

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
isReadOnly
(SessionImplementor session)

Should entities and proxies loaded by the Query be put in read-only mode?

public boolean

Returns:

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

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

public void
public void
processFilters(String sql, Map<K, V> filters, SessionFactoryImplementor factory)

public void
setAutoDiscoverScalarTypes(boolean autodiscovertypes)

public void
setCacheable(boolean b)

public void
setCacheRegion(String cacheRegion)

public void
setCallable(boolean callable)

public void
setCollectionKeys(Serializable[] collectionKeys)

public void
setComment(String comment)

public void
public void
public void
setNaturalKeyLookup(boolean isNaturalKeyLookup)

public void
setOptionalEntityName(String optionalEntityName)

public void
public void
setOptionalObject(Object optionalObject)

public void
public void
public void

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
setReadOnly
(boolean readOnly)

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

public void
public void
public void
public void
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

autodiscovertypesback to summary
private boolean autodiscovertypes
cacheableback to summary
private boolean cacheable
cacheRegionback to summary
private String cacheRegion
callableback to summary
private boolean callable
collectionKeysback to summary
private Serializable[] collectionKeys
commentback to summary
private String comment
isNaturalKeyLookupback to summary
private boolean isNaturalKeyLookup
isReadOnlyInitializedback to summary
private boolean isReadOnlyInitialized
lockOptionsback to summary
private LockOptions lockOptions
logback to summary
private static final Logger log
namedParametersback to summary
private Map<K, V> namedParameters
optionalEntityNameback to summary
private String optionalEntityName
optionalIdback to summary
private Serializable optionalId
optionalObjectback to summary
private Object optionalObject
positionalParameterTypesback to summary
private Type[] positionalParameterTypes
positionalParameterValuesback to summary
private Object[] positionalParameterValues
processedPositionalParameterTypesback to summary
private Type[] processedPositionalParameterTypes
processedPositionalParameterValuesback to summary
private Object[] processedPositionalParameterValues
processedSQLback to summary
private String processedSQL
readOnlyback to summary
private boolean readOnly
resultTransformerback to summary
private final ResultTransformer resultTransformer
rowSelectionback to summary
private RowSelection rowSelection
scrollModeback to summary
private ScrollMode scrollMode

Constructor Detail

QueryParametersback to summary
public QueryParameters()
QueryParametersback to summary
public QueryParameters(Type type, Object value)
QueryParametersback to summary
public QueryParameters(final Type[] positionalParameterTypes, final Object[] postionalParameterValues, final Object optionalObject, final String optionalEntityName, final Serializable optionalObjectId)
QueryParametersback to summary
public QueryParameters(final Type[] positionalParameterTypes, final Object[] postionalParameterValues)
QueryParametersback to summary
public QueryParameters(final Type[] positionalParameterTypes, final Object[] postionalParameterValues, final Serializable[] collectionKeys)
QueryParametersback to summary
public QueryParameters(final Type[] positionalParameterTypes, final Object[] postionalParameterValues, final Map<K, V> namedParameters, final Serializable[] collectionKeys)
QueryParametersback to summary
public QueryParameters(final Type[] positionalParameterTypes, final Object[] positionalParameterValues, final LockOptions lockOptions, final RowSelection rowSelection, final boolean isReadOnlyInitialized, final boolean readOnly, final boolean cacheable, final String cacheRegion, final String comment, final boolean isLookupByNaturalKey, final ResultTransformer transformer)
QueryParametersback to summary
public QueryParameters(final Type[] positionalParameterTypes, final Object[] positionalParameterValues, final Map<K, V> namedParameters, final LockOptions lockOptions, final RowSelection rowSelection, final boolean isReadOnlyInitialized, final boolean readOnly, final boolean cacheable, final String cacheRegion, final String comment, final Serializable[] collectionKeys, ResultTransformer transformer)
QueryParametersback to summary
public QueryParameters(final Type[] positionalParameterTypes, final Object[] positionalParameterValues, final Map<K, V> namedParameters, final LockOptions lockOptions, final RowSelection rowSelection, final boolean isReadOnlyInitialized, final boolean readOnly, final boolean cacheable, final String cacheRegion, final String comment, final Serializable[] collectionKeys, final Object optionalObject, final String optionalEntityName, final Serializable optionalId, final ResultTransformer transformer)

Method Detail

createCopyUsingback to summary
public QueryParameters createCopyUsing(RowSelection selection)
getCacheRegionback to summary
public String getCacheRegion()
getCollectionKeysback to summary
public Serializable[] getCollectionKeys()
getCommentback to summary
public String getComment()
getFilteredPositionalParameterTypesback to summary
public Type[] getFilteredPositionalParameterTypes()
getFilteredPositionalParameterValuesback to summary
public Object[] getFilteredPositionalParameterValues()
getFilteredSQLback to summary
public String getFilteredSQL()
getLockOptionsback to summary
public LockOptions getLockOptions()
getNamedParametersback to summary
public Map<K, V> getNamedParameters()
getOptionalEntityNameback to summary
public String getOptionalEntityName()
getOptionalIdback to summary
public Serializable getOptionalId()
getOptionalObjectback to summary
public Object getOptionalObject()
getPositionalParameterTypesback to summary
public Type[] getPositionalParameterTypes()
getPositionalParameterValuesback to summary
public Object[] getPositionalParameterValues()
getResultTransformerback to summary
public ResultTransformer getResultTransformer()
getRowSelectionback to summary
public RowSelection getRowSelection()
getScrollModeback to summary
public ScrollMode getScrollMode()
hasAutoDiscoverScalarTypesback to summary
public boolean hasAutoDiscoverScalarTypes()
hasRowSelectionback to summary
public boolean hasRowSelection()
isCacheableback to summary
public boolean isCacheable()
isCallableback to summary
public boolean isCallable()
isNaturalKeyLookupback to summary
public boolean isNaturalKeyLookup()
isReadOnlyback to summary
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:boolean

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

Exceptions
IllegalStateException:
if the read-only/modifiable setting has not been initialized (i.e., isReadOnlyInitialized() == false).
See Also
QueryParameters#isReadOnlyInitialized(), QueryParameters#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.
isReadOnlyback to summary
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:boolean

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
QueryParameters#isReadOnlyInitialized(), QueryParameters#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.
isReadOnlyInitializedback to summary
public boolean isReadOnlyInitialized()

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

Returns:boolean

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

See Also
QueryParameters#setReadOnly(boolean), QueryParameters#isReadOnly(SessionImplementor)
processFiltersback to summary
public void processFilters(String sql, SessionImplementor session)
processFiltersback to summary
public void processFilters(String sql, Map<K, V> filters, SessionFactoryImplementor factory)
setAutoDiscoverScalarTypesback to summary
public void setAutoDiscoverScalarTypes(boolean autodiscovertypes)
setCacheableback to summary
public void setCacheable(boolean b)
setCacheRegionback to summary
public void setCacheRegion(String cacheRegion)
setCallableback to summary
public void setCallable(boolean callable)
setCollectionKeysback to summary
public void setCollectionKeys(Serializable[] collectionKeys)
setCommentback to summary
public void setComment(String comment)
setLockOptionsback to summary
public void setLockOptions(LockOptions lockOptions)
setNamedParametersback to summary
public void setNamedParameters(Map<K, V> map)
setNaturalKeyLookupback to summary
public void setNaturalKeyLookup(boolean isNaturalKeyLookup)
setOptionalEntityNameback to summary
public void setOptionalEntityName(String optionalEntityName)
setOptionalIdback to summary
public void setOptionalId(Serializable optionalId)
setOptionalObjectback to summary
public void setOptionalObject(Object optionalObject)
setPositionalParameterTypesback to summary
public void setPositionalParameterTypes(Type[] types)
setPositionalParameterValuesback to summary
public void setPositionalParameterValues(Object[] objects)
setReadOnlyback to summary
public void setReadOnly(boolean readOnly)

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

Returns:void

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
QueryParameters#isReadOnlyInitialized(), QueryParameters#isReadOnly(SessionImplementor), QueryParameters#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.
setRowSelectionback to summary
public void setRowSelection(RowSelection selection)
setScrollModeback to summary
public void setScrollMode(ScrollMode scrollMode)
traceParametersback to summary
public void traceParameters(SessionFactoryImplementor factory) throws HibernateException
validateParametersback to summary
public void validateParameters() throws QueryException