|
Sun Adapter for MSMQ API | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectcom.stc.connector.msmqadapter.ewayconn.MSMQEwayConnection
public class MSMQEwayConnection
This class implements the EwayConnection interface for MSMQ. It is required that it has a public constructor without arguments.
| Constructor Summary | |
|---|---|
MSMQEwayConnection()
Creates a new instance of MSMQEwayConnection |
|
| Method Summary | |
|---|---|
void |
cleanup()
Perform clean up of any resources or reset of any state held by the instance of EwayConnection. |
void |
connect()
Creates the physical connection to the underlying EIS system. |
void |
destroy()
Release any resources prior to the destruction of the associated ManagedConnection. |
void |
disconnect()
Closes(destroys) the physical connection to the underlying EIS system. |
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 demaracation. |
byte[] |
getMessage()
|
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()
Obtain the management object for this object. |
javax.transaction.xa.XAResource |
getXAResource()
Get an XAResource instance for global transaction demarcation. |
void |
initialize(com.stc.connector.framework.eway.ManagedConnectionCallback mcCallback,
javax.security.auth.Subject subject,
javax.resource.spi.ConnectionRequestInfo cri,
com.stc.connector.management.jca.system.mbeans.MonitorDataContainer mdc)
Initialize the EwayConnection. |
boolean |
isValidConnection()
This method is used by the framework to determine whether the MQ connection is still valid (ie, unrecoverable connection error). |
boolean |
matchConnection(javax.security.auth.Subject aSubject,
javax.resource.spi.ConnectionRequestInfo criInVar)
Determines whether this instance of the EwayConnection matches the the connection request with the connection information in Subject and/or ConnectionRequestInfo. |
long |
putMessage(byte[] payload)
|
void |
setMonitor(com.stc.connector.management.util.ObjectReference mbean)
Implementing the STCManagedSlave interface to allow registration of a callback (as a MBean), so that the connector framework can initialize the MBean for this connection. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public MSMQEwayConnection()
| Method Detail |
|---|
public void initialize(com.stc.connector.framework.eway.ManagedConnectionCallback mcCallback,
javax.security.auth.Subject subject,
javax.resource.spi.ConnectionRequestInfo cri,
com.stc.connector.management.jca.system.mbeans.MonitorDataContainer mdc)
throws javax.resource.ResourceException
initialize in interface com.stc.connector.framework.eway.EwayConnectionmcCallback - The callback object for getting services from the
associated ManagedConnection.subject - The Subject instance which holds the credentials for EIS
signon.cri - 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 aSubject,
javax.resource.spi.ConnectionRequestInfo criInVar)
matchConnection in interface com.stc.connector.framework.eway.EwayConnectionsubject - The Subject instance which holds the credentials for EIS
signon.cri - The ConnectionRequestInfo instance which holds 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.
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.EwayConnectionsubject - 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.EwayConnectionjavax.resource.ResourceException - upon error.
public void destroy()
throws javax.resource.ResourceException
destroy in interface com.stc.connector.framework.eway.EwayConnectionjavax.resource.ResourceException - upon error.
public javax.resource.spi.LocalTransaction getLocalTransaction()
throws javax.resource.ResourceException
getLocalTransaction in interface com.stc.connector.framework.eway.EwayConnectionjavax.resource.ResourceException - upon error.
public javax.resource.spi.ManagedConnectionMetaData getMetaData()
throws javax.resource.ResourceException
com.stc.connector.framework.jca.system.STCManagedConnectionMetaData
for details.
getMetaData in interface com.stc.connector.framework.eway.EwayConnectionjavax.resource.ResourceException - upon error.
public javax.transaction.xa.XAResource getXAResource()
throws javax.resource.ResourceException
getXAResource in interface com.stc.connector.framework.eway.EwayConnectionjavax.resource.ResourceException - if an error occurs.public void setMonitor(com.stc.connector.management.util.ObjectReference mbean)
setMonitor in interface com.stc.connector.management.STCManagedSlavembean - the mbean to be set by the frameworkpublic com.stc.connector.management.util.ObjectReference getMonitor()
Monitor or null if there is no
designated management object.
public void connect()
throws java.lang.Exception
application - specific Exceptions upon error.
java.lang.Exception
public void disconnect()
throws java.lang.Exception
application - specific Exceptions upon error.
java.lang.Exception
public byte[] getMessage()
throws javax.resource.ResourceException
javax.resource.ResourceException
public long putMessage(byte[] payload)
throws javax.resource.ResourceException
javax.resource.ResourceExceptionpublic boolean isValidConnection()
|
Sun Adapter for MSMQ API | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||