com.caucho.server.fastcgi
Class FastCgiRequest

java.lang.Object
  com.caucho.server.http.AbstractHttpRequest
      com.caucho.server.fastcgi.FastCgiRequest

All Implemented Interfaces:

ProtocolConnection, SecurityContextProvider

public class FastCgiRequest
extends AbstractHttpRequest
implements ProtocolConnection

Handles a new request from a FastCGI connection.

Field Summary

Fields inherited from class com.caucho.server.http.AbstractHttpRequest

_headerCodes, _hostHeader, JSP_EXCEPTION, SHUTDOWN

Constructor Summary

FastCgiRequest(Server server, SocketLink conn)
Creates a new HttpRequest.

Method Summary

protected boolean	checkLogin()
FastCgiResponse	createResponse()
protected java.lang.String	dbgId()
java.lang.String	getHeader(java.lang.String key) Returns the header.
CharSegment	getHeaderBuffer(char[] testBuf, int length) Returns the matching header.
CharSegment	getHeaderBuffer(java.lang.String key) Returns the header value for the key, returned as a CharSegment.
void	getHeaderBuffers(java.lang.String key, java.util.ArrayList<CharSegment> values) Fills an ArrayList with the header values matching the key.
CharSegment	getHeaderKey(int index) Returns the header key
java.util.Enumeration	getHeaderNames() Returns an enumeration of all the header keys.
java.util.Enumeration	getHeaders(java.lang.String key) Return an enumeration of headers matching a key.
int	getHeaderSize() Returns the number of headers.
CharSegment	getHeaderValue(int index) Returns the header value
java.lang.String	getMethod() Returns the header.
CharSegment	getMethodBuffer() Returns a buffer containing the request method.
java.lang.String	getProtocol() Returns the protocol.
ReadStream	getRawInput() Returns the raw input stream.
byte[]	getUriBuffer() Returns the byte buffer containing the request URI
int	getUriLength() Returns the length of the request URI
int	getVersion()
boolean	handleRequest() Handles a new HTTP request.
boolean	hasRequest() Returns true if the request exists
boolean	initStream(ReadStream readStream, ReadStream rawRead) Returns a stream for reading POST data.
boolean	isSecure() Returns true for a secure connection.
boolean	isTop() Returns true for the top-level request, but false for any include() or forward()
boolean	isWaitForRead() Return true if the request waits for a read before beginning.
void	setHeader(java.lang.String key, java.lang.String value) Adds a new header.
protected void	startRequest(HttpBufferStore httpBuffer) Clear the request variables in preparation for a new request.
java.lang.String	toString()

Methods inherited from class com.caucho.server.http.AbstractHttpRequest

addHeaderInt, buildInvocation, cleanup, clearRequest, clientDisconnect, findSessionIdFromConnection, finishInvocation, finishRequest, getAbstractHttpResponse, getAvailable, getCharacterEncoding, getCharBuffer, getConnection, getConnectionId, getContentLength, getContentType, getContentTypeBuffer, getCookies, getDateHeader, getErrorManager, getForm, getFormParser, getHost, getInputStream, getIntHeader, getInvocation, getInvocationServer, getLocale, getLocales, getLocalHost, getLocalPort, getLogBuffer, getLongContentLength, getProtocolRequestURL, getRawRead, getRawReadBuffer, getRawWrite, getReader, getReadStream, getRemoteAddr, getRemoteHost, getRemotePort, getRequestFacade, getRequestURI, getRequestURL, getResponse, getResponseFacade, getScheme, getServer, getServerName, getServerPort, getStartTime, getStream, getStream, getUserPrincipal, getWebApp, handleConnectionClose, handleResume, init, initAttributes, isCometActive, isConnectionClosed, isDuplex, isIgnoreClientDisconnect, isKeepalive, isSuspend, isTransportSecure, isUserInRole, killKeepalive, onCloseConnection, onStartConnection, printRemoteAddr, restartServer, runAs, sendRequestError, setCharacterEncoding, setContentLength, shutdown, skip, startDuplex, startInvocation

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.caucho.network.listen.ProtocolConnection

getProtocolRequestURL, handleResume, init, onCloseConnection, onStartConnection

Constructor Detail

FastCgiRequest

public FastCgiRequest(Server server,
                      SocketLink conn)

Creates a new HttpRequest. New connections reuse the request.

Parameters:

server - the owning server.

Method Detail

createResponse

public FastCgiResponse createResponse()

Specified by:

createResponse in class AbstractHttpRequest

isWaitForRead

public final boolean isWaitForRead()

Return true if the request waits for a read before beginning.

Specified by:

isWaitForRead in interface ProtocolConnection

hasRequest

public boolean hasRequest()

Returns true if the request exists

Overrides:

hasRequest in class AbstractHttpRequest

handleRequest

public boolean handleRequest()
                      throws java.io.IOException

Handles a new HTTP request.

Note: ClientDisconnectException must be rethrown to the caller.

Specified by:

handleRequest in interface ProtocolConnection

Returns:

true if the connection should stay open (keepalive)

Throws:

java.io.IOException

getVersion

public int getVersion()

getUriBuffer

public byte[] getUriBuffer()

Returns the byte buffer containing the request URI

Specified by:

getUriBuffer in class AbstractHttpRequest

getUriLength

public int getUriLength()

Returns the length of the request URI

Specified by:

getUriLength in class AbstractHttpRequest

getMethod

public java.lang.String getMethod()

Returns the header.

Specified by:

getMethod in class AbstractHttpRequest

getProtocol

public java.lang.String getProtocol()

Returns the protocol.

Specified by:

getProtocol in class AbstractHttpRequest

getMethodBuffer

public CharSegment getMethodBuffer()

Returns a buffer containing the request method.

setHeader

public void setHeader(java.lang.String key,
                      java.lang.String value)

Adds a new header. Used only by the caching to simulate If-Modified-Since.

Overrides:

setHeader in class AbstractHttpRequest

Parameters:

key - the key of the new header

value - the value for the new header

getHeaderSize

public int getHeaderSize()

Returns the number of headers.

Overrides:

getHeaderSize in class AbstractHttpRequest

getHeaderKey

public CharSegment getHeaderKey(int index)

Returns the header key

Overrides:

getHeaderKey in class AbstractHttpRequest

getHeaderValue

public CharSegment getHeaderValue(int index)

Returns the header value

Overrides:

getHeaderValue in class AbstractHttpRequest

getHeader

public java.lang.String getHeader(java.lang.String key)

Returns the header.

Specified by:

getHeader in class AbstractHttpRequest

Parameters:

key - the header key

getHeaderBuffer

public CharSegment getHeaderBuffer(char[] testBuf,
                                   int length)

Returns the matching header.

Parameters:

testBuf - header key

length - length of the key.

getHeaderBuffer

public CharSegment getHeaderBuffer(java.lang.String key)

Returns the header value for the key, returned as a CharSegment.

Overrides:

getHeaderBuffer in class AbstractHttpRequest

Parameters:

key - the header name

getHeaderBuffers

public void getHeaderBuffers(java.lang.String key,
                             java.util.ArrayList<CharSegment> values)

Fills an ArrayList with the header values matching the key.

Overrides:

getHeaderBuffers in class AbstractHttpRequest

Parameters:

values - ArrayList which will contain the maching values.

key - the header key to select.

getHeaders

public java.util.Enumeration getHeaders(java.lang.String key)

Return an enumeration of headers matching a key.

Overrides:

getHeaders in class AbstractHttpRequest

Parameters:

key - the header key to match.

Returns:

the enumeration of the headers.

getHeaderNames

public java.util.Enumeration getHeaderNames()

Returns an enumeration of all the header keys.

Specified by:

getHeaderNames in class AbstractHttpRequest

initStream

public boolean initStream(ReadStream readStream,
                          ReadStream rawRead)
                   throws java.io.IOException

Returns a stream for reading POST data.

Specified by:

initStream in class AbstractHttpRequest

Throws:

java.io.IOException

isTop

public boolean isTop()

Returns true for the top-level request, but false for any include() or forward()

checkLogin

protected boolean checkLogin()

startRequest

protected void startRequest(HttpBufferStore httpBuffer)
                     throws java.io.IOException

Clear the request variables in preparation for a new request.

Overrides:

startRequest in class AbstractHttpRequest

Parameters:

s - the read stream for the request

Throws:

java.io.IOException

isSecure

public boolean isSecure()

Returns true for a secure connection.

Overrides:

isSecure in class AbstractHttpRequest

getRawInput

public ReadStream getRawInput()

Returns the raw input stream.

Overrides:

getRawInput in class AbstractHttpRequest

dbgId

protected java.lang.String dbgId()

Overrides:

dbgId in class AbstractHttpRequest

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object