Package org.glassfish.grizzly.http.server

Class HttpHandlerChain

java.lang.Object

org.glassfish.grizzly.http.server.HttpHandler

org.glassfish.grizzly.http.server.HttpHandlerChain

All Implemented Interfaces:

JmxEventListener

public class HttpHandlerChain
extends HttpHandler
implements JmxEventListener

The HttpHandlerChain class allows the invocation of multiple HttpHandlers every time a new HTTP request is ready to be handled. Requests are mapped to their associated HttpHandler at runtime using the mapping information configured when invoking the (org.glassfish.grizzly.http.server.HttpHandler, java.lang.String[])

Author:

Jeanfrancois Arcand

Constructor Summary

Constructors

Constructor	Description
HttpHandlerChain(HttpServer httpServer)

Method Summary

Modifier and Type	Method	Description
void	addHandler(HttpHandler httpHandler, String[] mappings)	Add a HttpHandler and its associated array of mapping.
void	addHandler(HttpHandler httpHandler, HttpHandlerRegistration[] mappings)	Add a HttpHandler and its associated array of mapping.
void	destroy()	Invoked when the HttpServer and may be overridden by custom implementations to perform implementation specific resource reclaimation tasks.
void	jmxDisabled()	Invoked when JMX has been disabled.
void	jmxEnabled()	Invoked when JMX has been enabled.
void	removeAllHttpHandlers()
boolean	removeHttpHandler(HttpHandler httpHandler)	Remove a HttpHandler
void	service(Request request, Response response)	Map the Request to the proper HttpHandler
void	start()	Called when the HttpHandler's container is started by invoking HttpServer.start().

Methods inherited from class org.glassfish.grizzly.http.server.HttpHandler

getErrorPageGenerator, getName, getRequestExecutorProvider, getRequestURIEncoding, getSessionCookieName, getSessionManager, isAllowCustomStatusMessage, isAllowEncodedSlash, sendAcknowledgment, setAllowCustomStatusMessage, setAllowEncodedSlash, setDecodeUrl, setDispatcherHelper, setRequestURIEncoding, setRequestURIEncoding, updatePaths

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpHandlerChain

public HttpHandlerChain(HttpServer httpServer)

Method Detail

jmxEnabled

public void jmxEnabled()

Description copied from interface: JmxEventListener

Invoked when JMX has been enabled.

Specified by:

jmxEnabled in interface JmxEventListener

See Also:

ServerConfiguration.setJmxEnabled(boolean)

jmxDisabled

public void jmxDisabled()

Description copied from interface: JmxEventListener

Invoked when JMX has been disabled.

Specified by:

jmxDisabled in interface JmxEventListener

See Also:

ServerConfiguration.setJmxEnabled(boolean)

service

public void service(Request request,
                    Response response)
             throws Exception

Map the Request to the proper HttpHandler

Specified by:

service in class HttpHandler

Parameters:

request - The Request

response - The Response

Throws:

Exception

addHandler

public void addHandler(HttpHandler httpHandler,
                       String[] mappings)

Add a HttpHandler and its associated array of mapping. The mapping data will be used to map incoming request to its associated HttpHandler.

Parameters:

httpHandler - HttpHandler instance

mappings - an array of mapping.

addHandler

public void addHandler(HttpHandler httpHandler,
                       HttpHandlerRegistration[] mappings)

Add a HttpHandler and its associated array of mapping. The mapping data will be used to map incoming request to its associated HttpHandler.

Parameters:

httpHandler - HttpHandler instance

mappings - an array of mapping.

removeHttpHandler

public boolean removeHttpHandler(HttpHandler httpHandler)

Remove a HttpHandler

Parameters:

httpHandler - HttpHandler to remove

Returns:

true if removed

removeAllHttpHandlers

public void removeAllHttpHandlers()

start

public void start()

Description copied from class: HttpHandler

Called when the HttpHandler's container is started by invoking HttpServer.start(). By default, it does nothing.

Overrides:

start in class HttpHandler

destroy

public void destroy()

Description copied from class: HttpHandler

Invoked when the HttpServer and may be overridden by custom implementations to perform implementation specific resource reclaimation tasks. By default, this method does nothing.

Overrides:

destroy in class HttpHandler