org.littleshoot.proxy

Class ChainedProxyAdapter

java.lang.Object

org.littleshoot.proxy.ChainedProxyAdapter

All Implemented Interfaces:

ChainedProxy, SslEngineSource

public class ChainedProxyAdapter
extends Object
implements ChainedProxy

Convenience base class for implementations of ChainedProxy.

Field Summary

Fields

Modifier and Type	Field and Description
static ChainedProxy	FALLBACK_TO_DIRECT_CONNECTION ChainedProxy that simply has the downstream proxy make a direct connection to the upstream server.

Constructor Summary

Constructors

Constructor and Description
ChainedProxyAdapter()

Method Summary

Modifier and Type	Method and Description
void	connectionFailed(Throwable cause) Called to let us know that connecting to this proxy failed.
void	connectionSucceeded() Called to let us know that connecting to this proxy succeeded.
void	disconnected() Called to let us know that we were disconnected.
void	filterRequest(HttpObject httpObject) Filters requests on their way to the chained proxy.
InetSocketAddress	getChainedProxyAddress() Return the InetSocketAddress for connecting to the chained proxy.
InetSocketAddress	getLocalAddress() (Optional) ensure that the connection is opened from a specific local address (useful when doing NAT traversal).
TransportProtocol	getTransportProtocol() Tell LittleProxy what kind of TransportProtocol to use to communicate with the chained proxy.
SSLEngine	newSslEngine() Returns an SSLEngine to use for a server connection from LittleProxy to the client.
SSLEngine	newSslEngine(String peerHost, int peerPort) Returns an SSLEngine to use for a client connection from LittleProxy to the upstream server.
boolean	requiresEncryption() Implement this method to tell LittleProxy whether or not to encrypt connections to the chained proxy for the given request.

Methods inherited from class java.lang.Object

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

Field Detail

FALLBACK_TO_DIRECT_CONNECTION

public static ChainedProxy FALLBACK_TO_DIRECT_CONNECTION

ChainedProxy that simply has the downstream proxy make a direct connection to the upstream server.

Constructor Detail

ChainedProxyAdapter

public ChainedProxyAdapter()

Method Detail

getChainedProxyAddress

public InetSocketAddress getChainedProxyAddress()

Description copied from interface: ChainedProxy

Return the InetSocketAddress for connecting to the chained proxy. Returning null indicates that we won't chain.

Specified by:

getChainedProxyAddress in interface ChainedProxy

Returns:

The Chain Proxy with Host and Port.

getLocalAddress

public InetSocketAddress getLocalAddress()

Description copied from interface: ChainedProxy

(Optional) ensure that the connection is opened from a specific local address (useful when doing NAT traversal).

Specified by:

getLocalAddress in interface ChainedProxy

Returns:

getTransportProtocol

public TransportProtocol getTransportProtocol()

Description copied from interface: ChainedProxy

Tell LittleProxy what kind of TransportProtocol to use to communicate with the chained proxy.

Specified by:

getTransportProtocol in interface ChainedProxy

Returns:

requiresEncryption

public boolean requiresEncryption()

Description copied from interface: ChainedProxy

Implement this method to tell LittleProxy whether or not to encrypt connections to the chained proxy for the given request. If true, LittleProxy will call SslEngineSource.newSslEngine() to obtain an SSLContext used by the downstream proxy.

Specified by:

requiresEncryption in interface ChainedProxy

Returns:

true of the connection to the chained proxy should be encrypted

newSslEngine

public SSLEngine newSslEngine()

Description copied from interface: SslEngineSource

Returns an SSLEngine to use for a server connection from LittleProxy to the client.

Specified by:

newSslEngine in interface SslEngineSource

Returns:

filterRequest

public void filterRequest(HttpObject httpObject)

Description copied from interface: ChainedProxy

Filters requests on their way to the chained proxy.

Specified by:

filterRequest in interface ChainedProxy

connectionSucceeded

public void connectionSucceeded()

Description copied from interface: ChainedProxy

Called to let us know that connecting to this proxy succeeded.

Specified by:

connectionSucceeded in interface ChainedProxy

connectionFailed

public void connectionFailed(Throwable cause)

Description copied from interface: ChainedProxy

Called to let us know that connecting to this proxy failed.

Specified by:

connectionFailed in interface ChainedProxy

Parameters:

cause - exception that caused this failure (may be null)

disconnected

public void disconnected()

Description copied from interface: ChainedProxy

Called to let us know that we were disconnected.

Specified by:

disconnected in interface ChainedProxy

newSslEngine

public SSLEngine newSslEngine(String peerHost,
                              int peerPort)

Description copied from interface: SslEngineSource

Returns an SSLEngine to use for a client connection from LittleProxy to the upstream server. * Note: Peer information is needed to send the server_name extension in handshake with Server Name Indication (SNI).

Specified by:

newSslEngine in interface SslEngineSource

Parameters:

peerHost - to start a client connection to the server.

peerPort - to start a client connection to the server.

Returns: