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:

org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanFactoryAware, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.InitializingBean, org.springframework.context.ApplicationContextAware, org.springframework.context.ApplicationEventPublisherAware, org.springframework.context.Lifecycle, ExpressionCapable, ConnectionFactory, NamedComponent

Direct Known Subclasses:

CachingClientConnectionFactory, FailoverClientConnectionFactory, TcpNetClientConnectionFactory, TcpNioClientConnectionFactory, ThreadAffinityClientConnectionFactory

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

EXPRESSION_PARSER, logger

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected TcpConnectionSupport	buildNewConnection()
void	enableManualListenerRegistration() Set whether to automatically (default) or manually add a TcpListener to the connections created by this factory.
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, java.net.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, delayRead, doAccept, getApplicationEventPublisher, getDelayedReads, getDeserializer, getHost, getListener, getMapper, getOpenConnectionIds, getPort, getReadDelay, getSender, getSerializer, getSoLinger, getSoReceiveBufferSize, getSoSendBufferSize, getSoTimeout, getSoTrafficClass, getSslHandshakeTimeout, getTaskExecutor, getTcpSocketSupport, harvestClosedConnections, isActive, isLookupHost, isRunning, isSingleUse, isSoKeepAlive, isSoTcpNoDelay, onInit, processNioSelections, registerListener, registerSender, setActive, setApplicationEventPublisher, setDeserializer, setHost, setInterceptorFactoryChain, setLeaveOpen, setLookupHost, setMapper, setNioHarvestInterval, setPort, setReadDelay, setSerializer, setSingleUse, setSocketAttributes, setSoKeepAlive, setSoLinger, setSoReceiveBufferSize, setSoSendBufferSize, setSoTcpNoDelay, setSoTimeout, setSoTrafficClass, setSslHandshakeTimeout, setTaskExecutor, setTcpSocketSupport, start, stop, toString, wrapConnection

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

afterPropertiesSet, extractTypeIfPossible, getApplicationContext, getApplicationContextId, getBeanFactory, getChannelResolver, getComponentName, getComponentType, getConversionService, getExpression, getIntegrationProperties, getIntegrationProperty, getMessageBuilderFactory, getTaskScheduler, isInitialized, setApplicationContext, setBeanFactory, setBeanName, setChannelResolver, setComponentName, setConversionService, setMessageBuilderFactory, setPrimaryExpression, setTaskScheduler

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractClientConnectionFactory

public AbstractClientConnectionFactory(java.lang.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

enableManualListenerRegistration

public void enableManualListenerRegistration()

Set whether to automatically (default) or manually add a TcpListener to the connections created by this factory. By default, the factory automatically configures the listener. When manual registration is in place, incoming messages will be delayed until the listener is registered.

Since:

1.4.5

getConnection

public TcpConnectionSupport getConnection()
                                   throws java.lang.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:

java.lang.Exception

obtainConnection

protected TcpConnectionSupport obtainConnection()
                                         throws java.lang.Exception

Throws:

java.lang.Exception

obtainSharedConnection

protected final TcpConnectionSupport obtainSharedConnection()
                                                     throws java.lang.InterruptedException

Throws:

java.lang.InterruptedException

obtainNewConnection

protected final TcpConnectionSupport obtainNewConnection()
                                                  throws java.lang.Exception

Throws:

java.lang.Exception

buildNewConnection

protected TcpConnectionSupport buildNewConnection()
                                           throws java.lang.Exception

Throws:

java.lang.Exception

initializeConnection

protected void initializeConnection(TcpConnectionSupport connection,
                                    java.net.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.