org.glassfish.grizzly.http
Class HttpServerFilter

java.lang.Object
  org.glassfish.grizzly.filterchain.BaseFilter
      org.glassfish.grizzly.http.HttpCodecFilter
          org.glassfish.grizzly.http.HttpServerFilter

All Implemented Interfaces:

Filter, JmxMonitoringAware<HttpProbe>, MonitoringAware<HttpProbe>

public class HttpServerFilter
extends HttpCodecFilter

Server side HttpCodecFilter implementation, which is responsible for decoding HttpRequestPacket and encoding HttpResponsePacket messages. This Filter is usually used, when we build an asynchronous HTTP server connection.

Author:

Alexey Stashok

See Also:

HttpCodecFilter, HttpClientFilter

Nested Class Summary

Nested classes/interfaces inherited from class org.glassfish.grizzly.http.HttpCodecFilter

HttpCodecFilter.ContentParsingState, HttpCodecFilter.HeaderParsingState

Field Summary

static java.lang.String	HTTP_SERVER_REQUEST_ATTR_NAME
static FilterChainEvent	RESPONSE_COMPLETE_EVENT

Fields inherited from class org.glassfish.grizzly.http.HttpCodecFilter

chunkingEnabled, contentEncodings, DEFAULT_MAX_HTTP_PACKET_HEADER_SIZE, maxHeadersSize, monitoringConfig

Constructor Summary

HttpServerFilter()
Constructor, which creates HttpServerFilter instance

HttpServerFilter(boolean chunkingEnabled, int maxHeadersSize, KeepAlive keepAlive, DelayedExecutor executor)
Constructor, which creates HttpServerFilter instance, with the specific max header size parameter.

HttpServerFilter(boolean chunkingEnabled, int maxHeadersSize, java.lang.String defaultResponseContentType, KeepAlive keepAlive, DelayedExecutor executor)
Constructor, which creates HttpServerFilter instance, with the specific max header size parameter.

Method Summary

protected HttpContent	customizeErrorResponse(HttpResponsePacket response)
protected Buffer	encodeHttpPacket(FilterChainContext ctx, HttpPacket input)
java.lang.String	getDefaultResponseContentType()
NextAction	handleEvent(FilterChainContext ctx, FilterChainEvent event)
NextAction	handleRead(FilterChainContext ctx) The method is called, once we have received a Buffer, which has to be transformed into HTTP request packet part.
boolean	isAuthPassthroughEnabled()
boolean	isTraceEnabled()
protected void	onHttpContentEncoded(HttpContent content, FilterChainContext ctx) Invoked when a HTTP body chunk has been encoded in preparation to being transmitted to the user-agent.
protected void	onHttpContentParsed(HttpContent content, FilterChainContext ctx) Invoked as request/response body content has been processed by this Filter.
protected void	onHttpError(HttpHeader httpHeader, FilterChainContext ctx) Callback which is invoked when parsing an HTTP message fails.
protected boolean	onHttpHeaderParsed(HttpHeader httpHeader, Buffer buffer, FilterChainContext ctx) Callback invoked when the HTTP message header parsing is complete.
protected void	onHttpHeadersEncoded(HttpHeader httpHeader, FilterChainContext ctx) Invoked when HTTP headers have been encoded in preparation to being transmitted to the user-agent.
protected void	onHttpHeadersParsed(HttpHeader httpHeader, FilterChainContext ctx) Invoked when all headers of the packet have been parsed.
protected boolean	onHttpPacketParsed(HttpHeader httpHeader, FilterChainContext ctx) Callback method, called when HttpPacket parsing has been completed.
protected void	onInitialLineEncoded(HttpHeader header, FilterChainContext ctx) Invoked when the intial response line has been encoded in preparation to being transmitted to the user-agent.
protected void	onInitialLineParsed(HttpHeader httpHeader, FilterChainContext ctx) Invoked when either the request line or status line has been parsed.
void	setAuthPassthroughEnabled(boolean enabled)
void	setDefaultResponseContentType(java.lang.String defaultResponseContentType)
void	setTraceEnabled(boolean enabled)

Methods inherited from class org.glassfish.grizzly.http.HttpCodecFilter

addContentEncoding, addTransferEncoding, checkEOL, createJmxManagementObject, decodeHttpPacket, encodeKnownHeaders, encodeMimeHeader, encodeMimeHeaders, findEOL, findSpace, getContentEncodings, getMonitoringConfig, getTransferEncodings, handleRead, handleWrite, indexOf, isChunkingEnabled, isSecure, parseHeader, parseHeaderName, parseHeaders, parseHeaderValue, removeContentEncoding, removeTransferEncoding, skipSpaces

Methods inherited from class org.glassfish.grizzly.filterchain.BaseFilter

createContext, exceptionOccurred, getFilterChain, getIndex, handleAccept, handleClose, handleConnect, onAdded, onFilterChainChanged, onRemoved

Methods inherited from class java.lang.Object

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

Field Detail

HTTP_SERVER_REQUEST_ATTR_NAME

public static final java.lang.String HTTP_SERVER_REQUEST_ATTR_NAME

RESPONSE_COMPLETE_EVENT

public static final FilterChainEvent RESPONSE_COMPLETE_EVENT

Constructor Detail

HttpServerFilter

public HttpServerFilter()

Constructor, which creates HttpServerFilter instance

HttpServerFilter

public HttpServerFilter(boolean chunkingEnabled,
                        int maxHeadersSize,
                        KeepAlive keepAlive,
                        DelayedExecutor executor)

Constructor, which creates HttpServerFilter instance, with the specific max header size parameter.

Parameters:

chunkingEnabled - flag indicating whether or not chunking should be allowed or not.

maxHeadersSize - the maximum size of an inbound HTTP message header.

keepAlive - keep-alive configuration for this filter instance.

executor - DelayedExecutor for handling keep-alive.

HttpServerFilter

public HttpServerFilter(boolean chunkingEnabled,
                        int maxHeadersSize,
                        java.lang.String defaultResponseContentType,
                        KeepAlive keepAlive,
                        DelayedExecutor executor)

Constructor, which creates HttpServerFilter instance, with the specific max header size parameter.

Parameters:

chunkingEnabled - flag indicating whether or not chunking should be allowed or not.

maxHeadersSize - the maximum size of an inbound HTTP message header.

defaultResponseContentType - the content type that the response should use if no content had been specified at the time the response is committed.

keepAlive - keep-alive configuration for this filter instance.

executor - DelayedExecutor for handling keep-alive. If null - keep-alive idle connections should be managed outside HttpServerFilter.

Method Detail

handleRead

public NextAction handleRead(FilterChainContext ctx)
                      throws java.io.IOException

The method is called, once we have received a Buffer, which has to be transformed into HTTP request packet part. Filter gets Buffer, which represents a part or complete HTTP request message. As the result of "read" transformation - we will get HttpContent message, which will represent HTTP request packet content (might be zero length content) and reference to a HttpHeader, which contains HTTP request message header.

Specified by:

handleRead in interface Filter

Overrides:

handleRead in class BaseFilter

Parameters:

ctx - Request processing context

Returns:

NextAction

Throws:

java.io.IOException

handleEvent

public NextAction handleEvent(FilterChainContext ctx,
                              FilterChainEvent event)
                       throws java.io.IOException

Specified by:

handleEvent in interface Filter

Overrides:

handleEvent in class BaseFilter

Throws:

java.io.IOException

onHttpHeaderParsed

protected boolean onHttpHeaderParsed(HttpHeader httpHeader,
                                     Buffer buffer,
                                     FilterChainContext ctx)

Description copied from class: HttpCodecFilter

Callback invoked when the HTTP message header parsing is complete.

Specified by:

onHttpHeaderParsed in class HttpCodecFilter

Parameters:

httpHeader - HttpHeader, which represents parsed HTTP packet header

buffer - Buffer the header was parsed from

ctx - processing context.

Returns:

true if an error has occurred while processing the header portion of the HTTP request, otherwise returns false.

onHttpPacketParsed

protected final boolean onHttpPacketParsed(HttpHeader httpHeader,
                                           FilterChainContext ctx)

Description copied from class: HttpCodecFilter

Callback method, called when HttpPacket parsing has been completed.

Specified by:

onHttpPacketParsed in class HttpCodecFilter

Parameters:

httpHeader - HttpHeader, which represents parsed HTTP packet header

ctx - processing context.

Returns:

true if an error has occurred while processing the header portion of the HTTP request, otherwise returns false.s

onInitialLineParsed

protected void onInitialLineParsed(HttpHeader httpHeader,
                                   FilterChainContext ctx)

Description copied from class: HttpCodecFilter

Invoked when either the request line or status line has been parsed.

Specified by:

onInitialLineParsed in class HttpCodecFilter

Parameters:

httpHeader - HttpHeader, which represents HTTP packet header

ctx - processing context.

onInitialLineEncoded

protected void onInitialLineEncoded(HttpHeader header,
                                    FilterChainContext ctx)

Description copied from class: HttpCodecFilter

Invoked when the intial response line has been encoded in preparation to being transmitted to the user-agent.

Specified by:

onInitialLineEncoded in class HttpCodecFilter

Parameters:

header - HttpHeader, which represents HTTP packet header

ctx - processing context.

onHttpHeadersParsed

protected void onHttpHeadersParsed(HttpHeader httpHeader,
                                   FilterChainContext ctx)

Description copied from class: HttpCodecFilter

Invoked when all headers of the packet have been parsed. Depending on the transfer encoding being used by the current request, this method may be invoked multiple times.

Specified by:

onHttpHeadersParsed in class HttpCodecFilter

Parameters:

httpHeader - HttpHeader, which represents HTTP packet header

ctx - processing context.

onHttpHeadersEncoded

protected void onHttpHeadersEncoded(HttpHeader httpHeader,
                                    FilterChainContext ctx)

Description copied from class: HttpCodecFilter

Invoked when HTTP headers have been encoded in preparation to being transmitted to the user-agent.

Specified by:

onHttpHeadersEncoded in class HttpCodecFilter

Parameters:

httpHeader - HttpHeader, which represents HTTP packet header

ctx - processing context.

onHttpContentParsed

protected void onHttpContentParsed(HttpContent content,
                                   FilterChainContext ctx)

Description copied from class: HttpCodecFilter

Invoked as request/response body content has been processed by this Filter.

Specified by:

onHttpContentParsed in class HttpCodecFilter

Parameters:

content - request/response body content

ctx - processing context.

onHttpContentEncoded

protected void onHttpContentEncoded(HttpContent content,
                                    FilterChainContext ctx)

Description copied from class: HttpCodecFilter

Invoked when a HTTP body chunk has been encoded in preparation to being transmitted to the user-agent.

Specified by:

onHttpContentEncoded in class HttpCodecFilter

Parameters:

content - HttpContent, which represents HTTP packet header

ctx - processing context.

onHttpError

protected void onHttpError(HttpHeader httpHeader,
                           FilterChainContext ctx)
                    throws java.io.IOException

Description copied from class: HttpCodecFilter

Callback which is invoked when parsing an HTTP message fails. The processing logic has to take care about error handling and following connection closing.

Specified by:

onHttpError in class HttpCodecFilter

Parameters:

httpHeader - HttpHeader, which represents HTTP packet header

ctx - the FilterChainContext processing this request

Throws:

java.io.IOException

encodeHttpPacket

protected Buffer encodeHttpPacket(FilterChainContext ctx,
                                  HttpPacket input)

Overrides:

encodeHttpPacket in class HttpCodecFilter

customizeErrorResponse

protected HttpContent customizeErrorResponse(HttpResponsePacket response)

isAuthPassthroughEnabled

public boolean isAuthPassthroughEnabled()

setAuthPassthroughEnabled

public void setAuthPassthroughEnabled(boolean enabled)

isTraceEnabled

public boolean isTraceEnabled()

setTraceEnabled

public void setTraceEnabled(boolean enabled)

getDefaultResponseContentType

public java.lang.String getDefaultResponseContentType()

setDefaultResponseContentType

public void setDefaultResponseContentType(java.lang.String defaultResponseContentType)