simple.http
Interface ProtocolHandler

All Known Implementing Classes:
DomainHandler

public interface ProtocolHandler

This is a ProtocolHandler that is used to process HTTP Request and Response objects. The intended purpose of the ProtocolHandler object is to process Request and Response objects, that is, respond to the given Request.

Any implementation should make this method thread safe as the Request and Response objects will be passed in concurrently with perhaps many other instances.

The ProtocolHandler is entirely responsible for the HTTP message headers and body. It is up to the implementation to ensure that it complies to RFC 2616 or any previous specification. All headers and the status line can be modified by this object.

Author:
Niall Gallagher

Method Summary
 void handle(Request req, Response resp)
          Used to pass the Request and Response to the ProtocolHandler for processing.
 

Method Detail

handle

void handle(Request req,
            Response resp)
Used to pass the Request and Response to the ProtocolHandler for processing. Any implementation of this interface must ensure that this is thread safe, it will be invoked concurrently.

The Request and Response objects are in control of the HTTP pipeline. If the next HTTP request is to be processed the Response MUST be committed and the Request MUST have its content fully read or the InputStream closed if there is content.

Parameters:
req - the request object to be processed
resp - the Response object to be processed