org.otfeed
Class OTPooledConnectionFactory

java.lang.Object
  org.otfeed.OTPooledConnectionFactory

All Implemented Interfaces:

IConnectionFactory

public class OTPooledConnectionFactory
extends java.lang.Object
implements IConnectionFactory

Class that facilitates connection pooling (sharing). This class maintains one physical connection per specification and routes all connect(OTConnectionSpec, IConnectionStateListener) requests to the connection that matches the specification. This is convenient as all clients can view their copy of connection as an independent one. This is efficient, because only minimal number of system resources is consumed. It is recommended that this class should be used whenever there is a chance that factory's connect(OTConnectionSpec,IConnectionStateListener) method can be called more than once.

Constructor Summary

OTPooledConnectionFactory()

Method Summary

IConnection	connect(IConnectionStateListener listener) Please use IConnectionFactory.connect(OTConnectionSpec, IConnectionStateListener) method.
IConnection	connect(OTConnectionSpec spec, IConnectionStateListener listener) Connects to the server.
IConnectionFactory	getConnectionFactory()
void	setConnectionFactory(IConnectionFactory engine) The factory of shared connection (typically an instance of OTConnectionFactory).
void	shutdownAll() Forces the shutdown of the pooled connection.

Methods inherited from class java.lang.Object

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

Constructor Detail

OTPooledConnectionFactory

public OTPooledConnectionFactory()

Method Detail

setConnectionFactory

public void setConnectionFactory(IConnectionFactory engine)

The factory of shared connection (typically an instance of OTConnectionFactory).

Parameters:

engine -

getConnectionFactory

public IConnectionFactory getConnectionFactory()

connect

public IConnection connect(IConnectionStateListener listener)

Description copied from interface: IConnectionFactory

Please use IConnectionFactory.connect(OTConnectionSpec, IConnectionStateListener) method.

Specified by:

connect in interface IConnectionFactory

connect

public IConnection connect(OTConnectionSpec spec,
                           IConnectionStateListener listener)

Description copied from interface: IConnectionFactory

Connects to the server. This call does not block, the connection process is started asynchronously, in a separate thread (event-dispatching thread).

To monitor connection progress, supply listener parameter.

Specified by:

connect in interface IConnectionFactory

Parameters:

spec - connection specification. Some implementations may accept null value, which would mean to use some default values for the connection parameters.

listener - listener to receive connection state events. This parameter may be null, to indicate that there is no interest in monitoring connection status.

Returns:

connection.

shutdownAll

public void shutdownAll()

Forces the shutdown of the pooled connection. Useful for hooking to the Spring's "deinit" bean lifecycle to make sure that even if users of this bean did not shutdown their clones of the connection, this method will actually disconnect from Opentick and release all resources.