org.mortbay.http

Interface HttpHandler

public interface HttpHandler extends LifeCycle, Serializable

HTTP handler. The HTTP Handler interface is implemented by classes that wish to receive and handle requests from the HttpServer. The handle method is called for each request and the handler may ignore, modify or handle the request. Examples of HttpHandler instances include:

Version: $Id: HttpHandler.java,v 1.11 2005/03/15 10:03:40 gregwilkins Exp $

Author: Greg Wilkins (gregw)

See Also: HttpServer HttpContext

Method Summary
HttpContextgetHttpContext()
StringgetName()
Get the name of the handler.
voidhandle(String pathInContext, String pathParams, HttpRequest request, HttpResponse response)
Handle a request.
voidinitialize(HttpContext context)

Method Detail

getHttpContext

public HttpContext getHttpContext()

getName

public String getName()
Get the name of the handler.

Returns: The name of the handler used for logging and reporting.

handle

public void handle(String pathInContext, String pathParams, HttpRequest request, HttpResponse response)
Handle a request. Note that Handlers are tried in order until one has handled the request. i.e. until request.isHandled() returns true. In broad terms this means, either a response has been commited or request.setHandled(true) has been called.

Parameters: pathInContext The context path pathParams Path parameters such as encoded Session ID request The HttpRequest request response The HttpResponse response

initialize

public void initialize(HttpContext context)
Copyright © 2004 Mortbay Consulting Pty. Ltd. All Rights Reserved.