Class DynamicAddressConnectHandler

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelOutboundHandlerAdapter

io.netty.handler.address.DynamicAddressConnectHandler

All Implemented Interfaces:

ChannelHandler, ChannelOutboundHandler

public abstract class DynamicAddressConnectHandler
extends ChannelOutboundHandlerAdapter

ChannelOutboundHandler implementation which allows to dynamically replace the used remoteAddress and / or localAddress when making a connection attempt.

This can be useful to for example bind to a specific NetworkInterface based on the remoteAddress.

Nested Class Summary

Nested classes/interfaces inherited from interface ChannelHandler

ChannelHandler.Sharable

Constructor Summary

Constructors

Constructor	Description
DynamicAddressConnectHandler()

Method Summary

Modifier and Type	Method	Description
final void	connect(ChannelHandlerContext ctx, java.net.SocketAddress remoteAddress, java.net.SocketAddress localAddress, ChannelPromise promise)	Calls ChannelOutboundInvoker.connect(SocketAddress, SocketAddress, ChannelPromise) to forward to the next ChannelOutboundHandler in the ChannelPipeline.
protected java.net.SocketAddress	localAddress(java.net.SocketAddress remoteAddress, java.net.SocketAddress localAddress)	Returns the local SocketAddress to use for ChannelOutboundInvoker.connect(SocketAddress, SocketAddress) based on the original remoteAddress and localAddress.
protected java.net.SocketAddress	remoteAddress(java.net.SocketAddress remoteAddress, java.net.SocketAddress localAddress)	Returns the remote SocketAddress to use for ChannelOutboundInvoker.connect(SocketAddress, SocketAddress) based on the original remoteAddress and localAddress.

Methods inherited from class ChannelOutboundHandlerAdapter

bind, close, deregister, disconnect, flush, read, write

Methods inherited from class ChannelHandlerAdapter

ensureNotSharable, exceptionCaught, handlerAdded, handlerRemoved, isSharable

Methods inherited from class java.lang.Object

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

Methods inherited from interface ChannelHandler

exceptionCaught, handlerAdded, handlerRemoved

Constructor Details

DynamicAddressConnectHandler

public DynamicAddressConnectHandler()

Method Details

connect

public final void connect(ChannelHandlerContext ctx,
 java.net.SocketAddress remoteAddress,
 java.net.SocketAddress localAddress,
 ChannelPromise promise)

Description copied from class: ChannelOutboundHandlerAdapter

Calls ChannelOutboundInvoker.connect(SocketAddress, SocketAddress, ChannelPromise) to forward to the next ChannelOutboundHandler in the ChannelPipeline. Sub-classes may override this method to change behavior.

Specified by:

connect in interface ChannelOutboundHandler

Overrides:

connect in class ChannelOutboundHandlerAdapter

Parameters:

ctx - the ChannelHandlerContext for which the connect operation is made

remoteAddress - the SocketAddress to which it should connect

localAddress - the SocketAddress which is used as source on connect

promise - the ChannelPromise to notify once the operation completes

localAddress

protected java.net.SocketAddress localAddress(java.net.SocketAddress remoteAddress,
 java.net.SocketAddress localAddress)
                                       throws java.lang.Exception

Returns the local SocketAddress to use for ChannelOutboundInvoker.connect(SocketAddress, SocketAddress) based on the original remoteAddress and localAddress. By default, this method returns the given localAddress.

Throws:

java.lang.Exception

remoteAddress

protected java.net.SocketAddress remoteAddress(java.net.SocketAddress remoteAddress,
 java.net.SocketAddress localAddress)
                                        throws java.lang.Exception

Returns the remote SocketAddress to use for ChannelOutboundInvoker.connect(SocketAddress, SocketAddress) based on the original remoteAddress and localAddress. By default, this method returns the given remoteAddress.

Throws:

java.lang.Exception