Package io.netty.handler.proxy

Class Socks4ProxyHandler

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.channel.ChannelDuplexHandler

io.netty.handler.proxy.ProxyHandler

io.netty.handler.proxy.Socks4ProxyHandler

All Implemented Interfaces:

ChannelHandler, ChannelInboundHandler, ChannelOutboundHandler

public final class Socks4ProxyHandler
extends ProxyHandler

Handler that establishes a blind forwarding proxy tunnel using SOCKS4 protocol.

Nested Class Summary

Nested classes/interfaces inherited from interface io.netty.channel.ChannelHandler

ChannelHandler.Sharable

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	AUTH_USERNAME
private String	decoderName
private String	encoderName
private static final String	PROTOCOL
private final String	username

Fields inherited from class io.netty.handler.proxy.ProxyHandler

AUTH_NONE

Constructor Summary

Constructors

Constructor	Description
Socks4ProxyHandler(SocketAddress proxyAddress)
Socks4ProxyHandler(SocketAddress proxyAddress, String username)

Method Summary

Modifier and Type	Method	Description
protected void	addCodec(ChannelHandlerContext ctx)	Adds the codec handlers required to communicate with the proxy server.
String	authScheme()	Returns the name of the authentication scheme in use.
protected boolean	handleResponse(ChannelHandlerContext ctx, Object response)	Handles the message received from the proxy server.
protected Object	newInitialMessage(ChannelHandlerContext ctx)	Returns a new message that is sent at first time when the connection to the proxy server has been established.
String	protocol()	Returns the name of the proxy protocol in use.
protected void	removeDecoder(ChannelHandlerContext ctx)	Removes the decoders added in ProxyHandler.addCodec(ChannelHandlerContext).
protected void	removeEncoder(ChannelHandlerContext ctx)	Removes the encoders added in ProxyHandler.addCodec(ChannelHandlerContext).
String	username()

Methods inherited from class io.netty.handler.proxy.ProxyHandler

channelActive, channelInactive, channelRead, channelReadComplete, connect, connectFuture, connectTimeoutMillis, destinationAddress, exceptionCaught, exceptionMessage, flush, handlerAdded, isConnected, proxyAddress, sendToProxyServer, setConnectTimeoutMillis, write

Methods inherited from class io.netty.channel.ChannelDuplexHandler

bind, close, deregister, disconnect, read

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

channelRegistered, channelUnregistered, channelWritabilityChanged, userEventTriggered

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

ensureNotSharable, 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

handlerRemoved

Field Details

PROTOCOL

private static final String PROTOCOL

See Also:

• Constant Field Values

AUTH_USERNAME

private static final String AUTH_USERNAME

See Also:

• Constant Field Values

username

private final String username

decoderName

private String decoderName

encoderName

private String encoderName

Constructor Details

Socks4ProxyHandler

public Socks4ProxyHandler(SocketAddress proxyAddress)

Socks4ProxyHandler

public Socks4ProxyHandler(SocketAddress proxyAddress,
 String username)

Method Details

protocol

public String protocol()

Description copied from class: ProxyHandler

Returns the name of the proxy protocol in use.

Specified by:

protocol in class ProxyHandler

authScheme

public String authScheme()

Description copied from class: ProxyHandler

Returns the name of the authentication scheme in use.

Specified by:

authScheme in class ProxyHandler

username

public String username()

addCodec

protected void addCodec(ChannelHandlerContext ctx)
                 throws Exception

Description copied from class: ProxyHandler

Adds the codec handlers required to communicate with the proxy server.

Specified by:

addCodec in class ProxyHandler

Throws:

Exception

removeEncoder

protected void removeEncoder(ChannelHandlerContext ctx)
                      throws Exception

Description copied from class: ProxyHandler

Removes the encoders added in ProxyHandler.addCodec(ChannelHandlerContext).

Specified by:

removeEncoder in class ProxyHandler

Throws:

Exception

removeDecoder

protected void removeDecoder(ChannelHandlerContext ctx)
                      throws Exception

Description copied from class: ProxyHandler

Removes the decoders added in ProxyHandler.addCodec(ChannelHandlerContext).

Specified by:

removeDecoder in class ProxyHandler

Throws:

Exception

newInitialMessage

protected Object newInitialMessage(ChannelHandlerContext ctx)
                            throws Exception

Description copied from class: ProxyHandler

Returns a new message that is sent at first time when the connection to the proxy server has been established.

Specified by:

newInitialMessage in class ProxyHandler

Returns:

the initial message, or null if the proxy server is expected to send the first message instead

Throws:

Exception

handleResponse

protected boolean handleResponse(ChannelHandlerContext ctx,
 Object response)
                          throws Exception

Description copied from class: ProxyHandler

Handles the message received from the proxy server.

Specified by:

handleResponse in class ProxyHandler

Returns:

true if the connection to the destination has been established, false if the connection to the destination has not been established and more messages are expected from the proxy server

Throws:

Exception