org.springframework.integration.ip.tcp.connection

Class AbstractClientConnectionFactory

java.lang.Object

org.springframework.integration.context.IntegrationObjectSupport

org.springframework.integration.ip.tcp.connection.AbstractConnectionFactory

org.springframework.integration.ip.tcp.connection.AbstractClientConnectionFactory

All Implemented Interfaces:

Aware, BeanFactoryAware, BeanNameAware, InitializingBean, ApplicationContextAware, ApplicationEventPublisherAware, Lifecycle, Phased, SmartLifecycle, ConnectionFactory, NamedComponent

Direct Known Subclasses:

CachingClientConnectionFactory, FailoverClientConnectionFactory, TcpNetClientConnectionFactory, TcpNioClientConnectionFactory

public abstract class AbstractClientConnectionFactory
extends AbstractConnectionFactory

Abstract class for client connection factories; client connection factories establish outgoing connections.

Since:

2.0

Author:

Gary Russell, Artem Bilan

Field Summary

Fields inherited from class org.springframework.integration.ip.tcp.connection.AbstractConnectionFactory

DEFAULT_REPLY_TIMEOUT, lifecycleMonitor

Fields inherited from class org.springframework.integration.context.IntegrationObjectSupport

logger

Constructor Summary

Constructors

Constructor and Description
AbstractClientConnectionFactory(String host, int port) Constructs a factory that will established connections to the host and port.

Method Summary

Methods

Modifier and Type	Method and Description
protected TcpConnectionSupport	buildNewConnection()
void	forceClose(TcpConnection connection) Force close the connection and null the field if it's a shared connection.
TcpConnectionSupport	getConnection() Obtains a connection - if AbstractConnectionFactory.setSingleUse(boolean) was called with true, a new connection is returned; otherwise a single connection is reused for all requests while the connection remains open.
protected TcpConnectionSupport	getTheConnection()
protected void	initializeConnection(TcpConnectionSupport connection, Socket socket) Transfers attributes such as (de)serializers, singleUse etc to a new connection.
protected TcpConnectionSupport	obtainConnection()
protected TcpConnectionSupport	obtainNewConnection()
protected TcpConnectionSupport	obtainSharedConnection()
protected void	setTheConnection(TcpConnectionSupport theConnection)

Methods inherited from class org.springframework.integration.ip.tcp.connection.AbstractConnectionFactory

addConnection, checkActive, closeConnection, doAccept, getApplicationEventPublisher, getDeserializer, getHost, getListener, getMapper, getOpenConnectionIds, getPhase, getPort, getSender, getSerializer, getSoLinger, getSoReceiveBufferSize, getSoSendBufferSize, getSoTimeout, getSoTrafficClass, getTaskExecutor, getTcpSocketSupport, harvestClosedConnections, isActive, isAutoStartup, isLookupHost, isRunning, isSingleUse, isSoKeepAlive, isSoTcpNoDelay, onInit, processNioSelections, registerListener, registerSender, setActive, setApplicationEventPublisher, setDeserializer, setInterceptorFactoryChain, setLookupHost, setMapper, setNioHarvestInterval, setSerializer, setSingleUse, setSocketAttributes, setSoKeepAlive, setSoLinger, setSoReceiveBufferSize, setSoSendBufferSize, setSoTcpNoDelay, setSoTimeout, setSoTrafficClass, setTaskExecutor, setTcpSocketSupport, start, stop, stop, wrapConnection

Methods inherited from class org.springframework.integration.context.IntegrationObjectSupport

afterPropertiesSet, getApplicationContextId, getBeanFactory, getComponentName, getComponentType, getConversionService, getIntegrationProperties, getIntegrationProperty, getMessageBuilderFactory, getTaskScheduler, setApplicationContext, setBeanFactory, setBeanName, setComponentName, setConversionService, setMessageBuilderFactory, setTaskScheduler, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractClientConnectionFactory

public AbstractClientConnectionFactory(String host,
                               int port)

Constructs a factory that will established connections to the host and port.

Parameters:

host - The host.

port - The port.

Method Detail

getConnection

public TcpConnectionSupport getConnection()
                                   throws Exception

Obtains a connection - if AbstractConnectionFactory.setSingleUse(boolean) was called with true, a new connection is returned; otherwise a single connection is reused for all requests while the connection remains open.

Throws:

Exception

obtainConnection

protected TcpConnectionSupport obtainConnection()
                                         throws Exception

Throws:

Exception

obtainSharedConnection

protected final TcpConnectionSupport obtainSharedConnection()
                                                     throws InterruptedException

Throws:

InterruptedException

obtainNewConnection

protected final TcpConnectionSupport obtainNewConnection()
                                                  throws Exception

Throws:

Exception

buildNewConnection

protected TcpConnectionSupport buildNewConnection()
                                           throws Exception

Throws:

Exception

initializeConnection

protected void initializeConnection(TcpConnectionSupport connection,
                        Socket socket)

Transfers attributes such as (de)serializers, singleUse etc to a new connection. When the connection factory has a reference to a TCPListener (to read responses), or for single use connections, the connection is executed. Single use connections need to read from the connection in order to close it after the socket timeout.

Parameters:

connection - The new connection.

socket - The new socket.

setTheConnection

protected void setTheConnection(TcpConnectionSupport theConnection)

Parameters:

theConnection - the theConnection to set

getTheConnection

protected TcpConnectionSupport getTheConnection()

Returns:

the theConnection

forceClose

public void forceClose(TcpConnection connection)

Force close the connection and null the field if it's a shared connection.

Parameters:

connection - The connection.