com.goldencode.p2j.util

Class AbstractSimpleParameter

java.lang.Object

com.goldencode.p2j.util.AbstractParameter

com.goldencode.p2j.util.AbstractSimpleParameter

Direct Known Subclasses:

FieldAssigner, PropertyReference.PropertyAssigner, VariableAssigner

public abstract class AbstractSimpleParameter
extends AbstractParameter

Delegate worker for the variables or data-type wrapper implementations, which assigns an OUTPUT or INPUT-OUTPUT parameter's value back to the variable / database field with which it is associated, upon exit from a procedure or function.

Upon exit from the procedure or function with which it is associated, it attempts to assign the current value of its contained variable back into the associated item (variable / DMO) optionally using the conversion constructor provided. This may trigger normal validation processing, which may produce error conditions.

Nested Class Summary

Nested classes/interfaces inherited from class com.goldencode.p2j.util.AbstractParameter

AbstractParameter.Scope, AbstractParameter.WorkArea

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.reflect.Constructor<?>	convCtor The optional conversion constructor that will cast the new variable to old variable type in order to be assigned to field.
protected BaseDataType	outputValue Data wrapper which is used as a procedure or function parameter.

Fields inherited from class com.goldencode.p2j.util.AbstractParameter

context, LOG

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractSimpleParameter(BaseDataType outputValue) Constructor.

Method Summary

Modifier and Type	Method and Description
protected abstract void	assign() Assign the current value of the parameter variable back to the associated item (variable or DMO property.
protected BaseDataType	getLocalParam() Get the variable container used as parameter inside the procedure body.
protected void	release() Release all the callee's resources for this parameter, after assignment has taken place.
static void	update(BaseDataType key, BaseDataType newVar, java.lang.reflect.Constructor<?> convCtor) Update the wrapper variable for a OutputParameterAssigner.

Methods inherited from class com.goldencode.p2j.util.AbstractParameter

canRelease, getCurrentScope, getScopeable, isExtentParameter, isParameter, isTableField, postProcessOutput, replaceParameter

Methods inherited from class java.lang.Object

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

Field Detail

outputValue

protected BaseDataType outputValue

Data wrapper which is used as a procedure or function parameter.

The variable is used as a key for fast-finding the original item that needs to be updated at the return form the called procedure. In this regard it must be unique in the scope! Indeed, it's at least a strange construct to have the same variable declared twice in OUTPUT mode when calling a procedure.

convCtor

protected java.lang.reflect.Constructor<?> convCtor

The optional conversion constructor that will cast the new variable to old variable type in order to be assigned to field.

Constructor Detail

AbstractSimpleParameter

protected AbstractSimpleParameter(BaseDataType outputValue)

Constructor. Register this as output parameter.

Parameters:

outputValue - Parameter value to and from which we will assign.

Method Detail

release

protected void release()

Release all the callee's resources for this parameter, after assignment has taken place.

Specified by:

release in class AbstractParameter

getLocalParam

protected BaseDataType getLocalParam()

Get the variable container used as parameter inside the procedure body.

Overrides:

getLocalParam in class AbstractParameter

Returns:

The data wrapper which is used as a procedure or function parameter.

assign

protected abstract void assign()

Assign the current value of the parameter variable back to the associated item (variable or DMO property. This is expected to occur upon exit from the function or procedure with which this object is associated. Must be implemented in subclasses.

update

public static void update(BaseDataType key,
                          BaseDataType newVar,
                          java.lang.reflect.Constructor<?> convCtor)

Update the wrapper variable for a OutputParameterAssigner. Sometimes is required to change the wrapper variable for an item (Eg. when the ControlFlowOps detects a conversion type is necessary).

Parameters:

key - The old key variable. May be the intermediary wrapper for a field or the real variable passed as *OUTPUT parameter.

newVar - The new wrapper variable that will be used inside the calling procedure. At the end of the call its value will be converted using convCtor and assigned to wrapped field or original variable.

convCtor - The conversion constructor that will cast the new variable to old variable type in order to be assigned to field.