io.netty.handler.address

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 io.netty.channel.ChannelHandler

ChannelHandler.Sharable

Constructor Summary

Constructors

Constructor and Description
DynamicAddressConnectHandler()

Method Summary

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

Methods inherited from class io.netty.channel.ChannelOutboundHandlerAdapter

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

Methods inherited from class io.netty.channel.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 io.netty.channel.ChannelHandler

exceptionCaught, handlerAdded, handlerRemoved

Constructor Detail

DynamicAddressConnectHandler

public DynamicAddressConnectHandler()

Method Detail

connect

public final void connect(ChannelHandlerContext ctx,
                          SocketAddress remoteAddress,
                          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 SocketAddress localAddress(SocketAddress remoteAddress,
                                     SocketAddress localAddress)
                              throws 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:

Exception

remoteAddress

protected SocketAddress remoteAddress(SocketAddress remoteAddress,
                                      SocketAddress localAddress)
                               throws 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:

Exception