org.eclipse.jetty.fcgi.server.proxy

Class FastCGIProxyServlet

java.lang.Object

javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

org.eclipse.jetty.proxy.AbstractProxyServlet

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 AsyncProxyServlet.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

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

AbstractProxyServlet.TransparentDelegate

Field Summary

Fields

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

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

_log, CLIENT_REQUEST_ATTRIBUTE, HOP_HEADERS

Constructor Summary

Constructors

Constructor and Description
FastCGIProxyServlet()

Method Summary

Modifier and Type	Method and Description
protected void	customizeFastCGIHeaders(Request proxyRequest, HttpFields fastCGIHeaders)
void	init()
protected HttpClient	newHttpClient()
protected void	sendProxyRequest(HttpServletRequest request, HttpServletResponse proxyResponse, Request proxyRequest)

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

init, rewriteTarget

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

newReadListener, newWriteListener, onResponseContent, proxyRequestContent

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

newProxyResponseListener, onContinue, service

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

addProxyHeaders, addViaHeader, addXForwardedHeaders, copyRequestHeaders, createHttpClient, createLogger, destroy, expects100Continue, filterServerResponseHeader, findConnectionHeaders, getBlackListHosts, getHostHeader, getHttpClient, getRequestId, getTimeout, getViaHost, getWhiteListHosts, hasContent, onClientRequestFailure, onProxyResponseFailure, onProxyResponseSuccess, onProxyRewriteFailed, onServerResponseHeaders, sendProxyResponseError, setTimeout, validateDestination

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

ORIGINAL_URI_ATTRIBUTE_INIT_PARAM

public static final String ORIGINAL_URI_ATTRIBUTE_INIT_PARAM

See Also:

Constant Field Values

ORIGINAL_QUERY_ATTRIBUTE_INIT_PARAM

public static final String ORIGINAL_QUERY_ATTRIBUTE_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 AbstractProxyServlet

Throws:

ServletException

newHttpClient

protected HttpClient newHttpClient()

Overrides:

newHttpClient in class AbstractProxyServlet

Returns:

a new HttpClient instance

sendProxyRequest

protected void sendProxyRequest(HttpServletRequest request,
                                HttpServletResponse proxyResponse,
                                Request proxyRequest)

Overrides:

sendProxyRequest in class AbstractProxyServlet

customizeFastCGIHeaders

protected void customizeFastCGIHeaders(Request proxyRequest,
                                       HttpFields fastCGIHeaders)