|
Sun Adapter for COM/DCOM API | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.stc.connector.comadapter.eway.ComEwayConnection
public class ComEwayConnection
This class implements the EwayConnection interface for the ETD. It is required that it has a public constructor without arguments.
Constructor Summary | |
---|---|
ComEwayConnection()
Creates a new instance of EtdEwayConnection |
Method Summary | |
---|---|
void |
cleanup()
Perform clean up of any resources or reset of any state held by the instance of EwayConnection. |
STCIDispatch |
create(java.lang.String clsidString,
java.lang.String server)
Call this method to create an instance of the COM object specified by the CLSID string and server (if DCOM component) overriding the default server in the eWay configuration. |
void |
destroy()
Release any resources prior to the destruction of the associated ManagedConnection. |
com.stc.connector.framework.client.AssociateableHandle |
getConnection(javax.security.auth.Subject subject,
javax.resource.spi.ConnectionRequestInfo cri)
Get a new instance of the connection handle (application connection). |
javax.resource.spi.LocalTransaction |
getLocalTransaction()
Get a LocalTransaction instance for local transaction demarcation. |
javax.resource.spi.ManagedConnectionMetaData |
getMetaData()
Get a new instance of the ManagedConnectionMetaData which contains connection information for the currently established connection. |
com.stc.connector.management.util.ObjectReference |
getMonitor()
|
javax.transaction.xa.XAResource |
getXAResource()
Get an XAResource instance for global transaction demaracation. |
void |
initialize(com.stc.connector.framework.eway.ManagedConnectionCallback aCallback,
javax.security.auth.Subject aSubject,
javax.resource.spi.ConnectionRequestInfo aConfiguration,
com.stc.connector.management.jca.system.mbeans.MonitorDataContainer aMonitorDataContainer)
Initialize the EwayConnection. |
boolean |
isValidConnection()
This method is used by the framework to determine whether the EwayConnection is still valid (ie, unrecoverable connection error). |
boolean |
matchConnection(javax.security.auth.Subject subject,
javax.resource.spi.ConnectionRequestInfo cri)
Determines whether this instance of the EwayConnection matches the the connection request with the connection information in Subject and/or ConnectionRequestInfo. |
java.lang.String |
resolveSystemErrorText(int hr)
A convenience method exposed to allow the user to get the error text for an HRESULT. |
void |
setMonitor(com.stc.connector.management.util.ObjectReference mbean)
|
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public ComEwayConnection()
Method Detail |
---|
public void initialize(com.stc.connector.framework.eway.ManagedConnectionCallback aCallback, javax.security.auth.Subject aSubject, javax.resource.spi.ConnectionRequestInfo aConfiguration, com.stc.connector.management.jca.system.mbeans.MonitorDataContainer aMonitorDataContainer) throws javax.resource.ResourceException
initialize
in interface com.stc.connector.framework.eway.EwayConnection
mcCallback
- The callback object for getting services from the
associated ManagedConnection.subject
- The Subject instance which holds the credentials for EIS
signon.aConfiguration
- The ConnectionRequestInfo instance which can hold both EIS
signon information or general connection specific information.
The ConnectionRequestInfo provided will contain the union of the
properties from the client connection request properties, the
ResourceAdapter properties, and the ManagedConnectionFactory
properties.
javax.resource.ResourceException
- upon error.public boolean matchConnection(javax.security.auth.Subject subject, javax.resource.spi.ConnectionRequestInfo cri)
matchConnection
in interface com.stc.connector.framework.eway.EwayConnection
subject
- The Subject instance which holds the credentials for EIS
signon.cri
- The ConnectionRequestInfo instance which holds both EIS EIS
signon information or general connection specific information.
The ConnectionRequestInfo provided will contain the union of the
properties from the client connection request properties, the
ResourceAdapter properties, and the ManagedConnectionFactory
properties.
public com.stc.connector.framework.client.AssociateableHandle getConnection(javax.security.auth.Subject subject, javax.resource.spi.ConnectionRequestInfo cri) throws javax.resource.ResourceException
getConnection
in interface com.stc.connector.framework.eway.EwayConnection
subject
- The Subject instance which holds the credentials for EIS
signon.cri
- The ConnectionRequestInfo instance which holds both EIS EIS
signon information or general connection specific information.
The ConnectionRequestInfo provided will contain the union of the
properties from the client connection request properties, the
ResourceAdapter properties, and the ManagedConnectionFactory
properties.
javax.resource.ResourceException
- upon error.public void cleanup() throws javax.resource.ResourceException
cleanup
in interface com.stc.connector.framework.eway.EwayConnection
javax.resource.ResourceException
- upon error.public void destroy() throws javax.resource.ResourceException
destroy
in interface com.stc.connector.framework.eway.EwayConnection
javax.resource.ResourceException
- upon error.public javax.resource.spi.LocalTransaction getLocalTransaction() throws javax.resource.ResourceException
getLocalTransaction
in interface com.stc.connector.framework.eway.EwayConnection
javax.resource.ResourceException
- upon error.public javax.resource.spi.ManagedConnectionMetaData getMetaData() throws javax.resource.ResourceException
getMetaData
in interface com.stc.connector.framework.eway.EwayConnection
javax.resource.ResourceException
- upon error.public javax.transaction.xa.XAResource getXAResource() throws javax.resource.ResourceException
getXAResource
in interface com.stc.connector.framework.eway.EwayConnection
javax.resource.ResourceException
- upon error.public STCIDispatch create(java.lang.String clsidString, java.lang.String server) throws STCComException
Call this method to create an instance of the COM object specified by the CLSID string and server (if DCOM component) overriding the default server in the eWay configuration.
clsidString
- The CLSID string of the COM object you wish to create.
Note that the component must be automation-compatible.server
- The server on which the DCOM component resides.
ComApplicationException
- if creation of the instance fails.
STCComException
public java.lang.String resolveSystemErrorText(int hr)
FormatMessage
method in the Win32 API.
public void setMonitor(com.stc.connector.management.util.ObjectReference mbean)
setMonitor
in interface com.stc.connector.management.STCManagedSlave
public com.stc.connector.management.util.ObjectReference getMonitor()
public boolean isValidConnection()
isValidConnection
in interface com.stc.connector.framework.eway.ValidatingEwayConnection
|
Sun Adapter for COM/DCOM API | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |