com.faunos.util.net.http
Interface ResponseFactory

All Known Implementing Classes:

AbstractResponseFactory, ExceptionResponseFactory, FileResponseFactory, IdemResponseFactory, MappedSkwishResponseFactory, NotFoundResponseFactory, ResponseFactorySwitch, SkwishResponseFactory, UnimplementedVerbResponseFactory

public interface ResponseFactory

An application-specific interface used to configure an HttpServer.

Author:

Babak Farhang

See Also:

HttpServer

Method Summary

Stagelet

getResponse(RequestHeader request, StageletStack stack, boolean asynchHint) Returns a response stagelet for the given request.

Method Detail

getResponse

Stagelet getResponse(RequestHeader request,
                     StageletStack stack,
                     boolean asynchHint)

Returns a response stagelet for the given request. At minimum, the implementation returns a header stage that writes out the HTTP response headers. More typically, the returned stagelet will itself be only responsible for writing the response content; for the HTTP response headers, it will first push a ResponseHeaderStage on the given stack. (Per the stagelet contract, it must wait to push this header stage after its init method is invoked.

Parameters:

stack - if the returned stagelet is itself stack-aware, then it will push additional stagelets (e.g. the header response stage) onto the given stack. The rules for when and how stagelets can be pushed on the stack are described in the Stagelet interface.

asynchHint - if true, then the response stagelet should try to process non-network I/O based tasks asynchronously.

See Also:

Stagelet, HandletContext.processAsynch()