gov.va.med.vistalink.adapter.cci

Class VistaLinkConnectionFactory

Object

VistaLinkConnectionFactory

All Implemented Interfaces:

Serializable, Referenceable, ConnectionFactory

public class VistaLinkConnectionFactory
extends Object
implements ConnectionFactory, Serializable, Referenceable

This implementation class provides an interface for getting connection to an EIS instance. Adapters derived from ConnectionFactory overide/implement getConnection() to provide adapter-specific connections.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
VistaLinkConnectionFactory(VistaLinkManagedConnectionFactory managedFactory, ConnectionManager connectionManager)

Method Summary

Modifier and Type	Method and Description
String	getCfgIpAddress() Retrieve configuration file setting for this connection factory.
int	getCfgPort() Retrieve configuration file setting for this connection factory.
long	getCfgTimeout() Retrieve configuration file setting for this connection factory.
Connection	getConnection() Gets a VistaLinkConnection connection handle; calls allocateConnection().
Connection	getConnection(ConnectionSpec connectionSpec)
String	getConnectorJndiName() Retrieve configuration file setting for this connection factory.
long	getDistinguishedIdentifier() Retrieve information for this connection factory.
long	getHlthConnectionAuthFailureCount() Retrieve health counter for this connection factory.
long	getHlthConnectionFailureCount() Retrieve health counter for this connection factory.
long	getHlthDivisionMismatchCount() Retrieve health counter for this connection factory.
long	getHlthIdentityFailureCount() Retrieve health counter for this connection factory.
long	getHlthProductionMismatchCount() Retrieve health counter for this connection factory.
PrintWriter	getLogWriter() Deprecated. unused method, not part of JCA spec, left to help preserve compatibility with previous versions
void	getMCFInfo(ConnectorInfoVO connectorInfoVO, boolean getDetailInfo) Deprecated. Unused method; not removing to help preserve compatibility.
ResourceAdapterMetaData	getMetaData() Returns the meta data information associated with this adapter.
double	getPerfCreateConnectionHandleAvgMillis() Retrieve performance tracker for this connection factory.
double	getPerfMatchManagedConnectionAvgMillis() Retrieve performance tracker for this connection factory.
RecordFactory	getRecordFactory() Empty method.
Reference	getReference() Referenceable interface.
static VistaLinkConnectionFactory	getVistaLinkConnectionFactory(String hostIPAddress, Integer hostPort) Creates VistaLinkConnectionFactory to be used in non-managed environment (J2SE).
boolean	isCfgTimeoutAlwaysUseDefaultAsMin() Retrieve configuration file setting for this connection factory.
VistaLinkSystemInfoVO	queryMSystem() query the M system reached by this connector for general system information.
void	setLogWriter(PrintWriter printWriter) Deprecated. unused method, not part of JCA spec, left to help preserve compatibility with previous versions
void	setReference(Reference reference) Referenceable interface.

Methods inherited from class Object

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

Constructor Detail

VistaLinkConnectionFactory

public VistaLinkConnectionFactory(VistaLinkManagedConnectionFactory managedFactory,
                                  ConnectionManager connectionManager)

Parameters:

managedFactory - the factory that the connection manager will use to construct managed connections

connectionManager - the connection manager that will allocate new VistaLinkConnections. This value is null in an unmanaged environment and defaults to VistaLinkConnectionManager this value is specified by the application server in a managed environment

Method Detail

getLogWriter

public PrintWriter getLogWriter()
                         throws ResourceException

Deprecated. unused method, not part of JCA spec, left to help preserve compatibility with previous versions

Returns:

PrintWriter

Throws:

ResourceException

setLogWriter

public void setLogWriter(PrintWriter printWriter)
                  throws ResourceException

Deprecated. unused method, not part of JCA spec, left to help preserve compatibility with previous versions

Parameters:

printWriter -

Throws:

ResourceException

getMetaData

public ResourceAdapterMetaData getMetaData()
                                    throws ResourceException

Returns the meta data information associated with this adapter.

Specified by:

getMetaData in interface ConnectionFactory

Throws:

ResourceException

See Also:

ConnectionFactory.getMetaData()

getReference

public Reference getReference()

Referenceable interface.

Specified by:

getReference in interface Referenceable

See Also:

Referenceable.getReference()

setReference

public void setReference(Reference reference)

Referenceable interface.

Parameters:

reference - reference

See Also:

Referenceable.setReference(javax.naming.Reference)

getConnection

public Connection getConnection(ConnectionSpec connectionSpec)
                         throws ResourceException

Specified by:

getConnection in interface ConnectionFactory

Throws:

ResourceException

getConnection

public Connection getConnection()
                         throws ResourceException

Gets a VistaLinkConnection connection handle; calls allocateConnection(). This gets connections for J2SE mode.

Specified by:

getConnection in interface ConnectionFactory

Throws:

ResourceException

See Also:

ConnectionFactory.getConnection()

getRecordFactory

public RecordFactory getRecordFactory()
                               throws ResourceException

Empty method.

Specified by:

getRecordFactory in interface ConnectionFactory

Throws:

NotSupportedException

ResourceException

See Also:

ConnectionFactory.getRecordFactory()

getVistaLinkConnectionFactory

public static final VistaLinkConnectionFactory getVistaLinkConnectionFactory(String hostIPAddress,
                                                                             Integer hostPort)
                                                                      throws ResourceException

Creates VistaLinkConnectionFactory to be used in non-managed environment (J2SE).

This method should never be called in managed environment (J2EE) as application server is responsible for creating ConnectionFactories. J2EE code should use JNDI lookup to get a reference to the ConnectionFactory.

Parameters:

hostIPAddress - - the IP address to connect to

hostPort - - the port to open

Returns:

VistaLinkConnectionFactory The connection factory that will return Connections for the specified IPAddress and port

Throws:

ResourceException

getMCFInfo

public void getMCFInfo(ConnectorInfoVO connectorInfoVO,
                       boolean getDetailInfo)

Deprecated. Unused method; not removing to help preserve compatibility.

Populate a ConnectorInfoVO object with information from the stored VistaLinkManagedConnectionFactory instance. Note: This method is unused and could be removed, except for compatibility concerns with previous version.

Parameters:

connectorInfoVO - object to populate

getDetailInfo - populate with less detail if false, more detail if true

getCfgIpAddress

public String getCfgIpAddress()

Retrieve configuration file setting for this connection factory.

Returns:

IP address from configuration file.

getCfgPort

public int getCfgPort()

Retrieve configuration file setting for this connection factory.

Returns:

port from configuration file.

getCfgTimeout

public long getCfgTimeout()

Retrieve configuration file setting for this connection factory.

Returns:

default timeout, from configuration file

isCfgTimeoutAlwaysUseDefaultAsMin

public boolean isCfgTimeoutAlwaysUseDefaultAsMin()

Retrieve configuration file setting for this connection factory.

Returns:

setting for whether to use default timeout as minimum timeout, from configuration file

getDistinguishedIdentifier

public long getDistinguishedIdentifier()

Retrieve information for this connection factory.

Returns:

distinguished (internal) identifier associated with this connection factory

getHlthConnectionAuthFailureCount

public long getHlthConnectionAuthFailureCount()

Retrieve health counter for this connection factory.

Returns:

health counter for authentication failures

getHlthConnectionFailureCount

public long getHlthConnectionFailureCount()

Retrieve health counter for this connection factory.

Returns:

health counter for connection failures

getHlthDivisionMismatchCount

public long getHlthDivisionMismatchCount()

Retrieve health counter for this connection factory.

Returns:

health counter for division mismatches

getHlthIdentityFailureCount

public long getHlthIdentityFailureCount()

Retrieve health counter for this connection factory.

Returns:

health counter for "reauthentication" second-level light authentication failures

getHlthProductionMismatchCount

public long getHlthProductionMismatchCount()

Retrieve health counter for this connection factory.

Returns:

health counter for production-test mismatches

getPerfCreateConnectionHandleAvgMillis

public double getPerfCreateConnectionHandleAvgMillis()

Retrieve performance tracker for this connection factory.

Returns:

performance tracker for "create connection handle" average in milliseconds

getPerfMatchManagedConnectionAvgMillis

public double getPerfMatchManagedConnectionAvgMillis()

Retrieve performance tracker for this connection factory.

Returns:

performance tracker for "match managed connection" function in milliseconds

queryMSystem

public VistaLinkSystemInfoVO queryMSystem()

query the M system reached by this connector for general system information.

Returns:

M System Info object.

getConnectorJndiName

public String getConnectorJndiName()

Retrieve configuration file setting for this connection factory.

Returns:

JNDI name retrieved from VistALink configuration file and associated with this connection factory