org.springframework.integration.ip.udp

Class UnicastReceivingChannelAdapter

java.lang.Object

org.springframework.integration.context.IntegrationObjectSupport

org.springframework.integration.endpoint.AbstractEndpoint

org.springframework.integration.endpoint.MessageProducerSupport

org.springframework.integration.ip.AbstractInternetProtocolReceivingChannelAdapter

org.springframework.integration.ip.udp.UnicastReceivingChannelAdapter

All Implemented Interfaces:

java.lang.Runnable, org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanFactoryAware, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.DisposableBean, org.springframework.beans.factory.InitializingBean, org.springframework.beans.factory.SmartInitializingSingleton, org.springframework.context.ApplicationContextAware, org.springframework.context.ApplicationEventPublisherAware, org.springframework.context.Lifecycle, org.springframework.context.Phased, org.springframework.context.SmartLifecycle, ExpressionCapable, MessageProducer, CommonSocketOptions, NamedComponent, TrackableComponent, org.springframework.scheduling.SchedulingAwareRunnable

Direct Known Subclasses:

MulticastReceivingChannelAdapter

public class UnicastReceivingChannelAdapter
extends AbstractInternetProtocolReceivingChannelAdapter

A channel adapter to receive incoming UDP packets. Packets can optionally be preceded by a 4 byte length field, used to validate that all data was received. Packets may also contain information indicating an acknowledgment needs to be sent.

Since:

2.0

Author:

Gary Russell

Field Summary

Fields inherited from class org.springframework.integration.endpoint.AbstractEndpoint

lifecycleCondition, lifecycleLock

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

EXPRESSION_PARSER, logger

Constructor Summary

Constructors

Constructor and Description
UnicastReceivingChannelAdapter(int port) Constructs a UnicastReceivingChannelAdapter that listens on the specified port.
UnicastReceivingChannelAdapter(int port, boolean lengthCheck) Constructs a UnicastReceivingChannelAdapter that listens for packets on the specified port.

Method Summary

Modifier and Type	Method and Description
protected boolean	asyncSendMessage(java.net.DatagramPacket packet)
protected void	doSend(java.net.DatagramPacket packet)
protected void	doStop() Takes no action by default.
java.lang.String	getComponentType() Subclasses may implement this method to provide component type information.
int	getPort()
java.net.DatagramSocket	getSocket()
protected java.net.DatagramSocket	getTheSocket()
boolean	isLongLived()
protected void	onInit() Subclasses may implement this for initialization logic.
protected java.net.DatagramPacket	receive()
void	run()
protected void	sendAck(org.springframework.messaging.Message<byte[]> message)
void	setLengthCheck(boolean lengthCheck)
void	setLookupHost(boolean lookupHost)
void	setSocket(java.net.DatagramSocket socket)
protected void	setSocketAttributes(java.net.DatagramSocket socket) Sets timeout and receive buffer size
void	setSoSendBufferSize(int soSendBufferSize)

Methods inherited from class org.springframework.integration.ip.AbstractInternetProtocolReceivingChannelAdapter

checkTaskExecutor, doStart, getApplicationEventPublisher, getLocalAddress, getReceiveBufferSize, getSoReceiveBufferSize, getSoTimeout, getTaskExecutor, isActive, isListening, setApplicationEventPublisher, setListening, setLocalAddress, setPoolSize, setReceiveBufferSize, setSoReceiveBufferSize, setSoTimeout, setTaskExecutor

Methods inherited from class org.springframework.integration.endpoint.MessageProducerSupport

afterSingletonsInstantiated, buildErrorMessage, getErrorChannel, getErrorMessageAttributes, getMessagingTemplate, getOutputChannel, sendErrorMessageIfNecessary, sendMessage, setErrorChannel, setErrorChannelName, setErrorMessageStrategy, setOutputChannel, setOutputChannelName, setSendTimeout, setShouldTrack

Methods inherited from class org.springframework.integration.endpoint.AbstractEndpoint

destroy, doStop, getPhase, getRole, isAutoStartup, isRunning, setAutoStartup, setPhase, setRole, setTaskScheduler, start, stop, stop

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

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.integration.support.context.NamedComponent

getComponentName

Constructor Detail

UnicastReceivingChannelAdapter

public UnicastReceivingChannelAdapter(int port)

Constructs a UnicastReceivingChannelAdapter that listens on the specified port.

Parameters:

port - The port.

UnicastReceivingChannelAdapter

public UnicastReceivingChannelAdapter(int port,
                                      boolean lengthCheck)

Constructs a UnicastReceivingChannelAdapter that listens for packets on the specified port. Enables setting the lengthCheck option, which expects a length to precede the incoming packets.

Parameters:

port - The port.

lengthCheck - If true, enables the lengthCheck Option.

Method Detail

setLengthCheck

public void setLengthCheck(boolean lengthCheck)

Parameters:

lengthCheck - if true, the incoming packet is expected to have a four byte binary length header.

Since:

5.0

isLongLived

public boolean isLongLived()

getPort

public int getPort()

Overrides:

getPort in class AbstractInternetProtocolReceivingChannelAdapter

Returns:

The port on which this receiver is listening.

onInit

protected void onInit()

Description copied from class: IntegrationObjectSupport

Subclasses may implement this for initialization logic.

Overrides:

onInit in class MessageProducerSupport

run

public void run()

sendAck

protected void sendAck(org.springframework.messaging.Message<byte[]> message)

asyncSendMessage

protected boolean asyncSendMessage(java.net.DatagramPacket packet)

doSend

protected void doSend(java.net.DatagramPacket packet)

receive

protected java.net.DatagramPacket receive()
                                   throws java.lang.Exception

Throws:

java.lang.Exception

setSocket

public void setSocket(java.net.DatagramSocket socket)

Parameters:

socket - the socket to set

getTheSocket

protected java.net.DatagramSocket getTheSocket()

getSocket

public java.net.DatagramSocket getSocket()

setSocketAttributes

protected void setSocketAttributes(java.net.DatagramSocket socket)
                            throws java.net.SocketException

Sets timeout and receive buffer size

Parameters:

socket - The socket.

Throws:

java.net.SocketException - Any socket exception.

doStop

protected void doStop()

Description copied from class: MessageProducerSupport

Takes no action by default. Subclasses may override this if they need lifecycle-managed behavior.

Overrides:

doStop in class AbstractInternetProtocolReceivingChannelAdapter

setSoSendBufferSize

public void setSoSendBufferSize(int soSendBufferSize)

Parameters:

soSendBufferSize - The send buffer size.

See Also:

Socket.setSendBufferSize(int), DatagramSocket.setSendBufferSize(int)

setLookupHost

public void setLookupHost(boolean lookupHost)

getComponentType

public java.lang.String getComponentType()

Description copied from class: IntegrationObjectSupport

Subclasses may implement this method to provide component type information.

Specified by:

getComponentType in interface NamedComponent

Overrides:

getComponentType in class IntegrationObjectSupport