planetj.dataengine
Class AbstractContext

java.lang.Object
  planetj.dataengine.AbstractContext

All Implemented Interfaces:

java.lang.Cloneable, IContext, INavigationObject, java.io.Serializable

Direct Known Subclasses:

HTMLContext, JavaContext, SQLContext

public abstract class AbstractContext

extends java.lang.Object

implements java.io.Serializable, java.lang.Cloneable, INavigationObject, IContext

!!DA (6/11/2003 8:06:21 AM) documentation needed

See Also:

Serialized Form

Field Summary

static java.lang.String	className Class name.
static int	DEFAULT_TYPE Default type for parameter values.
protected java.lang.String	mCode Get this context's code string (may contain possible parameters).
protected boolean	mLocked Variable used to lock this context.
protected boolean	mParameterized Indicates if this context is parameterized (if its code string contains parameters).
protected java.util.List	mParameterNames List of parameter names.
protected Row	mParameterSource Source Row used to set the parameter values.
protected java.util.List	mParameterValues Parameter values.
static java.lang.String	PARAM_ESCAPE_NUMBERED
static java.lang.String	PARAM_ESCAPE_TABLE
static java.lang.String	PARAM_ESCAPE_USAGE_ID
static java.lang.String	PARAM_ESCAPE_USER
static java.lang.String	PARAM_ESCAPE_USER_USAGE_ID
static java.lang.String	PARAM_NUMBERED
static java.lang.String	PARAM_TABLE
static java.lang.String	PARAM_USAGE_ID
static java.lang.String	PARAM_USER
static java.lang.String	PARAM_USER_USAGE_ID
protected static int	TYPE_TABLE_PARAMETER

Constructor Summary

AbstractContext()
AbstractContext constructor comment.

AbstractContext(ExecutingContext ec)
AbstractContext constructor comment.

AbstractContext(IUser user)
Deprecated. replaced with AbstractContext(ExecutingContext)

Method Summary

protected java.lang.StringBuffer	appendParameters(java.lang.StringBuffer info) Appends this context's String representation of its parameters on the given buffer.
protected java.lang.StringBuffer	appendProperties(java.lang.StringBuffer info) Gets a String representation of this context.
void	clear() Wipes out info in this context, restoring the default values.
void	clearParameterValues() Clears all the parameter values for this context, as well as any validation exceptions.
java.lang.Object	clone() Creates an unlocked copy of this context.
protected java.lang.String	createParameter(java.lang.String parameterToken) Creates a parameter of the appropriate type, stores it in this context, and returns a String to take the place of the parameter token in the String of code
static boolean	equals(java.lang.Object one, java.lang.Object two)
abstract java.lang.Object	execute() Executes this context.
java.lang.String	getCode() Gets this context's code string.
java.lang.String	getCreationSource() Gets this context's source of where it was created.
long	getDataTimestamp() Gets the time when the data in this context was read from its source.
java.util.Iterator	getDisplayParameters() Iterates over the parameters in this context which should be displayed to the user.
ExecutingContext	getExecutingContext() Gets this context's executing context.
IDisplayParameter	getFirstDisplayParameter() Gets the first parameter which the user is expected to enter information into.
IParameter	getFirstParameterForInput() Gets the first parameter which the user is expected to enter information into.
java.lang.String	getNavigationKey() Get the key used to store/retrieve this Row to/from navigation.
java.lang.String	getNavigationListKey() Get the key used to store and retrieve a List of Rows that have been put into navigation.
java.lang.String	getOriginalCode() Gets this context's original code string.
IParameter	getParameter(int index) Gets a parameter, based on its index
IParameter	getParameter(java.lang.String uniqueId) Gets a parameter by its unique id, or by its context specific id
protected java.lang.Class	getParameterClass(java.lang.String parameterToken) Returns the appropriate class for creating a parameter based on the parameter token.
ParameterCollection	getParameterCollection() Gets the ParameterCollection which contains this context's parameters
int	getParameterCount() Gets the number of parameters present in this context
int	getParameterCount(java.lang.Class paramClass) Gets the number of parameters present in this context which are of the specified class (or are subclasses of the specified class)
java.util.Iterator	getParameterDisplayFields() Deprecated. (6/11/2003 8:01:23 AM) This method will not allow setting the Field's default value from a user property. Replaced by getParameterDisplayFields(ExecutingContext)
java.util.Iterator	getParameterDisplayFields(ExecutingContext ec) Gets an Iterator for all of the display fields for this context's display parameters.
Row	getParameterRow() Convience method to get the parameter row from the parameter collection.
java.util.List	getParameters() Gets a List of this context's IParameter objects.
java.util.Iterator	getParameters(java.lang.Class paramType) Iterates over the parameters in this context which are compatable with the specified Java type
Row	getParameterSource() Gets the row that was used to set the named parameters in this context, or null if no such row exists.
ValidationExceptionCollection	getParameterValidationExceptions() Be careful when you call this method because it is derived and spins through all the fields.
int	getParameterValuesType() Get the type of value a parameter holds.
AbstractContext	getPrimaryContext() Gets this context's primary context.
PropertyGroup	getPropertyGroup(java.lang.String groupName) Gets the first PropertyGroup with the given property group name.
abstract PropertyGroupList	getPropertyGroups() Get all the property groups associated with this context.
java.util.List	getPropertyGroups(java.lang.String groupName) Get this RowCollection's property groups with the given group name.
java.util.Iterator	getRowParameters() Gets an Iterator for iterating over this context's RowParameter objects
protected int	handleParameter(int startIndex, java.lang.StringBuffer code) Handles a parameter token in a StringBuffer of code.
protected void	initializeAndStore(IParameter param, java.lang.String parameterToken) Initializes and stores the parameter in this context
boolean	isCloneNeeded() Test to see if tiis navigation object should be clone upon storing and retrieving.
boolean	isContainsDisplayParameters() Tests if there are any parameters which should be displayed
boolean	isContainsParameters(java.lang.Class paramType) Tests if this context contains any parameters which are of the specified Java type, or are subclasses of the specified Java type.
boolean	isLocked() Check to see if this context is locked.
boolean	isParameterized() Check if this context code is parameterized.
protected abstract boolean	isParameterTokenEnd(char c) Tests if the specified character signals the end of a parameter token
protected boolean	isParameterTokenEnd(int index, java.lang.StringBuffer sb) Tests if the specified character in the StringBuffer ends a parameter token
boolean	isRefreshing() Check whether or not this context is refreshing its original return object.
boolean	isSecondaryContext() Tests if this context is a secondary context.
void	loadGlobalValues() Loads Global variables.
void	loadParameterRequestAndSessionValues() When this method is invoked, values are taken from request parameters, request attributes, and session attributes.
void	loadSQLTextReplacementValues() Loads Global SQL Text Replacement variables.
void	loadUserAndExecutingContextValues() When this method is invoked, values are taken from the user object and executing context and set on the appropriate Parameters.
void	lock() Locks this context, preventing its state from being altered.
void	parameterAltered() Callback method so that parameters can inform their context when they are alerted
protected java.lang.String	prepareForExecution() This method is invoked just before the context's code is executed.
protected abstract java.lang.String	rectifyCode(java.lang.String code) Subclasses need to handle the logic of finding parameters out of the code string.
void	removeNavigationKey() Clears out any navigation key that may have been set on this Row.
void	setCode(java.lang.String code) Sets this context's code string.
void	setCode(java.lang.String code, boolean shadowize) Sets this context's code string.
protected void	setCodeInternal(java.lang.String code) Sets this context's code string.
void	setCreationSource(java.lang.String creationSource) Sets the source where this context was created.
void	setDataTimestamp(long timestamp) Sets the time when the data in this context was read from its source.
void	setExecutingContext(ExecutingContext excontext) Sets this context's executing context.
void	setNavigationKey(java.lang.String key) Set the key used to store/retrieve this Row to/from navigation.
void	setParameterCollection(ParameterCollection newParameters) Sets the ParameterCollection which contains this context's parameters.
void	setParameterDisplayValues(Row row) Provides values for all of this context's display parameters.
void	setParameterValue(int position, int value) Provides a value to a parameter for this context's code string.
void	setParameterValue(int position, java.lang.Object value) Provides a value to a parameter for this context's code string.
void	setParameterValues(Row row) Provides values for all of this context's RowParameters and ContextParameterParameters.
void	setParameterValues(java.lang.String parameterId, java.lang.Object value) Sets the value of parameters in this context
void	setParameterValuesType(int parameterValuesType) Set the type of value parameters are to hold.
void	setPrimaryContext(AbstractContext ac) Sets this context's primary context.
void	setRefreshing(boolean refreshing) Set whether or not this context is refreshing its original return object.
java.lang.String	toString() Gets a String representation of this context

Methods inherited from class java.lang.Object

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

Field Detail

className

public static final java.lang.String className

Class name.

mLocked

protected boolean mLocked

Variable used to lock this context.

mParameterValues

protected java.util.List mParameterValues

Parameter values.

mParameterNames

protected java.util.List mParameterNames

List of parameter names.

mCode

protected java.lang.String mCode

Get this context's code string (may contain possible parameters).

mParameterized

protected boolean mParameterized

Indicates if this context is parameterized (if its code string contains parameters).

mParameterSource

protected Row mParameterSource

Source Row used to set the parameter values.

PARAM_USER

public static final java.lang.String PARAM_USER

See Also:

Constant Field Values

PARAM_NUMBERED

public static final java.lang.String PARAM_NUMBERED

See Also:

Constant Field Values

PARAM_USAGE_ID

public static final java.lang.String PARAM_USAGE_ID

See Also:

Constant Field Values

PARAM_USER_USAGE_ID

public static final java.lang.String PARAM_USER_USAGE_ID

See Also:

Constant Field Values

PARAM_TABLE

public static final java.lang.String PARAM_TABLE

See Also:

Constant Field Values

PARAM_ESCAPE_USER

public static final java.lang.String PARAM_ESCAPE_USER

See Also:

Constant Field Values

PARAM_ESCAPE_NUMBERED

public static final java.lang.String PARAM_ESCAPE_NUMBERED

See Also:

Constant Field Values

PARAM_ESCAPE_USAGE_ID

public static final java.lang.String PARAM_ESCAPE_USAGE_ID

See Also:

Constant Field Values

PARAM_ESCAPE_USER_USAGE_ID

public static final java.lang.String PARAM_ESCAPE_USER_USAGE_ID

See Also:

Constant Field Values

PARAM_ESCAPE_TABLE

public static final java.lang.String PARAM_ESCAPE_TABLE

See Also:

Constant Field Values

DEFAULT_TYPE

public static final int DEFAULT_TYPE

Default type for parameter values.

See Also:

Constant Field Values

TYPE_TABLE_PARAMETER

protected static final int TYPE_TABLE_PARAMETER

See Also:

Constant Field Values

Constructor Detail

AbstractContext

public AbstractContext()

AbstractContext constructor comment.

AbstractContext

public AbstractContext(IUser user)

Deprecated. replaced with AbstractContext(ExecutingContext)

AbstractContext constructor comment.

AbstractContext

public AbstractContext(ExecutingContext ec)

AbstractContext constructor comment.

Method Detail

appendParameters

protected java.lang.StringBuffer appendParameters(java.lang.StringBuffer info)

Appends this context's String representation of its parameters on the given buffer. This method is called by the toString() method. If any subclass wishes to have certain properties displayed besides the code, they can override this method.

appendProperties

protected java.lang.StringBuffer appendProperties(java.lang.StringBuffer info)

Gets a String representation of this context. This method is called by the toString() method. If any subclass wishes to have certain properties displayed besides the code, they can override this method. Note: parameter values are also outputed from toString().

clear

public void clear()
           throws DataEngineException

Wipes out info in this context, restoring the default values. If a subclass overrides this method, they need to make sure they call the super method to allow clearing parameter values and names. They don't need to check if the context is locked because the super's method will do so.

Throws:

DataEngineException

clearParameterValues

public void clearParameterValues()
                          throws CMException

Clears all the parameter values for this context, as well as any validation exceptions.

Throws:

CMException

clone

public java.lang.Object clone()

Creates an unlocked copy of this context.

Specified by:

clone in interface INavigationObject

createParameter

protected java.lang.String createParameter(java.lang.String parameterToken)
                                    throws CMException

Creates a parameter of the appropriate type, stores it in this context, and returns a String to take the place of the parameter token in the String of code

Parameters:

parameterToken - The token such as "?", "??MY_COLUMN", or "???^22" which indicates what type of parameter should be created

Throws:

CMException

equals

public static final boolean equals(java.lang.Object one,
                                   java.lang.Object two)

execute

public abstract java.lang.Object execute()
                                  throws CMException

Executes this context. Their may or may not be any results returned. If their are no results after execution, then null is returned.

Throws:

CMException

getCode

public java.lang.String getCode()

Gets this context's code string.

getCreationSource

public java.lang.String getCreationSource()

Gets this context's source of where it was created. Can be used logging purposes.

getDataTimestamp

public long getDataTimestamp()

Gets the time when the data in this context was read from its source. Long.MIN_VALUE is returned if the value is not known.

getDisplayParameters

public java.util.Iterator getDisplayParameters()

Iterates over the parameters in this context which should be displayed to the user. The Iterator cannot not be altered.

Specified by:

getDisplayParameters in interface IContext

getExecutingContext

public ExecutingContext getExecutingContext()

Gets this context's executing context.

Specified by:

getExecutingContext in interface IContext

getFirstDisplayParameter

public IDisplayParameter getFirstDisplayParameter()

Gets the first parameter which the user is expected to enter information into.

getFirstParameterForInput

public IParameter getFirstParameterForInput()

Gets the first parameter which the user is expected to enter information into. This could theoretically be a parameter other than the 1st display parameter.

getNavigationKey

public java.lang.String getNavigationKey()

Get the key used to store/retrieve this Row to/from navigation.

Specified by:

getNavigationKey in interface INavigationObject

getNavigationListKey

public java.lang.String getNavigationListKey()

Get the key used to store and retrieve a List of Rows that have been put into navigation. If any subclasses need to be grouped separate, they can override this method and specify their own navigation list key.

Specified by:

getNavigationListKey in interface INavigationObject

getOriginalCode

public java.lang.String getOriginalCode()

Gets this context's original code string.

Specified by:

getOriginalCode in interface IContext

getParameter

public IParameter getParameter(int index)

Gets a parameter, based on its index

Specified by:

getParameter in interface IContext

getParameter

public IParameter getParameter(java.lang.String uniqueId)

Gets a parameter by its unique id, or by its context specific id

Specified by:

getParameter in interface IContext

getParameterClass

protected java.lang.Class getParameterClass(java.lang.String parameterToken)

Returns the appropriate class for creating a parameter based on the parameter token. Subclasses may override this method if they wish, but the returned class must implement IParameter. Null is returned if there is no matching class

Parameters:

parameterToken - The token such as "?", "??MY_COLUMN", or "???^22" which indicates what type of parameter should be created

getParameterCollection

public ParameterCollection getParameterCollection()

Gets the ParameterCollection which contains this context's parameters

getParameterCount

public int getParameterCount()

Gets the number of parameters present in this context

Specified by:

getParameterCount in interface IContext

getParameterCount

public int getParameterCount(java.lang.Class paramClass)

Gets the number of parameters present in this context which are of the specified class (or are subclasses of the specified class)

Specified by:

getParameterCount in interface IContext

getParameterDisplayFields

public java.util.Iterator getParameterDisplayFields()

Deprecated. (6/11/2003 8:01:23 AM) This method will not allow setting the Field's default value from a user property. Replaced by getParameterDisplayFields(ExecutingContext)

Gets an Iterator for all of the display fields for this context's display parameters.

Returns:

iterator of Field's.

getParameterDisplayFields

public java.util.Iterator getParameterDisplayFields(ExecutingContext ec)

Gets an Iterator for all of the display fields for this context's display parameters.

Parameters:

ec - current context in which code is executing.

Returns:

iterator of Field's.

getParameterRow

public Row getParameterRow()
                    throws CMException

Convience method to get the parameter row from the parameter collection.

Throws:

CMException

See Also:

ParameterCollection.getParameterRow()

getParameters

public java.util.List getParameters()

Gets a List of this context's IParameter objects. The list cannot be altered

Specified by:

getParameters in interface IContext

getParameters

public java.util.Iterator getParameters(java.lang.Class paramType)

Iterates over the parameters in this context which are compatable with the specified Java type

Specified by:

getParameters in interface IContext

getParameterSource

public Row getParameterSource()

Gets the row that was used to set the named parameters in this context, or null if no such row exists.

getParameterValidationExceptions

public ValidationExceptionCollection getParameterValidationExceptions()

Be careful when you call this method because it is derived and spins through all the fields. This will return a collection of al the Exceptions of each field.

Specified by:

getParameterValidationExceptions in interface IContext

getPrimaryContext

public AbstractContext getPrimaryContext()

Gets this context's primary context. When a context has a primary context, then that context can only get its parameter values from the primary context.

getPropertyGroup

public PropertyGroup getPropertyGroup(java.lang.String groupName)

Gets the first PropertyGroup with the given property group name.

Specified by:

getPropertyGroup in interface IContext

getPropertyGroups

public abstract PropertyGroupList getPropertyGroups()

Get all the property groups associated with this context.

Specified by:

getPropertyGroups in interface IContext

getPropertyGroups

public java.util.List getPropertyGroups(java.lang.String groupName)

Get this RowCollection's property groups with the given group name.

Specified by:

getPropertyGroups in interface IContext

getRowParameters

public java.util.Iterator getRowParameters()

Gets an Iterator for iterating over this context's RowParameter objects

handleParameter

protected int handleParameter(int startIndex,
                              java.lang.StringBuffer code)

Handles a parameter token in a StringBuffer of code. A new IParameter is created and stored in this context, and the parameter token in the code is replaced with the parameter's unique ID

Returns:

The index of the last character of the parameter's unique ID within the code

initializeAndStore

protected void initializeAndStore(IParameter param,
                                  java.lang.String parameterToken)
                           throws CMException

Initializes and stores the parameter in this context

Throws:

CMException

isCloneNeeded

public boolean isCloneNeeded()

Description copied from interface: INavigationObject

Test to see if tiis navigation object should be clone upon storing and retrieving.

Specified by:

isCloneNeeded in interface INavigationObject

isContainsDisplayParameters

public boolean isContainsDisplayParameters()

Tests if there are any parameters which should be displayed

Specified by:

isContainsDisplayParameters in interface IContext

isContainsParameters

public boolean isContainsParameters(java.lang.Class paramType)

Tests if this context contains any parameters which are of the specified Java type, or are subclasses of the specified Java type.

isLocked

public boolean isLocked()

Check to see if this context is locked. If locked, it cannot cannot be altered.

isParameterized

public boolean isParameterized()

Check if this context code is parameterized.

Specified by:

isParameterized in interface IContext

isParameterTokenEnd

protected abstract boolean isParameterTokenEnd(char c)

Tests if the specified character signals the end of a parameter token

isParameterTokenEnd

protected boolean isParameterTokenEnd(int index,
                                      java.lang.StringBuffer sb)

Tests if the specified character in the StringBuffer ends a parameter token

isRefreshing

public boolean isRefreshing()

Check whether or not this context is refreshing its original return object. When refreshing, a context will not change any of its parameters.

isSecondaryContext

public boolean isSecondaryContext()

Tests if this context is a secondary context. A secondary context can only get its parameter values from another context in the same operation

Specified by:

isSecondaryContext in interface IContext

loadGlobalValues

public void loadGlobalValues()
                      throws DataEngineException

Loads Global variables. Global variables have a FD usagid of -3

Throws:

DataEngineException

loadSQLTextReplacementValues

public void loadSQLTextReplacementValues()
                                  throws DataEngineException

Loads Global SQL Text Replacement variables.

Throws:

DataEngineException

loadParameterRequestAndSessionValues

public void loadParameterRequestAndSessionValues()
                                          throws DataEngineException

When this method is invoked, values are taken from request parameters, request attributes, and session attributes.

Throws:

DataEngineException

loadUserAndExecutingContextValues

public void loadUserAndExecutingContextValues()
                                       throws DataEngineException

When this method is invoked, values are taken from the user object and executing context and set on the appropriate Parameters.

Throws:

DataEngineException

lock

public void lock()

Locks this context, preventing its state from being altered. Once locked, it cannot be unlocked.

parameterAltered

public void parameterAltered()
                      throws DataEngineException

Callback method so that parameters can inform their context when they are alerted

Specified by:

parameterAltered in interface IContext

Throws:

DataEngineException

prepareForExecution

protected java.lang.String prepareForExecution()
                                        throws DataEngineException

This method is invoked just before the context's code is executed.

Returns:

This operation's code, after parameters have been replaced with their values

Throws:

DataEngineException

rectifyCode

protected abstract java.lang.String rectifyCode(java.lang.String code)

Subclasses need to handle the logic of finding parameters out of the code string.

removeNavigationKey

public void removeNavigationKey()

Clears out any navigation key that may have been set on this Row.

Specified by:

removeNavigationKey in interface INavigationObject

setCode

public void setCode(java.lang.String code)

Sets this context's code string.

setCode

public void setCode(java.lang.String code,
                    boolean shadowize)

Sets this context's code string.

setCodeInternal

protected void setCodeInternal(java.lang.String code)

Sets this context's code string.

setCreationSource

public void setCreationSource(java.lang.String creationSource)

Sets the source where this context was created.

setDataTimestamp

public void setDataTimestamp(long timestamp)

Sets the time when the data in this context was read from its source. This is an internal DataEngine method and should not be invoked by other applications

setExecutingContext

public void setExecutingContext(ExecutingContext excontext)

Sets this context's executing context.

Specified by:

setExecutingContext in interface IContext

setNavigationKey

public void setNavigationKey(java.lang.String key)

Set the key used to store/retrieve this Row to/from navigation.

Specified by:

setNavigationKey in interface INavigationObject

setParameterCollection

public void setParameterCollection(ParameterCollection newParameters)

Sets the ParameterCollection which contains this context's parameters. All existing parameters and their values are lost

setParameterDisplayValues

public void setParameterDisplayValues(Row row)
                               throws CMException

Provides values for all of this context's display parameters. For each display parameter, if the Row contains a field with the same name as the parameter's column name, then that Field's value is used to set that parameter.

Throws:

CMException

setParameterValue

public void setParameterValue(int position,
                              int value)
                       throws CMException

Provides a value to a parameter for this context's code string. (If this context does not use parameters, then this method is irrelevant.)

Parameters:

position - The index of the parameter whose value is being supplied. The first parameter is 0, the second is 1, etc.

value - The value to give to the parameter.

Throws:

CMException

setParameterValue

public void setParameterValue(int position,
                              java.lang.Object value)
                       throws CMException

Provides a value to a parameter for this context's code string. (If this context does not use parameters, then this method is irrelevant.)

Parameters:

position - The index of the parameter whose value is being supplied. The first parameter is 0, the second is 1, etc.

value - The value to give to the parameter. This value may be null. After the value is passed to this method it must never be changed. If it is possible for this value to change, you should clone it and pass a clone which will not change to this method.

Throws:

CMException

setParameterValues

public void setParameterValues(java.lang.String parameterId,
                               java.lang.Object value)
                        throws CMException

Sets the value of parameters in this context

Specified by:

setParameterValues in interface IContext

Parameters:

parameterId - A String which identifies the parameters whose values will be set. This String can either be a context specific id, a name, or by a named index. The context specific id looks like ¤3¿ or ¤0¿ The parameter name is the string corresponding to the parameter's key or column (e.g. BALANCE or VAL) A parameter name may correspond to multiple parameters, in which case all of these parameters will have their values set by this method The named index is the string "_parm" with the parameter's index appended on the end (e.g. _parm0 or _parm2)

value - The value to set parameters to

Throws:

CMException

setParameterValues

public void setParameterValues(Row row)
                        throws CMException

Provides values for all of this context's RowParameters and ContextParameterParameters. For each RowParameter, if the Row contains a field with the same name, then that Field's value is used to set that parameter. For each ConextParameterParameter, if the context contains the parameter number specified, its value is used.

Specified by:

setParameterValues in interface IContext

Throws:

CMException

setPrimaryContext

public void setPrimaryContext(AbstractContext ac)

Sets this context's primary context. When a context has a primary context, its parameter values can only be set based on the values in its primary context

setRefreshing

public void setRefreshing(boolean refreshing)

Set whether or not this context is refreshing its original return object. When refreshing, a context will not change any of its parameters.

toString

public java.lang.String toString()

Gets a String representation of this context

getParameterValuesType

public int getParameterValuesType()

Get the type of value a parameter holds.

Specified by:

getParameterValuesType in interface IContext

setParameterValuesType

public void setParameterValuesType(int parameterValuesType)

Set the type of value parameters are to hold.