程序包 org.hibernate.procedure

接口 ProcedureCall

所有超级接口:

BasicQueryContract<CommonQueryContract>, javax.persistence.Query, javax.persistence.StoredProcedureQuery, SynchronizeableQuery

所有已知子接口:

ProcedureCallImplementor<R>

所有已知实现类:

ProcedureCallImpl

public interface ProcedureCall
extends BasicQueryContract<CommonQueryContract>, SynchronizeableQuery, javax.persistence.StoredProcedureQuery

Defines support for executing database stored procedures and functions

作者:

Steve Ebersole

方法概要

修饰符和类型	方法	说明
ProcedureCall	addSynchronizedEntityClass(Class entityClass)	Adds an entity for (a) auto-flush checking and (b) query result cache invalidation checking.
ProcedureCall	addSynchronizedEntityName(String entityName)	Adds an entity name for (a) auto-flush checking and (b) query result cache invalidation checking.
ProcedureCall	addSynchronizedQuerySpace(String querySpace)	Adds a query space.
ProcedureCallMemento	extractMemento()	Extract the disconnected representation of this call.
ProcedureCallMemento	extractMemento(Map<String,Object> hints)	Extract the disconnected representation of this call.
ProcedureOutputs	getOutputs()	Retrieves access to outputs of this procedure call.
ParameterRegistration	getParameterRegistration(int position)	Retrieve a previously registered parameter memento by the position under which it was registered.
ParameterRegistration	getParameterRegistration(String name)	Retrieve a previously registered parameter memento by the name under which it was registered.
String	getProcedureName()	Get the name of the stored procedure to be called.
List<ParameterRegistration>	getRegisteredParameters()	Retrieve all registered parameters.
<T> ParameterRegistration<T>	registerParameter(int position, Class<T> type, javax.persistence.ParameterMode mode)	Basic form for registering a positional parameter.
<T> ParameterRegistration<T>	registerParameter(String parameterName, Class<T> type, javax.persistence.ParameterMode mode)	Basic form for registering a named parameter.
ProcedureCall	registerParameter0(int position, Class type, javax.persistence.ParameterMode mode)	Chained form of registerParameter(int, Class, javax.persistence.ParameterMode)
ProcedureCall	registerParameter0(String parameterName, Class type, javax.persistence.ParameterMode mode)	Chained form of registerParameter(String, Class, javax.persistence.ParameterMode)

从接口继承的方法 org.hibernate.BasicQueryContract

getCacheMode, getCacheRegion, getFetchSize, getHibernateFlushMode, getReturnTypes, getTimeout, isCacheable, isReadOnly, setCacheable, setCacheMode, setCacheRegion, setFetchSize, setFlushMode, setHibernateFlushMode, setReadOnly, setTimeout

从接口继承的方法 javax.persistence.Query

getFirstResult, getFlushMode, getHints, getLockMode, getMaxResults, getParameter, getParameter, getParameter, getParameter, getParameters, getParameterValue, getParameterValue, getParameterValue, getResultStream, isBound, setFirstResult, setLockMode, setMaxResults, unwrap

从接口继承的方法 javax.persistence.StoredProcedureQuery

execute, executeUpdate, getOutputParameterValue, getOutputParameterValue, getResultList, getSingleResult, getUpdateCount, hasMoreResults, registerStoredProcedureParameter, registerStoredProcedureParameter, setFlushMode, setHint, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter

从接口继承的方法 org.hibernate.SynchronizeableQuery

getSynchronizedQuerySpaces

方法详细资料

addSynchronizedQuerySpace

ProcedureCall addSynchronizedQuerySpace(String querySpace)

从接口复制的说明: SynchronizeableQuery

Adds a query space.

指定者:

addSynchronizedQuerySpace 在接口中 SynchronizeableQuery

参数:

querySpace - The query space to be auto-flushed for this query.

返回:

this, for method chaining

addSynchronizedEntityName

ProcedureCall addSynchronizedEntityName(String entityName)
                                 throws MappingException

从接口复制的说明: SynchronizeableQuery

Adds an entity name for (a) auto-flush checking and (b) query result cache invalidation checking. Same as SynchronizeableQuery.addSynchronizedQuerySpace(java.lang.String) for all tables associated with the given entity.

指定者:

addSynchronizedEntityName 在接口中 SynchronizeableQuery

参数:

entityName - The name of the entity upon whose defined query spaces we should additionally synchronize.

返回:

this, for method chaining

抛出:

MappingException - Indicates the given name could not be resolved as an entity

addSynchronizedEntityClass

ProcedureCall addSynchronizedEntityClass(Class entityClass)
                                  throws MappingException

从接口复制的说明: SynchronizeableQuery

Adds an entity for (a) auto-flush checking and (b) query result cache invalidation checking. Same as SynchronizeableQuery.addSynchronizedQuerySpace(java.lang.String) for all tables associated with the given entity.

指定者:

addSynchronizedEntityClass 在接口中 SynchronizeableQuery

参数:

entityClass - The class of the entity upon whose defined query spaces we should additionally synchronize.

返回:

this, for method chaining

抛出:

MappingException - Indicates the given class could not be resolved as an entity

getProcedureName

String getProcedureName()

Get the name of the stored procedure to be called.

返回:

The procedure name.

registerParameter

<T> ParameterRegistration<T> registerParameter(int position,
                                               Class<T> type,
                                               javax.persistence.ParameterMode mode)

Basic form for registering a positional parameter.

类型参数:

T - The parameterized Java type of the parameter.

参数:

position - The position

type - The Java type of the parameter

mode - The parameter mode (in, out, inout)

返回:

The parameter registration memento

registerParameter0

ProcedureCall registerParameter0(int position,
                                 Class type,
                                 javax.persistence.ParameterMode mode)

Chained form of registerParameter(int, Class, javax.persistence.ParameterMode)

参数:

position - The position

type - The Java type of the parameter

mode - The parameter mode (in, out, inout)

返回:

this, for method chaining

getParameterRegistration

ParameterRegistration getParameterRegistration(int position)

Retrieve a previously registered parameter memento by the position under which it was registered.

参数:

position - The parameter position

返回:

The parameter registration memento

抛出:

ParameterStrategyException - If the ProcedureCall is defined using named parameters

NoSuchParameterException - If no parameter with that position exists

registerParameter

<T> ParameterRegistration<T> registerParameter(String parameterName,
                                               Class<T> type,
                                               javax.persistence.ParameterMode mode)
                                        throws NamedParametersNotSupportedException

Basic form for registering a named parameter.

类型参数:

T - The parameterized Java type of the parameter.

参数:

parameterName - The parameter name

type - The Java type of the parameter

mode - The parameter mode (in, out, inout)

返回:

The parameter registration memento

抛出:

NamedParametersNotSupportedException - When the underlying database is known to not support named procedure parameters.

registerParameter0

ProcedureCall registerParameter0(String parameterName,
                                 Class type,
                                 javax.persistence.ParameterMode mode)
                          throws NamedParametersNotSupportedException

Chained form of registerParameter(String, Class, javax.persistence.ParameterMode)

参数:

parameterName - The parameter name

type - The Java type of the parameter

mode - The parameter mode (in, out, inout)

返回:

The parameter registration memento

抛出:

NamedParametersNotSupportedException - When the underlying database is known to not support named procedure parameters.

getParameterRegistration

ParameterRegistration getParameterRegistration(String name)

Retrieve a previously registered parameter memento by the name under which it was registered.

参数:

name - The parameter name

返回:

The parameter registration memento

抛出:

ParameterStrategyException - If the ProcedureCall is defined using positional parameters

NoSuchParameterException - If no parameter with that name exists

getRegisteredParameters

List<ParameterRegistration> getRegisteredParameters()

Retrieve all registered parameters.

返回:

The (immutable) list of all registered parameters.

getOutputs

ProcedureOutputs getOutputs()

Retrieves access to outputs of this procedure call. Can be called multiple times, returning the same ProcedureOutputs instance each time.

If the procedure call has not actually be executed yet, it will be executed and then the ProcedureOutputs will be returned.

返回:

The ProcedureOutputs representation

extractMemento

ProcedureCallMemento extractMemento(Map<String,Object> hints)

Extract the disconnected representation of this call. Used in HEM to allow redefining a named query

参数:

hints - The hints to incorporate into the memento

返回:

The memento

extractMemento

ProcedureCallMemento extractMemento()

Extract the disconnected representation of this call. Used in HEM to allow redefining a named query *

返回:

The memento