|
IBM WebSphere Application ServerTM Release 8 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.ibm.wsspi.ejbpersistence.WSEJBToRAAdapter
public abstract class WSEJBToRAAdapter
This is the default implementation for the EJBToRAAdapter interface. Third party RA suppliers must implement EJBToRAAdapter interface or extend this class.
EJBToRAAdapter
Field 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 | |
---|---|
protected |
WSEJBToRAAdapter()
default Constructor |
Method Summary | |
---|---|
boolean |
checkBackendId(javax.resource.cci.ConnectionFactory connectionFactory,
java.lang.String backendId)
|
javax.resource.cci.Interaction |
createInteraction(javax.resource.cci.Connection conn)
Deprecated. |
javax.resource.cci.Interaction |
createInteraction(javax.resource.cci.Connection conn,
com.ibm.websphere.appprofile.accessintent.AccessIntent intent,
java.util.HashMap properties)
|
javax.resource.cci.Record |
executeCreate(javax.resource.cci.Interaction interaction,
javax.resource.cci.InteractionSpec ispec,
javax.resource.cci.IndexedRecord inputRecord)
|
javax.resource.cci.Record |
executeCreate(javax.resource.cci.Interaction interaction,
javax.resource.cci.InteractionSpec ispec,
javax.resource.cci.IndexedRecord[] inputRecord)
|
javax.resource.cci.Record |
executeFinder(javax.resource.cci.Interaction interaction,
javax.resource.cci.InteractionSpec ispec,
javax.resource.cci.IndexedRecord inputRecord)
|
javax.resource.cci.Record |
executeOther(javax.resource.cci.Interaction interaction,
javax.resource.cci.InteractionSpec ispec,
javax.resource.cci.IndexedRecord inputRecord)
|
javax.resource.cci.Record |
executeOther(javax.resource.cci.Interaction interaction,
javax.resource.cci.InteractionSpec ispec,
javax.resource.cci.IndexedRecord[] inputRecord)
|
boolean[] |
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. |
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)
|
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)
|
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)
|
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)
|
abstract javax.resource.cci.Connection |
getConnection(javax.resource.cci.ConnectionFactory connectionFactory,
com.ibm.websphere.appprofile.accessintent.AccessIntent accessIntent)
|
int |
getLockType(javax.resource.cci.ConnectionFactory connFactory,
com.ibm.websphere.appprofile.accessintent.AccessIntent accessIntent)
|
java.lang.Object |
getNativeConnection(javax.resource.cci.Connection cciConnection)
|
javax.resource.cci.RecordFactory |
getRecordFactory(javax.resource.cci.ConnectionFactory connectionFactory)
|
protected com.ibm.ejs.ras.TraceComponent |
getTracer()
This method gets the trace component. |
boolean |
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 |
---|
protected WSEJBToRAAdapter()
Method Detail |
---|
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 factorybackendId
- the bankend ID
javax.resource.ResourceException
EJBToRAAdapter.checkBackendId(javax.resource.cci.ConnectionFactory, String)
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, CCIintent
- 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.ResourceException
Note: WSRelationalRAAdapter overrides this method to set the AccessIntent in
the Interaction [d193047.1]
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, CCIintent
- 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.ResourceException
Note: WSRelationalRAAdapter and WSProceduralRAAdapter overrides this method to
set the AccessIntent in the Interaction [d193047.1]
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(...)" onispec
- javax.resource.cci.InteractionSpec see J2EE Connector spec, CCIinputRecord
- javax.resource.cci.IndexedRecord see J2EE Connector spec, CCI
javax.ejb.CreateException
javax.resource.ResourceException
EJBToRAAdapter.executeCreate(Interaction, InteractionSpec, IndexedRecord)
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(...)" onispec
- javax.resource.cci.InteractionSpec see J2EE Connector spec, CCIinputRecord
- javax.resource.cci.IndexedRecord see J2EE Connector spec, CCI
javax.resource.ResourceException
- The exception description.
javax.ejb.FinderException
javax.resource.ResourceException
EJBToRAAdapter.executeFinder(Interaction, InteractionSpec, IndexedRecord)
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(...)" onispec
- javax.resource.cci.InteractionSpec see J2EE Connector spec, CCIinputRecord
- javax.resource.cci.Record input Record, see J2EE Connector spec, CCIpredicates
-
javax.resource.ResourceException
- The exception description.
javax.ejb.RemoveException
javax.resource.ResourceException
EJBToRAAdapter.executeRemove(Interaction, InteractionSpec, IndexedRecord, IndexedRecord)
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(...)" onispec
- javax.resource.cci.InteractionSpec see J2EE Connector spec, CCIinputRecord
- javax.resource.cci.Record input Record, see J2EE Connector spec, CCIpredicates
- 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.EJBException
javax.resource.ResourceException
EJBToRAAdapter.executeUpdate(Interaction, InteractionSpec, IndexedRecord, IndexedRecord, boolean[], String)
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(...)" onispec
- javax.resource.cci.InteractionSpec see J2EE Connector spec, CCIinputRecord
- 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.ResourceException
EJBToRAAdapter.executeOther(Interaction, InteractionSpec, IndexedRecord)
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, CCIaccessIntent
- 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.ResourceException
EJBToRAAdapter.getConnection(ConnectionFactory, AccessIntent)
public java.lang.Object getNativeConnection(javax.resource.cci.Connection cciConnection)
getNativeConnection
in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
a
- CCI Connection (preferably a RdbConnectionImpl)
EJBToRAAdapter.getNativeConnection(javax.resource.cci.Connection)
public int getLockType(javax.resource.cci.ConnectionFactory connFactory, com.ibm.websphere.appprofile.accessintent.AccessIntent accessIntent)
getLockType
in interface com.ibm.websphere.ejbpersistence.EJBToRAAdapter
connectionFactory
- javax.resource.cci.ConnectionFactory see J2EE Connector spec, CCIaccessIntent
- 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)
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.ResourceException
EJBToRAAdapter.getRecordFactory(ConnectionFactory)
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, CCIinputRecord
- javax.resource.cci.IndexedRecord an array of the indexedRecord, see J2EE Connector spec, CCI
javax.ejb.CreateException
javax.resource.ResourceException
EJBToRAAdapter.executeCreate(Interaction, InteractionSpec, IndexedRecord[])
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, CCIinputRecord
- javax.resource.cci.IndexedRecord an array of the indexedRecord, see J2EE Connector spec, CCIpredicates
- javax.resource.cci.IndexedRecord[]: predicates an array of the indexedRecord, see J2EE Connector spec, CCI
javax.resource.ResourceException
javax.ejb.RemoveException
EJBToRAAdapter.executeRemove(Interaction, InteractionSpec, IndexedRecord[], IndexedRecord[])
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, CCIinputRecord
- javax.resource.cci.IndexedRecord an array of the indexedRecord, see J2EE Connector spec, CCIpredicates
- javax.resource.cci.IndexedRecord[]: predicates an array of the indexedRecord, see J2EE Connector spec, CCIdirtyBits
- boolean[]: not used corrently, but will be used for partial updatedcursorName
-
javax.ejb.EJBException
javax.resource.ResourceException
EJBToRAAdapter.executeUpdate(Interaction, InteractionSpec, IndexedRecord[], IndexedRecord[], boolean[][], String)
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, CCIinputRecord
- javax.resource.cci.IndexedRecord an array of the indexedRecord, see J2EE Connector spec, CCI
javax.resource.ResourceException
EJBToRAAdapter.executeOther(Interaction, InteractionSpec, IndexedRecord[])
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)
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.
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, CCIinputRecord
- javax.resource.cci.IndexedRecord an array of the indexedRecord, see J2EE Connector spec, CCI
javax.resource.ResourceException
javax.ejb.EJBException
|
IBM WebSphere Application ServerTM Release 8 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |