com.bankframe.ei.txnhandler.connector
Interface EConnectionFactory

All Superinterfaces:

Referenceable, Serializable

All Known Implementing Classes:

CobolTestConnectionFactory, HTTPConnectionFactory, HTTPSSLConnectionFactory, JDBCConnectionFactory, OffLineConnectionFactory, TestCustomerConnectionFactory

public interface EConnectionFactory
extends Serializable, Referenceable

EConnectionFactory provides an interface for getting connection to an EIS/Host instance. An implementation of EConnectionFactory interface is provided by a connector implementation. Application code looks up a EConnectionFactory instance from JNDI namespace and uses it to get host connections. An implementation class for EConnectionFactory is required to implement java.io.Serializable and javax.naming.Referenceable interfaces to support JNDI registration.

Method Summary

EConnection	getConnection() This method gets a connection to a Host system instance.
EConnection	getConnection(String properties) This method gets a connection to a Host system instance.
Reference	getReference() This method gets the JNDI Reference instance.
void	setReference(Reference ref) This method sets the JNDI Reference instance.

Method Detail

getConnection

EConnection getConnection()

This method gets a connection to a Host system instance. This getConnection variant should be used when a component wants the container to manager Host system sign-on. This case is used when the component does not pass any security information (ie. username/password)

Returns:

EConnection instance.

getConnection

EConnection getConnection(String properties)

This method gets a connection to a Host system instance. A component should use the getConnection variant with a String parameter of properties, if it needs to pass any connector specific security information and connection parameters. In the component- managed sign-on case, an application component passes security information (example: username, password) through the String instance.

Parameters:

properties - A semi-colon delimited String of connection specific properties. For example: user=jbloggs;password=eontec;paramX=valueX;

Returns:

EConnection instance.

getReference

Reference getReference()
                       throws NamingException

This method gets the JNDI Reference instance.

Specified by:

getReference in interface Referenceable

Returns:

The Reference instance for this class.

Throws:

NamingException

setReference

void setReference(Reference ref)

This method sets the JNDI Reference instance. This method is called by the deployment code to set the Reference that can be later returned by the getReference method (as defined in the javax.naming.Referenceable interface).

Parameters:

ref - A Reference instance