org.snf4j.core.proxy

Class Socks4ProxyHandler

java.lang.Object

org.snf4j.core.handler.AbstractHandler

org.snf4j.core.handler.AbstractStreamHandler

org.snf4j.core.proxy.AbstractProxyHandler

org.snf4j.core.proxy.AbstractSocksProxyHandler

org.snf4j.core.proxy.Socks4ProxyHandler

All Implemented Interfaces:

IHandler, IStreamHandler, IStreamReader

public class Socks4ProxyHandler
extends AbstractSocksProxyHandler

Handles client proxy connections via the SOCKS Protocol Version 4.

Author:

SNF4J.ORG

Constructor Summary

Constructors

Constructor and Description
Socks4ProxyHandler(InetSocketAddress address, Socks4Command command, String username) Constructs a SOCKS4 proxy connection handler with the specified destination address, SOCKS4 command, user's name and the default (10 seconds) connection timeout.
Socks4ProxyHandler(InetSocketAddress address, Socks4Command command, String username, ISessionConfig config) Constructs a SOCKS4 proxy connection handler with the specified destination address, SOCKS4 command, user's name, the default (10 seconds) connection timeout and configuration.
Socks4ProxyHandler(InetSocketAddress address, Socks4Command command, String username, ISessionConfig config, ISessionStructureFactory factory) Constructs a SOCKS4 proxy connection handler with the specified destination address, SOCKS4 command, user's name, the default (10 seconds) connection timeout, configuration and factory.
Socks4ProxyHandler(InetSocketAddress address, String username) Constructs a SOCKS4 proxy connection handler with the specified destination address, the default (CONNECT) command, user's name and the default (10 seconds) connection timeout.
Socks4ProxyHandler(InetSocketAddress address, String username, ISessionConfig config) Constructs a SOCKS4 proxy connection handler with the specified destination address, the default (CONNECT) command, user's name, the default (10 seconds) connection timeout and configuration.
Socks4ProxyHandler(InetSocketAddress address, String username, ISessionConfig config, ISessionStructureFactory factory) Constructs a SOCKS4 proxy connection handler with the specified destination address, the default (CONNECT) command, user's name, the default (10 seconds) connection timeout, configuration and factory.

Method Summary

Modifier and Type	Method and Description
Socks4ProxyHandler	connectionTimeout(long connectionTimeout) Configures the proxy connection timeout.

Methods inherited from class org.snf4j.core.proxy.AbstractSocksProxyHandler

addReplyListener, available, available, event, getAddress, getReplies, handleReady, read, read, read

Methods inherited from class org.snf4j.core.proxy.AbstractProxyHandler

getFactory, timer

Methods inherited from class org.snf4j.core.handler.AbstractStreamHandler

getSession, setSession

Methods inherited from class org.snf4j.core.handler.AbstractHandler

event, exception, getConfig, getName, incident, timer

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.snf4j.core.handler.IHandler

event, exception, getConfig, getName, incident, timer

Constructor Detail

Socks4ProxyHandler

public Socks4ProxyHandler(InetSocketAddress address,
                          String username)

Constructs a SOCKS4 proxy connection handler with the specified destination address, the default (CONNECT) command, user's name and the default (10 seconds) connection timeout.

NOTE: The connection timeout will have no effect if the associated session does not support a session timer.

Parameters:

address - the destination address to the host to which the connection should be proxied

username - the user's name, or null for an empty name

Throws:

IllegalArgumentException - if the address is null

Socks4ProxyHandler

public Socks4ProxyHandler(InetSocketAddress address,
                          String username,
                          ISessionConfig config)

Constructs a SOCKS4 proxy connection handler with the specified destination address, the default (CONNECT) command, user's name, the default (10 seconds) connection timeout and configuration.

NOTE: The connection timeout will have no effect if the associated session does not support a session timer.

Parameters:

address - the destination address to the host to which the connection should be proxied

username - the user's name, or null for an empty name

config - the session configuration object, or null to use the default configuration

Throws:

IllegalArgumentException - if the address is null

Socks4ProxyHandler

public Socks4ProxyHandler(InetSocketAddress address,
                          String username,
                          ISessionConfig config,
                          ISessionStructureFactory factory)

Constructs a SOCKS4 proxy connection handler with the specified destination address, the default (CONNECT) command, user's name, the default (10 seconds) connection timeout, configuration and factory.

NOTE: The connection timeout will have no effect if the associated session does not support a session timer.

Parameters:

address - the destination address to the host to which the connection should be proxied

username - the user's name, or null for an empty name

config - the session configuration object, or null to use the default configuration

factory - the factory that will be used to configure the internal structure of the associated session, or null to use the default factory

Throws:

IllegalArgumentException - if the address is null

Socks4ProxyHandler

public Socks4ProxyHandler(InetSocketAddress address,
                          Socks4Command command,
                          String username)

Constructs a SOCKS4 proxy connection handler with the specified destination address, SOCKS4 command, user's name and the default (10 seconds) connection timeout.

NOTE: The connection timeout will have no effect if the associated session does not support a session timer.

Parameters:

address - the destination address to the host to which the connection should be proxied

command - the SCOCS4 command

username - the user's name, or null for an empty name

Throws:

IllegalArgumentException - if the address or the command is null

Socks4ProxyHandler

public Socks4ProxyHandler(InetSocketAddress address,
                          Socks4Command command,
                          String username,
                          ISessionConfig config)

Constructs a SOCKS4 proxy connection handler with the specified destination address, SOCKS4 command, user's name, the default (10 seconds) connection timeout and configuration.

NOTE: The connection timeout will have no effect if the associated session does not support a session timer.

Parameters:

address - the destination address to the host to which the connection should be proxied

command - the SCOCS4 command

username - the user's name, or null for an empty name

config - the session configuration object, or null to use the default configuration

Throws:

IllegalArgumentException - if the address or the command is null

Socks4ProxyHandler

public Socks4ProxyHandler(InetSocketAddress address,
                          Socks4Command command,
                          String username,
                          ISessionConfig config,
                          ISessionStructureFactory factory)

Constructs a SOCKS4 proxy connection handler with the specified destination address, SOCKS4 command, user's name, the default (10 seconds) connection timeout, configuration and factory.

NOTE: The connection timeout will have no effect if the associated session does not support a session timer.

Parameters:

address - the destination address to the host to which the connection should be proxied

command - the SCOCS4 command

username - the user's name, or null for an empty name

config - the session configuration object, or null to use the default configuration

factory - the factory that will be used to configure the internal structure of the associated session, or null to use the default factory

Throws:

IllegalArgumentException - if the address or the command is null

Method Detail

connectionTimeout

public Socks4ProxyHandler connectionTimeout(long connectionTimeout)

Configures the proxy connection timeout.

NOTE: The connection timeout will have no effect if the associated session does not support a session timer.

Overrides:

connectionTimeout in class AbstractProxyHandler

Parameters:

connectionTimeout - the proxy connection timeout in milliseconds, or 0 to wait an infinite amount of time for establishing the HTTP tunnel

Returns:

this handler

Throws:

IllegalArgumentException - if the connection timeout is negative