gov.va.med.vistalink.adapter.spi

Class VistaLinkConnectionImpl

Object

VistaLinkConnectionImpl

All Implemented Interfaces:

VistaLinkConnection, Connection

public class VistaLinkConnectionImpl
extends Object
implements VistaLinkConnection

This implementation class represents an application level connection handle that is used by a component to access an EIS instance.

J2SE Example:

// login to server
loginContext.login();

//Gets the principal that contains the VistaLinkConnection
VistaKernelPrincipalImpl myPrincipal = VistaKernelPrincipalImpl.
getKernelPrincipal(loginContext.getSubject());

//Get the VistaLinkConnection
VistaLinkConnection myConnection = myPrincipal.getAuthenticatedConnection();

//request and response objects
RpcRequest vReq = null;
RpcResponse vResp = null;

//The Rpc Context
String rpcContext = "XOBV VISTALINK TESTER";

//The Rpc to call
String rpcName = "XOBV TEST PING";

//Construct the request object
vReq = RpcRequestFactory.getRpcRequest(rpcContext, rpcName);

<b> //Execute the Rpc and get the response
vResp = myConnection.executeRPC(vReq);

//Work with the response ...

Constructor Summary

Constructors

Constructor and Description
VistaLinkConnectionImpl(VistaLinkManagedConnection mc) This constructor should not be called directly.

Method Summary

Modifier and Type	Method and Description
void	close() Closes this connection handle.
Interaction	createInteraction() Empty method. throws NotSupportedException
VistaLinkResponseVO	executeInteraction(VistaLinkRequestVO requestVO, VistaLinkResponseFactory responseFactory) Executes an interaction with M
RpcResponse	executeRPC(RpcRequest request) Executes an interaction with M using the RpcResponseFactory to construct a response.
VistaLinkServerInfo	getConnectionInfo() Returns connection information about the host
LocalTransaction	getLocalTransaction() Empty method. throws NotSupportedException
VistaLinkManagedConnection	getManagedConnection() This method should not be called directly.
ConnectionMetaData	getMetaData() Gets the meta-information on the underlying EIS instance via this connection
ResultSetInfo	getResultSetInfo() Empty method. throws NotSupportedException
int	getTimeOut() Returns current connection time out value.
void	setManagedConnection(VistaLinkManagedConnection mc) This method should not be called directly.
void	setTimeOut(int timeOut) Use to set time out for read operations on connections

Methods inherited from class Object

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

Constructor Detail

VistaLinkConnectionImpl

public VistaLinkConnectionImpl(VistaLinkManagedConnection mc)

This constructor should not be called directly. Used by spi classes.

Parameters:

mc -

Method Detail

close

public void close()
           throws ResourceException

Closes this connection handle. Informs the managed connection that this handle is closed

Specified by:

close in interface Connection

Throws:

ResourceException

executeInteraction

public VistaLinkResponseVO executeInteraction(VistaLinkRequestVO requestVO,
                                              VistaLinkResponseFactory responseFactory)
                                       throws VistaLinkFaultException,
                                              FoundationsException

Executes an interaction with M

Specified by:

executeInteraction in interface VistaLinkConnection

Parameters:

requestVO - the request being made

responseFactory - the factory which will construct the response

Returns:

VistaLinkResponseVO the response from M

Throws:

VistaLinkFaultException - thrown if an error occurred on M while processing the request

FoundationsException - thrown if an internal adapter exception has occurred

executeRPC

public RpcResponse executeRPC(RpcRequest request)
                       throws VistaLinkFaultException,
                              FoundationsException

Executes an interaction with M using the RpcResponseFactory to construct a response.

Specified by:

executeRPC in interface VistaLinkConnection

Parameters:

request - The request being made

Returns:

RpcResponse the response that is returned

Throws:

VistaLinkFaultException - thrown if an error occurred on M while processing the request

FoundationsException - thrown if an internal adapter exception has occurred

getTimeOut

public int getTimeOut()

Returns current connection time out value.

Specified by:

getTimeOut in interface VistaLinkConnection

Returns:

int time out value in milli-seconds

setTimeOut

public void setTimeOut(int timeOut)

Use to set time out for read operations on connections

Specified by:

setTimeOut in interface VistaLinkConnection

Parameters:

timeOut - time out value to set in milli-seconds.

getMetaData

public ConnectionMetaData getMetaData()
                               throws ResourceException

Gets the meta-information on the underlying EIS instance via this connection

Specified by:

getMetaData in interface Connection

Returns:

ConnectionMetaData the value object that contains the metadata for this adapter

Throws:

ResourceException

getConnectionInfo

public VistaLinkServerInfo getConnectionInfo()

Returns connection information about the host

Specified by:

getConnectionInfo in interface VistaLinkConnection

Returns:

VistaLinkServerInfo the value object that contains connection information

getManagedConnection

public VistaLinkManagedConnection getManagedConnection()
                                                throws FoundationsException

This method should not be called directly. Used by spi classes.

Returns:

VistaLinkManagedConnection the managed connection

Throws:

FoundationsException

setManagedConnection

public void setManagedConnection(VistaLinkManagedConnection mc)

This method should not be called directly. Used by spi classes.

Parameters:

mc -

createInteraction

public Interaction createInteraction()
                              throws ResourceException

Empty method. throws NotSupportedException

Specified by:

createInteraction in interface Connection

Throws:

ResourceException

See Also:

Connection.createInteraction()

getLocalTransaction

public LocalTransaction getLocalTransaction()
                                     throws ResourceException

Empty method. throws NotSupportedException

Specified by:

getLocalTransaction in interface Connection

Throws:

ResourceException

See Also:

Connection.getLocalTransaction()

getResultSetInfo

public ResultSetInfo getResultSetInfo()
                               throws ResourceException

Empty method. throws NotSupportedException

Specified by:

getResultSetInfo in interface Connection

Throws:

ResourceException

See Also:

Connection.getResultSetInfo()