com.infoengine.connector
Class PhysicalConnection

java.lang.Object
  com.infoengine.connector.PhysicalConnection

Direct Known Subclasses:

HTTPConnection, JMSConnection

abstract class PhysicalConnection

extends Object

represents a physical connection

Field Summary

protected IeConnectionRequestInfo	cxRequestInfo
protected Log	log
protected IeManagedConnection	managedCx
protected Subject	subject

Constructor Summary

(package private)

PhysicalConnection() create a new PhysicalConnection and initialize instance variables

Method Summary

(package private) abstract void	destroy() destroy this physical connection
protected String[]	extractCredentials()
(package private) IeConnectionRequestInfo	getRequestInfo()
(package private) abstract void	init() initialize the connection
(package private) abstract javax.xml.soap.SOAPMessage	invoke(javax.xml.soap.SOAPMessage msg) send a SOAPMessage to an endPoint
(package private) boolean	match(Subject s, javax.resource.spi.ConnectionRequestInfo cri) does this connection match these criteria
(package private) void	setLog(Log l)
(package private) void	setManagedConnection(IeManagedConnection managed)
(package private) void	setRequestInfo(IeConnectionRequestInfo info)
(package private) void	setSubject(Subject s)
protected Throwable	unwrapSOAPException(javax.xml.soap.SOAPException soapE) extract root exception

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

managedCx

protected IeManagedConnection managedCx

subject

protected Subject subject

cxRequestInfo

protected IeConnectionRequestInfo cxRequestInfo

log

protected Log log

Constructor Detail

PhysicalConnection

PhysicalConnection()

create a new PhysicalConnection and initialize instance variables

Method Detail

setManagedConnection

void setManagedConnection(IeManagedConnection managed)

Parameters:

managed - IeManagedConnection instance

setSubject

void setSubject(Subject s)

Parameters:

s - security credentials

setLog

void setLog(Log l)

Parameters:

l - Log

setRequestInfo

void setRequestInfo(IeConnectionRequestInfo info)

Parameters:

info - connection request info

getRequestInfo

IeConnectionRequestInfo getRequestInfo()

Returns:

IeConnectionRequestInfo the request info object

init

abstract void init()
            throws javax.resource.ResourceException

initialize the connection

Throws:

javax.resource.ResourceException

invoke

abstract javax.xml.soap.SOAPMessage invoke(javax.xml.soap.SOAPMessage msg)
                                    throws Exception

send a SOAPMessage to an endPoint

Parameters:

msg - message to send

Returns:

SOAPMessage response

Throws:

Exception - if error occurs (implementor should unwrap)

destroy

abstract void destroy()
               throws Exception

destroy this physical connection

Throws:

Exception

match

boolean match(Subject s,
              javax.resource.spi.ConnectionRequestInfo cri)
        throws PrivilegedActionException

does this connection match these criteria

Parameters:

s - security credentials

cri - connection request info

Returns:

boolean

Throws:

PrivilegedActionException

unwrapSOAPException

protected Throwable unwrapSOAPException(javax.xml.soap.SOAPException soapE)

extract root exception

Parameters:

soapE - SOAPException to unwrap

Returns:

Throwable

extractCredentials

protected String[] extractCredentials()
                               throws PrivilegedActionException

Throws:

PrivilegedActionException