Package   Class  Tree  Serialized  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES
SUMMARY:  INNER | FIELD | CONSTR | METHOD DETAIL:  FIELD | CONSTR | METHOD

com.ibm.websphere.rsadapter
Interface WSInteractionSpec

All Superinterfaces:
javax.resource.cci.InteractionSpec, java.io.Serializable
public interface WSInteractionSpec
extends javax.resource.cci.InteractionSpec

An InteractionSpec holds properties for driving an Interaction with a backend store instance. An InteractionSpec is used by an Interaction to execute the specified function on a backend store instance. The CCI specification defines a set of standard properties for an InteractionSpec.

This WSInteractionSpec interface extends from cci.InteractionSpec. It defines all the getter and setter methods for the supported properties. The supported properties are:

Field Summary
static int LOCKTYPE_SELECT
          public Constants - d139562.13.RA
static int LOCKTYPE_SELECT_FOR_UPDATE
           
static int LOCKTYPE_SELECT_FOR_UPDATE_WITH_RR
           
static int LOCKTYPE_SELECT_FOR_UPDATE_WITH_RS
           
 
Fields inherited from interface javax.resource.cci.InteractionSpec
SYNC_RECEIVE, SYNC_SEND, SYNC_SEND_RECEIVE
 
Method Summary
 com.ibm.websphere.appprofile.accessintent.AccessIntent getAccessIntent()
          d139562.13.RA This method returns an AccessIntent object
 boolean[] getChangedFieldsIndexes()
          This method returns a boolean array of indexes identifying the changed fields.
 java.lang.String getCursorName()
          This methods returns the cursor name defined in this interaction spec
 java.lang.String getDataStoreHelperName()
          This method returns the DataStoreHelper class name for this InteractionSpec.
 int getExecutionTimeout()
          This method returns an integer that represents the number of milliseconds an Interation waits for a backend store to execute the specified function.
 int getFetchDirection()
          This method returns the direction in which the rows in a result set are processed.
 int getFetchSize()
          This method returns the number of rows that should be fetched from a backend store when more rows are needed for a result set.
 java.lang.String getFunctionName()
          This method returns the function name that is used by the Interaction.execute() method to execute the specified function.
 java.lang.String getFunctionSetName()
          This method returns the package-qualified DataAccessFunctionSet name that represents the current access EJB bean.
 int getInteractionVerb()
          This method returns an integer that represents the mode of interaction with the backend store instance.
 int getLockType()
          d139562.13.RA This method gets the update intent locktype based on the AccessIntent
 int getMaxFieldSize()
          This method returns the maximum number of bytes allowed for any value in a column of a result set or a value in a record.
 javax.resource.cci.IndexedRecord getOldRecord()
          This method returns the IndexedRecord that contains the old values of an EJB instance.
 int getPrefetchRowSize()
          This method gets the prefetch-row size defined in this interaction to be used when executing the Method in FS
 int getResultSetConcurrency()
          This method returns the concurrency type of the result set produced by the execution of the InteractionSpec.
 int getResultSetType()
          This method returns the type of the result set produced by an execution of the InteractionSpec.
 boolean isUpdateRequest()
          This method return whether the request is an update
 void setAccessIntent(com.ibm.websphere.appprofile.accessintent.AccessIntent aIntent)
          d139562.13.RA This method sets the AccessIntent object in this interactionSpec
 void setChangedFieldsIndexes(boolean[] changedFields)
          This method sets a boolean array of indexes identifying the changed fields.
 void setCursorName(java.lang.String cursorName)
          This method used to set the cursor name in the interaction spec
 void setDataStoreHelperName(java.lang.String dsHelperName)
          This method sets the DataStoreHelper class name for this InteractionSpec.
 void setExecutionTimeout(int milliseconds)
          This method sets the number of milliseconds an Interation waits for a backend store to execute the specified function.
 void setFetchDirection(int direction)
          This method sets the direction in which the rows in a result set are processed.
 void setFetchSize(int size)
          This method sets the number of rows that should be fetched from a backend store when more rows are needed for a result set.
 void setFunctionName(java.lang.String name)
          This method sets the function name that is used by the Interaction.execute() method to execute the specified function.
 void setFunctionSetName(java.lang.String name)
          This method sets the package-qualified DataAccessFunctionSet name that represents the current access EJB bean.
 void setInteractionVerb(int verb)
          This method sets the mode of interaction with the backend store instance.
 void setLockType(int locktype)
          d139562.13.RA This method sets the update intent locktype in this interactionSpec.
 void setMaxFieldSize(int maxSize)
          This method sets the maximum number of bytes allowed for any value in a column of a result set or a value in a record.
 void setOldRecord(javax.resource.cci.IndexedRecord oldRecord)
          This method sets the IndexedRecord that contains the old values of an EJB instance.
 void setPrefetchRowSize(int num)
          This method sets the prefetchRowSize: which is the number of rows needed to be prefetched.
 void setResultSetConcurrency(int concurrency)
          This method sets the concurrency type of the result set produced by the execution of the InteractionSpec.
 void setResultSetType(int resultType)
          This method sets the type of the result set produced by an execution of the InteractionSpec.
 void setUpdateRequest(boolean flag)
          this method used to set a flag indicating if the execution purpose is to update or not
 

Field Detail

LOCKTYPE_SELECT

public static final int LOCKTYPE_SELECT
public Constants - d139562.13.RA

LOCKTYPE_SELECT_FOR_UPDATE

public static final int LOCKTYPE_SELECT_FOR_UPDATE

LOCKTYPE_SELECT_FOR_UPDATE_WITH_RS

public static final int LOCKTYPE_SELECT_FOR_UPDATE_WITH_RS

LOCKTYPE_SELECT_FOR_UPDATE_WITH_RR

public static final int LOCKTYPE_SELECT_FOR_UPDATE_WITH_RR
Method Detail

setFunctionName

public void setFunctionName(java.lang.String name)
                     throws javax.resource.ResourceException
This method sets the function name that is used by the Interaction.execute() method to execute the specified function. The function name refers to the method in the DataStoreFunctionSet class.

Parameters:
name - - function name that refers to a method in the DataStoreFunctionSet class
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getFunctionName

public java.lang.String getFunctionName()
This method returns the function name that is used by the Interaction.execute() method to execute the specified function. The function name refers to the method in the DataStoreFunctionSet class.

Returns:
- function name that refers to a method in the DataStoreFunctionSet class

setInteractionVerb

public void setInteractionVerb(int verb)
                        throws javax.resource.ResourceException
This method sets the mode of interaction with the backend store instance. The values are:

Refer to the J2EE Connection Architecture spec for the description of these values.

Parameters:
verb - - integer that represents the mode of interaction with the backend store instance
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getInteractionVerb

public int getInteractionVerb()
This method returns an integer that represents the mode of interaction with the backend store instance. The values are:

Refer to the J2EE Connection Architecture spec for the description of these values.

Returns:
- integer that represents the mode of interaction with the backend store instance

setExecutionTimeout

public void setExecutionTimeout(int milliseconds)
                         throws javax.resource.ResourceException
This method sets the number of milliseconds an Interation waits for a backend store to execute the specified function. The default value of 0 stands for 'unlimited'.

Parameters:
milliseconds - - the number of milliseconds an Interation waits for a backend store to execute the specified function
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getExecutionTimeout

public int getExecutionTimeout()
This method returns an integer that represents the number of milliseconds an Interation waits for a backend store to execute the specified function. The default value of 0 stands for 'unlimited'.

Returns:
- the number of milliseconds an Interation waits for a backend store to execute the specified function

setFetchSize

public void setFetchSize(int size)
                  throws javax.resource.ResourceException
This method sets the number of rows that should be fetched from a backend store when more rows are needed for a result set. If the value is zero, then the hint is ignored. The default value is zero.

Parameters:
size - - the number of rows that should be fetched from a backend store
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getFetchSize

public int getFetchSize()
This method returns the number of rows that should be fetched from a backend store when more rows are needed for a result set. If the value is zero, then the hint is ignored. The default value is zero.

Returns:
- the number of rows that should be fetched from a backend store

setFetchDirection

public void setFetchDirection(int direction)
                       throws javax.resource.ResourceException
This method sets the direction in which the rows in a result set are processed. The directions are :

Parameters:
direction - - an int value indicating the direction in which the rows in a result set are processed
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getFetchDirection

public int getFetchDirection()
This method returns the direction in which the rows in a result set are processed. The directions are :

Returns:
- an int value indicating the direction in which the rows in a result set are processed

setMaxFieldSize

public void setMaxFieldSize(int maxSize)
                     throws javax.resource.ResourceException
This method sets the maximum number of bytes allowed for any value in a column of a result set or a value in a record.

Parameters:
maxSize - - the maximum number of bytes allowed for any value in a column of a result set or a value in a record
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getMaxFieldSize

public int getMaxFieldSize()
This method returns the maximum number of bytes allowed for any value in a column of a result set or a value in a record.

Returns:
- the maximum number of bytes allowed for any value in a column of a result set or a value in a record

setResultSetType

public void setResultSetType(int resultType)
                      throws javax.resource.ResourceException
This method sets the type of the result set produced by an execution of the InteractionSpec. The types are:

Parameters:
resultType - - an int value indicating the type of the result set produced by an execution of the InteractionSpec
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getResultSetType

public int getResultSetType()
This method returns the type of the result set produced by an execution of the InteractionSpec. The types are:

Returns:
- an int value indicating the type of the result set produced by an execution of the InteractionSpec

setResultSetConcurrency

public void setResultSetConcurrency(int concurrency)
                             throws javax.resource.ResourceException
This method sets the concurrency type of the result set produced by the execution of the InteractionSpec. The concurrency types are :

Parameters:
concurrency - - an int value indicating the concurrency type of the result set produced by the execution of the InteractionSpec
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getResultSetConcurrency

public int getResultSetConcurrency()
This method returns the concurrency type of the result set produced by the execution of the InteractionSpec. The concurrency types are :

Returns:
- an int value indicating the concurrency type of the result set produced by the execution of the InteractionSpec

setFunctionSetName

public void setFunctionSetName(java.lang.String name)
                        throws javax.resource.ResourceException
This method sets the package-qualified DataAccessFunctionSet name that represents the current access EJB bean. This name is used to locate the correct DataAccessFunctionset object instance.

Parameters:
name - - the package-qualified DataAccessFunctionSet name that represents the current access EJB bean
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getFunctionSetName

public java.lang.String getFunctionSetName()
This method returns the package-qualified DataAccessFunctionSet name that represents the current access EJB bean. This name is used to locate the correct DataAccessFunctionset object instance.

Returns:
- the package-qualified DataAccessFunctionSet name that represents the current access EJB bean

setOldRecord

public void setOldRecord(javax.resource.cci.IndexedRecord oldRecord)
                  throws javax.resource.ResourceException
This method sets the IndexedRecord that contains the old values of an EJB instance. This EJB instance will be used by the DataAccessFunctionSet class to get the old values of the fields to use as the over-qualified fields in a SQL statement for optimistic concurrency control support.

Parameters:
oldRecord - - the IndexedRecord that contains the old values of an EJB instance
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getOldRecord

public javax.resource.cci.IndexedRecord getOldRecord()
This method returns the IndexedRecord that contains the old values of an EJB instance. This EJB instance will be used by the DataAccessFunctionSet class to get the old values of the fields to use as the over-qualified fields in a SQL statement for optimistic concurrency control support.

Returns:
- the IndexedRecord that contains the old values of an EJB instance

setChangedFieldsIndexes

public void setChangedFieldsIndexes(boolean[] changedFields)
                             throws javax.resource.ResourceException
This method sets a boolean array of indexes identifying the changed fields. Each index represents a field in the Record.

Parameters:
changedFields - - a boolean array of indexes identifying the changed fields
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getChangedFieldsIndexes

public boolean[] getChangedFieldsIndexes()
This method returns a boolean array of indexes identifying the changed fields. Each index represents a field in the Record.

Returns:
- a boolean array of indexes identifying the changed fields

setDataStoreHelperName

public void setDataStoreHelperName(java.lang.String dsHelperName)
                            throws javax.resource.ResourceException
This method sets the DataStoreHelper class name for this InteractionSpec. The name must correspond to the datastore type (for example, DB2DataStoreHelper or OracleDataStoreHelper).

Parameters:
dsHelperName - - the DataStoreHelper class name
Throws:
javax.resource.ResourceException - - thrown if input parameters are not properly set

getDataStoreHelperName

public java.lang.String getDataStoreHelperName()
This method returns the DataStoreHelper class name for this InteractionSpec. The name must correspond to the datastore type (for example, DB2DataStoreHelper or OracleDataStoreHelper).

Returns:
- the DataStoreHelper class name

setCursorName

public void setCursorName(java.lang.String cursorName)
This method used to set the cursor name in the interaction spec
Parameters:
cursorName - String

getCursorName

public java.lang.String getCursorName()
This methods returns the cursor name defined in this interaction spec
Returns:
String cursor name

setPrefetchRowSize

public void setPrefetchRowSize(int num)
This method sets the prefetchRowSize: which is the number of rows needed to be prefetched. This will be passed on to the database
Parameters:
num - int

getPrefetchRowSize

public int getPrefetchRowSize()
This method gets the prefetch-row size defined in this interaction to be used when executing the Method in FS
Returns:
int

isUpdateRequest

public boolean isUpdateRequest()
This method return whether the request is an update
Returns:
boolean

setUpdateRequest

public void setUpdateRequest(boolean flag)
this method used to set a flag indicating if the execution purpose is to update or not
Parameters:
flag - boolean

setLockType

public void setLockType(int locktype)
d139562.13.RA This method sets the update intent locktype in this interactionSpec. The possible values are :

Parameters:
locktype - - must be one of the above constant.

getLockType

public int getLockType()
d139562.13.RA This method gets the update intent locktype based on the AccessIntent
Returns:
- a locktype

setAccessIntent

public void setAccessIntent(com.ibm.websphere.appprofile.accessintent.AccessIntent aIntent)
d139562.13.RA This method sets the AccessIntent object in this interactionSpec
Parameters:
aIntent - - an AccessIntent object

getAccessIntent

public com.ibm.websphere.appprofile.accessintent.AccessIntent getAccessIntent()
d139562.13.RA This method returns an AccessIntent object
Returns:
an AccessIntent object.
Package   Class  Tree  Serialized  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES
SUMMARY:  INNER | FIELD | CONSTR | METHOD DETAIL:  FIELD | CONSTR | METHOD