org.openqa.selenium.server

Class ProxyHandler

java.lang.Object

org.openqa.jetty.http.handler.AbstractHttpHandler

org.openqa.selenium.server.ProxyHandler

All Implemented Interfaces:

Serializable, org.openqa.jetty.http.HttpHandler, org.openqa.jetty.util.LifeCycle

public class ProxyHandler
extends org.openqa.jetty.http.handler.AbstractHttpHandler

Proxy request handler. A HTTP/1.1 Proxy. This implementation uses the JVMs URL implementation to make proxy requests.

The HttpTunnel mechanism is also used to implement the CONNECT method.

Version:

$Id: ProxyHandler.java,v 1.34 2005/10/05 13:32:59 gregwilkins Exp $

Author:

Greg Wilkins (gregw), [email protected] (chained proxy)

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ProxyHandler.SslRelay

Field Summary

Fields

Modifier and Type	Field and Description
protected HashSet<Integer>	_allowedConnectPorts Set of allowed CONNECT ports.
protected org.openqa.jetty.util.StringMap	_DontProxyHeaders Map of leg by leg headers (not end to end).
protected org.openqa.jetty.util.StringMap	_ProxyAuthHeaders Map of leg by leg headers (not end to end).
protected Set<String>	_proxyHostsBlackList
protected Set<String>	_proxyHostsWhiteList
protected org.openqa.jetty.util.StringMap	_ProxySchemes Map of allows schemes to proxy Should be a set, but more efficient string map is used instead.
protected int	_tunnelTimeoutMs

Constructor Summary

Constructors

Constructor and Description
ProxyHandler(boolean trustAllSSLCertificates, String dontInjectRegex, String debugURL, boolean proxyInjectionMode, boolean forceProxyChain, int port, Object shutdownLock)

Method Summary

Modifier and Type	Method and Description
void	generateSSLCertsForLoggingHosts(org.openqa.jetty.http.HttpServer server)
protected ProxyHandler.SslRelay	getSslRelayOrCreateNew(org.openqa.jetty.util.URI uri, String serverHost, Integer serverPort, org.openqa.jetty.http.HttpServer server)
void	handle(String pathInContext, String pathParams, org.openqa.jetty.http.HttpRequest request, org.openqa.jetty.http.HttpResponse response)
void	handleConnect(org.openqa.jetty.http.HttpRequest request, org.openqa.jetty.http.HttpResponse response)
protected boolean	isForbidden(String scheme, String host) Is scheme,host & port Forbidden.
protected boolean	isForbidden(org.openqa.jetty.util.URI uri) Is URL Forbidden.
protected URL	isProxied(org.openqa.jetty.util.URI uri) Is URL Proxied.
protected org.openqa.jetty.http.HttpTunnel	newHttpTunnel(org.openqa.jetty.http.HttpResponse response, InetAddress iaddr, int port, int timeoutMS)
protected long	proxyPlainTextRequest(URL url, org.openqa.jetty.http.HttpRequest request, org.openqa.jetty.http.HttpResponse response)
protected void	sendForbid(org.openqa.jetty.http.HttpResponse response) Send Forbidden.
protected void	sendNotFound(org.openqa.jetty.http.HttpResponse response) Send not found.
boolean	shouldInject(String path)
void	start()
protected void	wireUpSslWithCyberVilliansCA(String host, ProxyHandler.SslRelay listener)

Methods inherited from class org.openqa.jetty.http.handler.AbstractHttpHandler

getHttpContext, getName, handleTrace, initialize, isStarted, setName, stop, toString

Methods inherited from class java.lang.Object

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

Field Detail

_proxyHostsWhiteList

protected Set<String> _proxyHostsWhiteList

_proxyHostsBlackList

protected Set<String> _proxyHostsBlackList

_tunnelTimeoutMs

protected int _tunnelTimeoutMs

_DontProxyHeaders

protected org.openqa.jetty.util.StringMap _DontProxyHeaders

Map of leg by leg headers (not end to end). Should be a set, but more efficient string map is used instead.

_ProxyAuthHeaders

protected org.openqa.jetty.util.StringMap _ProxyAuthHeaders

Map of leg by leg headers (not end to end). Should be a set, but more efficient string map is used instead.

_ProxySchemes

protected org.openqa.jetty.util.StringMap _ProxySchemes

Map of allows schemes to proxy Should be a set, but more efficient string map is used instead.

_allowedConnectPorts

protected HashSet<Integer> _allowedConnectPorts

Set of allowed CONNECT ports.

Constructor Detail

ProxyHandler

public ProxyHandler(boolean trustAllSSLCertificates,
                    String dontInjectRegex,
                    String debugURL,
                    boolean proxyInjectionMode,
                    boolean forceProxyChain,
                    int port,
                    Object shutdownLock)

Method Detail

start

public void start()
           throws Exception

Specified by:

start in interface org.openqa.jetty.util.LifeCycle

Overrides:

start in class org.openqa.jetty.http.handler.AbstractHttpHandler

Throws:

Exception

handle

public void handle(String pathInContext,
                   String pathParams,
                   org.openqa.jetty.http.HttpRequest request,
                   org.openqa.jetty.http.HttpResponse response)
            throws IOException

Throws:

IOException

proxyPlainTextRequest

protected long proxyPlainTextRequest(URL url,
                                     org.openqa.jetty.http.HttpRequest request,
                                     org.openqa.jetty.http.HttpResponse response)
                              throws IOException

Throws:

IOException

shouldInject

public boolean shouldInject(String path)

generateSSLCertsForLoggingHosts

public void generateSSLCertsForLoggingHosts(org.openqa.jetty.http.HttpServer server)

handleConnect

public void handleConnect(org.openqa.jetty.http.HttpRequest request,
                          org.openqa.jetty.http.HttpResponse response)
                   throws IOException

Throws:

IOException

getSslRelayOrCreateNew

protected ProxyHandler.SslRelay getSslRelayOrCreateNew(org.openqa.jetty.util.URI uri,
                                                       String serverHost,
                                                       Integer serverPort,
                                                       org.openqa.jetty.http.HttpServer server)
                                                throws Exception

Throws:

Exception

wireUpSslWithCyberVilliansCA

protected void wireUpSslWithCyberVilliansCA(String host,
                                            ProxyHandler.SslRelay listener)

newHttpTunnel

protected org.openqa.jetty.http.HttpTunnel newHttpTunnel(org.openqa.jetty.http.HttpResponse response,
                                                         InetAddress iaddr,
                                                         int port,
                                                         int timeoutMS)
                                                  throws IOException

Throws:

IOException

isProxied

protected URL isProxied(org.openqa.jetty.util.URI uri)
                 throws MalformedURLException

Is URL Proxied. Method to allow derived handlers to select which URIs are proxied and to where.

Parameters:

uri - The requested URI, which should include a scheme, host and port.

Returns:

The URL to proxy to, or null if the passed URI should not be proxied. The default implementation returns the passed uri if isForbidden() returns true.

Throws:

MalformedURLException - malformed URL

isForbidden

protected boolean isForbidden(org.openqa.jetty.util.URI uri)

Is URL Forbidden.

Parameters:

uri - URI

Returns:

True if the URL is not forbidden. Calls isForbidden(scheme,host,port,true);

isForbidden

protected boolean isForbidden(String scheme,
                              String host)

Is scheme,host & port Forbidden.

Parameters:

scheme - A scheme that mast be in the proxySchemes StringMap.

host - A host that must pass the white and black lists

Returns:

True if the request to the scheme,host and port is not forbidden.

sendForbid

protected void sendForbid(org.openqa.jetty.http.HttpResponse response)
                   throws IOException

Send Forbidden. Method called to send forbidden response. Default implementation calls sendError(403)

Parameters:

response - http response

Throws:

IOException - i/o exception

sendNotFound

protected void sendNotFound(org.openqa.jetty.http.HttpResponse response)
                     throws IOException

Send not found. Method called to send not found response. Default implementation calls sendError(404)

Parameters:

response - http response

Throws:

IOException - i/o exception