org.eclipse.jetty.fcgi.server.proxy

Class FastCGIProxyServlet

java.lang.Object

javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

org.eclipse.jetty.proxy.ProxyServlet

org.eclipse.jetty.proxy.AsyncProxyServlet

org.eclipse.jetty.proxy.AsyncProxyServlet.Transparent

org.eclipse.jetty.fcgi.server.proxy.FastCGIProxyServlet

All Implemented Interfaces:

Serializable, Servlet, ServletConfig

public class FastCGIProxyServlet
extends AsyncProxyServlet.Transparent

Specific implementation of ProxyServlet.Transparent for FastCGI.

This servlet accepts a HTTP request and transforms it into a FastCGI request that is sent to the FastCGI server specified in the proxyTo init-param.

This servlet accepts two additional init-params:

• scriptRoot, mandatory, that must be set to the directory where the application that must be served via FastCGI is installed and corresponds to the FastCGI DOCUMENT_ROOT parameter
• scriptPattern, optional, defaults to (.+?\.php), that specifies a regular expression with at least 1 and at most 2 groups that specify respectively:
  • the FastCGI SCRIPT_NAME parameter
  • the FastCGI PATH_INFO parameter
• fastCGI.HTTPS, optional, defaults to false, that specifies whether to force the FastCGI HTTPS parameter to the value on

See Also:

TryFilesFilter, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.proxy.AsyncProxyServlet

AsyncProxyServlet.StreamReader, AsyncProxyServlet.StreamWriter, AsyncProxyServlet.Transparent

Nested classes/interfaces inherited from class org.eclipse.jetty.proxy.ProxyServlet

ProxyServlet.ProxyInputStreamContentProvider, ProxyServlet.ProxyResponseListener, ProxyServlet.TransparentDelegate

Field Summary

Fields

Modifier and Type	Field and Description
static String	FASTCGI_HTTPS_INIT_PARAM
static String	SCRIPT_PATTERN_INIT_PARAM
static String	SCRIPT_ROOT_INIT_PARAM

Fields inherited from class org.eclipse.jetty.proxy.ProxyServlet

_log

Constructor Summary

Constructors

Constructor and Description
FastCGIProxyServlet()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	customizeFastCGIHeaders(Request proxyRequest, HttpFields fastCGIHeaders)
protected void	customizeProxyRequest(Request proxyRequest, HttpServletRequest request) Extension point for subclasses to customize the proxy request.
void	init()
protected HttpClient	newHttpClient()

Methods inherited from class org.eclipse.jetty.proxy.AsyncProxyServlet.Transparent

init, rewriteURI

Methods inherited from class org.eclipse.jetty.proxy.AsyncProxyServlet

newReadListener, newWriteListener, onResponseContent, proxyRequestContent

Methods inherited from class org.eclipse.jetty.proxy.ProxyServlet

addViaHeader, addXForwardedHeaders, createHttpClient, createLogger, destroy, filterResponseHeader, getBlackListHosts, getHttpClient, getRequestId, getTimeout, getViaHost, getWhiteListHosts, newProxyResponseListener, onClientRequestFailure, onResponseFailure, onResponseHeaders, onResponseSuccess, onRewriteFailed, service, setTimeout, validateDestination, viaHost

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doGet, doHead, doOptions, doPost, doPut, doTrace, getLastModified, service

Methods inherited from class javax.servlet.GenericServlet

getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, log, log

Methods inherited from class java.lang.Object

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

Field Detail

SCRIPT_ROOT_INIT_PARAM

public static final String SCRIPT_ROOT_INIT_PARAM

See Also:

Constant Field Values

SCRIPT_PATTERN_INIT_PARAM

public static final String SCRIPT_PATTERN_INIT_PARAM

See Also:

Constant Field Values

FASTCGI_HTTPS_INIT_PARAM

public static final String FASTCGI_HTTPS_INIT_PARAM

See Also:

Constant Field Values

Constructor Detail

FastCGIProxyServlet

public FastCGIProxyServlet()

Method Detail

init

public void init()
          throws ServletException

Overrides:

init in class ProxyServlet

Throws:

ServletException

newHttpClient

protected HttpClient newHttpClient()

Overrides:

newHttpClient in class ProxyServlet

Returns:

a new HttpClient instance

customizeProxyRequest

protected void customizeProxyRequest(Request proxyRequest,
                         HttpServletRequest request)

Description copied from class: ProxyServlet

Extension point for subclasses to customize the proxy request. The default implementation does nothing.

Overrides:

customizeProxyRequest in class ProxyServlet

Parameters:

proxyRequest - the proxy request to customize

request - the request to be proxied

customizeFastCGIHeaders

protected void customizeFastCGIHeaders(Request proxyRequest,
                           HttpFields fastCGIHeaders)