com.ibm.wsspi.ejbpersistence
Class WSEJBToRAAdapter
- java.lang.Object
com.ibm.wsspi.ejbpersistence.WSEJBToRAAdapter
- public abstract class WSEJBToRAAdapter
- extends java.lang.Object
- implements com.ibm.websphere.ejbpersistence.EJBToRAAdapter
This is the default implementation for the EJBToRAAdapter interface. Third party RA suppliers must implement EJBToRAAdapter interface or extend this class.
EJBToRAAdapterField Summary
| Fields inherited from interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter |
|---|
LOCKTYPE_NOTAPPLICABLE, LOCKTYPE_SELECT, LOCKTYPE_SELECT_FOR_UPDATE, LOCKTYPE_SELECT_FOR_UPDATE_WITH_RR, LOCKTYPE_SELECT_FOR_UPDATE_WITH_RS |
Constructor Summary
| Modifier | Constructor and Description |
|---|---|
|
WSEJBToRAAdapter()
default Constructor
|
Method Summary
| Modifier and Type | Method and Description |
|---|---|
|
checkBackendId(javax.resource.cci.ConnectionFactory connectionFactory,java.lang.String backendId)
|
|
createInteraction(javax.resource.cci.Connection conn)
Deprecated.
|
|
createInteraction(javax.resource.cci.Connection conn,com.ibm.websphere.appprofile.accessintent.AccessIntent intent,java.util.HashMap properties)
|
|
executeCreate(javax.resource.cci.Interaction interaction,javax.resource.cci.InteractionSpec ispec,javax.resource.cci.IndexedRecord inputRecord)
|
|
executeCreate(javax.resource.cci.Interaction interaction,javax.resource.cci.InteractionSpec ispec,javax.resource.cci.IndexedRecord[] inputRecord)
|
|
executeFinder(javax.resource.cci.Interaction interaction,javax.resource.cci.InteractionSpec ispec,javax.resource.cci.IndexedRecord inputRecord)
|
|
executeOther(javax.resource.cci.Interaction interaction,javax.resource.cci.InteractionSpec ispec,javax.resource.cci.IndexedRecord inputRecord)
|
|
executeOther(javax.resource.cci.Interaction interaction,javax.resource.cci.InteractionSpec ispec,javax.resource.cci.IndexedRecord[] inputRecord)
|
|
executeReadReadChecking(javax.resource.cci.Interaction interaction,javax.resource.cci.InteractionSpec ispec,javax.resource.cci.IndexedRecord[] inputRecord)
Using the given Interaction object, call the "executeBatchRead(InteractionSpec ispec, Record inrec)" method with the given
InteractionSpec and input Record;
no Record should be returned from this call, instead a boolean array is returned.
|
|
executeRemove(javax.resource.cci.Interaction interaction,javax.resource.cci.InteractionSpec ispec,javax.resource.cci.IndexedRecord[] inputRecord,javax.resource.cci.IndexedRecord[] predicates)
|
|
executeRemove(javax.resource.cci.Interaction interaction,javax.resource.cci.InteractionSpec ispec,javax.resource.cci.IndexedRecord inputRecord,javax.resource.cci.IndexedRecord predicates)
|
|
executeUpdate(javax.resource.cci.Interaction interaction,javax.resource.cci.InteractionSpec ispec,javax.resource.cci.IndexedRecord[] inputRecord,javax.resource.cci.IndexedRecord[] predicates,boolean[][] dirtyBits,java.lang.String cursorName)
|
|
executeUpdate(javax.resource.cci.Interaction interaction,javax.resource.cci.InteractionSpec ispec,javax.resource.cci.IndexedRecord inputRecord,javax.resource.cci.IndexedRecord predicates,boolean[] dirtyBits,java.lang.String cursorName)
|
|
getConnection(javax.resource.cci.ConnectionFactory connectionFactory,com.ibm.websphere.appprofile.accessintent.AccessIntent accessIntent)
|
|
getLockType(javax.resource.cci.ConnectionFactory connFactory,com.ibm.websphere.appprofile.accessintent.AccessIntent accessIntent)
|
|
getNativeConnection(javax.resource.cci.Connection cciConnection)
|
|
getRecordFactory(javax.resource.cci.ConnectionFactory connectionFactory)
|
|
getTracer()
This method gets the trace component.
|
|
isBatchSupported(javax.resource.cci.ConnectionFactory connectionFactory,com.ibm.websphere.appprofile.accessintent.AccessIntent accessIntent)
|
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Methods inherited from interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter |
|---|
getLockType |
Constructor Detail
WSEJBToRAAdapter
- protected WSEJBToRAAdapter()
Method Detail
checkBackendId
- public boolean checkBackendId(javax.resource.cci.ConnectionFactory connectionFactory,
- java.lang.String backendId)
- throws javax.resource.ResourceException
checkBackendId in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
connectionFactory - the connection factory backendId - the bankend ID javax.resource.ResourceExceptionEJBToRAAdapter.checkBackendId(javax.resource.cci.ConnectionFactory, String)createInteraction
- public javax.resource.cci.Interaction createInteraction( javax.resource.cci.Connection conn)
- throws javax.resource.ResourceException
createInteraction in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
conn - javax.resource.cci.Connection see J2EE Connector spec, CCI javax.resource.ResourceExceptionNote: WSRelationalRAAdapter overrides this method to set the AccessIntent in
the Interaction [d193047.1]
createInteraction
- public javax.resource.cci.Interaction createInteraction( javax.resource.cci.Connection conn,
- com.ibm.websphere.appprofile.accessintent.AccessIntent intent,
- java.util.HashMap properties)
- throws javax.resource.ResourceException
createInteraction in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
conn - javax.resource.cci.Connection see J2EE Connector spec, CCI intent - the AccessIntent in effect for this operation. The values in intent shall be used
as necessary when executing the returned interaction. The values include choice of pessimistic versus
optimistic access, intent to read versus update the data, and others. See the javadoc for AccessIntent
for additional details. javax.resource.ResourceExceptionNote: WSRelationalRAAdapter and WSProceduralRAAdapter overrides this method to
set the AccessIntent in the Interaction [d193047.1]
executeCreate
- public javax.resource.cci.Record executeCreate( javax.resource.cci.Interaction interaction,
- javax.resource.cci.InteractionSpec ispec,
- javax.resource.cci.IndexedRecord inputRecord)
- throws javax.ejb.CreateException
- javax.resource.ResourceException
executeCreate in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
interaction - javax.resource.cci.Interaction the interaction to call "execute(...)" on ispec - javax.resource.cci.InteractionSpec see J2EE Connector spec, CCI inputRecord - javax.resource.cci.IndexedRecord see J2EE Connector spec, CCI javax.ejb.CreateExceptionjavax.resource.ResourceExceptionEJBToRAAdapter.executeCreate(Interaction, InteractionSpec, IndexedRecord)executeFinder
- public javax.resource.cci.Record executeFinder( javax.resource.cci.Interaction interaction,
- javax.resource.cci.InteractionSpec ispec,
- javax.resource.cci.IndexedRecord inputRecord)
- throws javax.ejb.FinderException
- javax.resource.ResourceException
executeFinder in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
interaction - javax.resource.cci.Interaction the interaction to call "execute(...)" on ispec - javax.resource.cci.InteractionSpec see J2EE Connector spec, CCI inputRecord - javax.resource.cci.IndexedRecord see J2EE Connector spec, CCI javax.resource.ResourceException - The exception description. javax.ejb.FinderExceptionjavax.resource.ResourceExceptionEJBToRAAdapter.executeFinder(Interaction, InteractionSpec, IndexedRecord)executeRemove
- public javax.resource.cci.Record executeRemove( javax.resource.cci.Interaction interaction,
- javax.resource.cci.InteractionSpec ispec,
- javax.resource.cci.IndexedRecord inputRecord,
- javax.resource.cci.IndexedRecord predicates)
- throws javax.ejb.RemoveException
- javax.resource.ResourceException
executeRemove in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
interaction - javax.resource.cci.Interaction the interaction this method should call "execute(...)" on ispec - javax.resource.cci.InteractionSpec see J2EE Connector spec, CCI inputRecord - javax.resource.cci.Record input Record, see J2EE Connector spec, CCI predicates - javax.resource.ResourceException - The exception description. javax.ejb.RemoveExceptionjavax.resource.ResourceExceptionEJBToRAAdapter.executeRemove(Interaction, InteractionSpec, IndexedRecord, IndexedRecord)executeUpdate
- public javax.resource.cci.Record executeUpdate( javax.resource.cci.Interaction interaction,
- javax.resource.cci.InteractionSpec ispec,
- javax.resource.cci.IndexedRecord inputRecord,
- javax.resource.cci.IndexedRecord predicates,
- boolean[] dirtyBits,
- java.lang.String cursorName)
- throws javax.ejb.EJBException
- javax.resource.ResourceException
executeUpdate in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
interaction - javax.resource.cci.Interaction the interaction this method should call "execute(...)" on ispec - javax.resource.cci.InteractionSpec see J2EE Connector spec, CCI inputRecord - javax.resource.cci.Record input Record, see J2EE Connector spec, CCI predicates - dirtyBits - cursorName - java.lang.String an optional cursor name, obtained by PM runtime via a call to
java.sql.ResultSet.getCursorName(), using the ResultSet which contains the bean/row being updated.
This parameter is used to perform "positional update", a more efficient data updating mechanism supported
by certain Resource Managers (mostly, relational databases). If a Resource Adapter does not support
positioned update then this parameter can be ignored. javax.resource.ResourceException - The exception description. javax.ejb.EJBExceptionjavax.resource.ResourceExceptionEJBToRAAdapter.executeUpdate(Interaction, InteractionSpec, IndexedRecord, IndexedRecord, boolean[], String)executeOther
- public javax.resource.cci.Record executeOther( javax.resource.cci.Interaction interaction,
- javax.resource.cci.InteractionSpec ispec,
- javax.resource.cci.IndexedRecord inputRecord)
- throws javax.resource.ResourceException
executeOther in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
interaction - javax.resource.cci.Interaction the interaction this method should call "execute(...)" on ispec - javax.resource.cci.InteractionSpec see J2EE Connector spec, CCI inputRecord - javax.resource.cci.IndexedRecord see J2EE Connector spec, CCI
This method is used for executing interactions other than the currently defeined ones (create, finder, etc).
This will immediately be used for updating the Many-Many Auxilary tables. The value returned from this execution
must be null javax.resource.ResourceExceptionEJBToRAAdapter.executeOther(Interaction, InteractionSpec, IndexedRecord)getConnection
- public abstract javax.resource.cci.Connection getConnection( javax.resource.cci.ConnectionFactory connectionFactory,
- com.ibm.websphere.appprofile.accessintent.AccessIntent accessIntent)
- throws javax.resource.ResourceException
getConnection in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
connectionFactory - javax.resource.cci.ConnectionFactory see J2EE Connector spec, CCI accessIntent - com.ibm.ws.ejbpersistence.AccessIntent data class to hold
access-intent-related info of potential use by any Resource Adapter. This method uses this
parameter to locate a possible cached connection suitable for use with this AccessIntent.
If there is no such cached connection, PM obtains one and caches it for future use. javax.resource.ResourceExceptionEJBToRAAdapter.getConnection(ConnectionFactory, AccessIntent)getNativeConnection
- public java.lang.Object getNativeConnection( javax.resource.cci.Connection cciConnection)
getNativeConnection in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
EJBToRAAdapter.getNativeConnection(javax.resource.cci.Connection)getLockType
- public int getLockType(javax.resource.cci.ConnectionFactory connFactory,
- com.ibm.websphere.appprofile.accessintent.AccessIntent accessIntent)
getLockType in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
accessIntent - com.ibm.ws.ejbpersistence.AccessIntent data class to hold
access-intent-related info of potential use by any Resource Adapter. This method uses this
parameter to locate a possible cached connection suitable for use with this AccessIntent.
If there is no such cached connection, PM obtains one and caches it for future use. EJBToRAAdapter.getLockType(ConnectionFactory, AccessIntent)getRecordFactory
- public javax.resource.cci.RecordFactory getRecordFactory( javax.resource.cci.ConnectionFactory connectionFactory)
- throws javax.resource.ResourceException
getRecordFactory in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
connectionFactory - javax.resource.cci.ConnectionFactory see J2EE Connector spec, CCI javax.resource.ResourceExceptionEJBToRAAdapter.getRecordFactory(ConnectionFactory)executeCreate
- public javax.resource.cci.Record executeCreate( javax.resource.cci.Interaction interaction,
- javax.resource.cci.InteractionSpec ispec,
- javax.resource.cci.IndexedRecord[] inputRecord)
- throws javax.ejb.CreateException
- javax.resource.ResourceException
executeCreate in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
interaction - javax.resource.cci.Interaction: an array of the the interaction to call "execute(...)" ispec - javax.resource.cci.InteractionSpec an array of the interactionSpecs, see J2EE Connector spec, CCI inputRecord - javax.resource.cci.IndexedRecord an array of the indexedRecord, see J2EE Connector spec, CCI javax.ejb.CreateExceptionjavax.resource.ResourceExceptionEJBToRAAdapter.executeCreate(Interaction, InteractionSpec, IndexedRecord[])executeRemove
- public javax.resource.cci.Record executeRemove( javax.resource.cci.Interaction interaction,
- javax.resource.cci.InteractionSpec ispec,
- javax.resource.cci.IndexedRecord[] inputRecord,
- javax.resource.cci.IndexedRecord[] predicates)
- throws javax.ejb.RemoveException
- javax.resource.ResourceException
executeRemove in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
interaction - javax.resource.cci.Interaction: the interaction to call "execute(...)" ispec - javax.resource.cci.InteractionSpec the interactionSpecs, see J2EE Connector spec, CCI inputRecord - javax.resource.cci.IndexedRecord an array of the indexedRecord, see J2EE Connector spec, CCI predicates - javax.resource.cci.IndexedRecord[]: predicates an array of the indexedRecord, see J2EE Connector spec, CCI javax.resource.ResourceExceptionjavax.ejb.RemoveExceptionEJBToRAAdapter.executeRemove(Interaction, InteractionSpec, IndexedRecord[], IndexedRecord[])executeUpdate
- public javax.resource.cci.Record executeUpdate( javax.resource.cci.Interaction interaction,
- javax.resource.cci.InteractionSpec ispec,
- javax.resource.cci.IndexedRecord[] inputRecord,
- javax.resource.cci.IndexedRecord[] predicates,
- boolean[][] dirtyBits,
- java.lang.String cursorName)
- throws javax.ejb.EJBException
- javax.resource.ResourceException
executeUpdate in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
interaction - javax.resource.cci.Interaction: the interaction to call "execute(...)" ispec - javax.resource.cci.InteractionSpec the interactionSpecs, see J2EE Connector spec, CCI inputRecord - javax.resource.cci.IndexedRecord an array of the indexedRecord, see J2EE Connector spec, CCI predicates - javax.resource.cci.IndexedRecord[]: predicates an array of the indexedRecord, see J2EE Connector spec, CCI dirtyBits - boolean[]: not used corrently, but will be used for partial updated cursorName - javax.ejb.EJBExceptionjavax.resource.ResourceExceptionEJBToRAAdapter.executeUpdate(Interaction, InteractionSpec, IndexedRecord[], IndexedRecord[], boolean[][], String)executeOther
- public javax.resource.cci.Record executeOther( javax.resource.cci.Interaction interaction,
- javax.resource.cci.InteractionSpec ispec,
- javax.resource.cci.IndexedRecord[] inputRecord)
- throws javax.resource.ResourceException
executeOther in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
interaction - javax.resource.cci.Interaction: the interaction to call "execute(...)" ispec - javax.resource.cci.InteractionSpec the interactionSpecs, see J2EE Connector spec, CCI inputRecord - javax.resource.cci.IndexedRecord an array of the indexedRecord, see J2EE Connector spec, CCI javax.resource.ResourceExceptionEJBToRAAdapter.executeOther(Interaction, InteractionSpec, IndexedRecord[])isBatchSupported
- public boolean isBatchSupported( javax.resource.cci.ConnectionFactory connectionFactory,
- com.ibm.websphere.appprofile.accessintent.AccessIntent accessIntent)
isBatchSupported in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
connectionFactory - accessIntent - EJBToRAAdapter.isBatchSupported(ConnectionFactory, AccessIntent)getTracer
- protected com.ibm.ejs.ras.TraceComponent getTracer( )
This method gets the trace component. This method is used for get the trace component of the subclasses. Some methods are inherited by the subclasses. When these inherited methods are called via the subclass, we need to get the trace component of the subclass so the class names of the subclasses is displayed in the trace.
executeReadReadChecking
- public boolean[] executeReadReadChecking( javax.resource.cci.Interaction interaction,
- javax.resource.cci.InteractionSpec ispec,
- javax.resource.cci.IndexedRecord[] inputRecord)
- throws javax.ejb.EJBException
- javax.resource.ResourceException
executeReadReadChecking in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
interaction - javax.resource.cci.Interaction: an array of the the interaction to call "execute(...)" ispec - javax.resource.cci.InteractionSpec an array of the interactionSpecs, see J2EE Connector spec, CCI inputRecord - javax.resource.cci.IndexedRecord an array of the indexedRecord, see J2EE Connector spec, CCI javax.resource.ResourceExceptionjavax.ejb.EJBException