org.hibernate.jpa.spi

Interface ParameterRegistration<T>

All Superinterfaces:

Parameter<T>

All Known Subinterfaces:

NullTypeBindableParameterRegistration<T>, StoredProcedureQueryParameterRegistration<T>

All Known Implementing Classes:

QueryImpl.JpaPositionalParameterRegistrationImpl

public interface ParameterRegistration<T>
extends Parameter<T>

Hibernate specific extension to the JPA Parameter contract as known to the Query and StoredProcedureQuery implementations. Used to track information known about the parameter.

For parameter information as known to JPA criteria queries, see ParameterExpressionImpl instead.

Author:

Steve Ebersole

Method Summary

Modifier and Type	Method and Description
void	bindValue(T value) If bindable, bind the value.
void	bindValue(T value, TemporalType specifiedTemporalType) If bindable, bind the value using the specific temporal type.
ParameterBind<T>	getBind() If bindable, get the current binding.
ParameterMode	getMode() Retrieves the parameter "mode" which describes how the parameter is defined in the actual database procedure definition (is it an INPUT parameter? An OUTPUT parameter? etc).
Query	getQuery() Access to the query that this parameter belongs to.
boolean	isBindable() Can we bind (set) values on this parameter? Generally this is true, but would not be in the case of parameters with OUT or REF_CURSOR mode.
boolean	isJpaPositionalParameter() JPA has a different definition of positional parameters than what legacy Hibernate HQL had.

Methods inherited from interface javax.persistence.Parameter

getName, getParameterType, getPosition

Method Detail

isJpaPositionalParameter

boolean isJpaPositionalParameter()

JPA has a different definition of positional parameters than what legacy Hibernate HQL had. In JPA, the parameter holders are labelled (named :/). At any rate the semantics are different and we often need to understand which we are dealing with (and applications might too).

Returns:

true if this is a JPA-style positional parameter; false would indicate we have either a named parameter (Parameter.getName() would return a non-null value) or a native Hibernate positional parameter.

getQuery

Query getQuery()

Access to the query that this parameter belongs to.

Returns:

The defining query

getMode

ParameterMode getMode()

Retrieves the parameter "mode" which describes how the parameter is defined in the actual database procedure definition (is it an INPUT parameter? An OUTPUT parameter? etc).

Returns:

The parameter mode.

isBindable

boolean isBindable()

Can we bind (set) values on this parameter? Generally this is true, but would not be in the case of parameters with OUT or REF_CURSOR mode.

Returns:

Whether the parameter is bindable (can set be called).

bindValue

void bindValue(T value)

If bindable, bind the value.

Parameters:

value - The value to bind.

bindValue

void bindValue(T value,
               TemporalType specifiedTemporalType)

If bindable, bind the value using the specific temporal type.

Parameters:

value - The value to bind

specifiedTemporalType - The temporal type to use in binding

getBind

ParameterBind<T> getBind()

If bindable, get the current binding.

Returns:

The current binding