|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.http.protocol.HttpService
public class HttpService
HttpService is a server side HTTP protocol handler based in the blocking
I/O model that implements the essential requirements of the HTTP protocol
for the server side message processing as described by RFC 2616.
HttpService relies on HttpProcessor
to generate mandatory protocol
headers for all outgoing messages and apply common, cross-cutting message
transformations to all incoming and outgoing messages, whereas individual
HttpRequestHandler
s are expected to take care of application specific
content generation and processing.
HttpService relies on HttpRequestHandler
to resolve matching request
handler for a particular request URI of an incoming HTTP request.
HttpService can use optional HttpExpectationVerifier
to ensure that
incoming requests meet server's expectations.
Constructor Summary | |
---|---|
HttpService(HttpProcessor proc,
ConnectionReuseStrategy connStrategy,
HttpResponseFactory responseFactory)
Deprecated. use HttpService(HttpProcessor,
ConnectionReuseStrategy, HttpResponseFactory, HttpRequestHandlerResolver, HttpParams) |
|
HttpService(HttpProcessor processor,
ConnectionReuseStrategy connStrategy,
HttpResponseFactory responseFactory,
HttpRequestHandlerResolver handlerResolver,
HttpExpectationVerifier expectationVerifier,
HttpParams params)
Create a new HTTP service. |
|
HttpService(HttpProcessor processor,
ConnectionReuseStrategy connStrategy,
HttpResponseFactory responseFactory,
HttpRequestHandlerResolver handlerResolver,
HttpParams params)
Create a new HTTP service. |
Method Summary | |
---|---|
protected void |
doService(HttpRequest request,
HttpResponse response,
HttpContext context)
The default implementation of this method attempts to resolve an HttpRequestHandler for the request URI of the given request
and, if found, executes its
HttpRequestHandler.handle(HttpRequest, HttpResponse, HttpContext)
method. |
HttpParams |
getParams()
|
protected void |
handleException(HttpException ex,
HttpResponse response)
Handles the given exception and generates an HTTP response to be sent back to the client to inform about the exceptional condition encountered in the course of the request processing. |
void |
handleRequest(HttpServerConnection conn,
HttpContext context)
Handles receives one HTTP request over the given connection within the given execution context and sends a response back to the client. |
void |
setConnReuseStrategy(ConnectionReuseStrategy connStrategy)
Deprecated. set ConnectionReuseStrategy using constructor |
void |
setExpectationVerifier(HttpExpectationVerifier expectationVerifier)
Deprecated. set HttpExpectationVerifier using constructor |
void |
setHandlerResolver(HttpRequestHandlerResolver handlerResolver)
Deprecated. set HttpRequestHandlerResolver using constructor |
void |
setHttpProcessor(HttpProcessor processor)
Deprecated. set HttpProcessor using constructor |
void |
setParams(HttpParams params)
Deprecated. set HttpResponseFactory using constructor |
void |
setResponseFactory(HttpResponseFactory responseFactory)
Deprecated. set HttpResponseFactory using constructor |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public HttpService(HttpProcessor processor, ConnectionReuseStrategy connStrategy, HttpResponseFactory responseFactory, HttpRequestHandlerResolver handlerResolver, HttpExpectationVerifier expectationVerifier, HttpParams params)
processor
- the processor to use on requests and responsesconnStrategy
- the connection reuse strategyresponseFactory
- the response factoryhandlerResolver
- the handler resolver. May be null.expectationVerifier
- the expectation verifier. May be null.params
- the HTTP parameterspublic HttpService(HttpProcessor processor, ConnectionReuseStrategy connStrategy, HttpResponseFactory responseFactory, HttpRequestHandlerResolver handlerResolver, HttpParams params)
processor
- the processor to use on requests and responsesconnStrategy
- the connection reuse strategyresponseFactory
- the response factoryhandlerResolver
- the handler resolver. May be null.params
- the HTTP parameterspublic HttpService(HttpProcessor proc, ConnectionReuseStrategy connStrategy, HttpResponseFactory responseFactory)
HttpService(HttpProcessor,
ConnectionReuseStrategy, HttpResponseFactory, HttpRequestHandlerResolver, HttpParams)
proc
- the processor to use on requests and responsesconnStrategy
- the connection reuse strategyresponseFactory
- the response factoryMethod Detail |
---|
public void setHttpProcessor(HttpProcessor processor)
HttpProcessor
using constructor
public void setConnReuseStrategy(ConnectionReuseStrategy connStrategy)
ConnectionReuseStrategy
using constructor
public void setResponseFactory(HttpResponseFactory responseFactory)
HttpResponseFactory
using constructor
public void setParams(HttpParams params)
HttpResponseFactory
using constructor
public void setHandlerResolver(HttpRequestHandlerResolver handlerResolver)
HttpRequestHandlerResolver
using constructor
public void setExpectationVerifier(HttpExpectationVerifier expectationVerifier)
HttpExpectationVerifier
using constructor
public HttpParams getParams()
public void handleRequest(HttpServerConnection conn, HttpContext context) throws IOException, HttpException
conn
- the active connection to the clientcontext
- the actual execution context.
IOException
- in case of an I/O error.
HttpException
- in case of HTTP protocol violation or a processing
problem.protected void handleException(HttpException ex, HttpResponse response)
ex
- the exception.response
- the HTTP response.protected void doService(HttpRequest request, HttpResponse response, HttpContext context) throws HttpException, IOException
HttpRequestHandler
for the request URI of the given request
and, if found, executes its
HttpRequestHandler.handle(HttpRequest, HttpResponse, HttpContext)
method.
Super-classes can override this method in order to provide a custom implementation of the request processing logic.
request
- the HTTP request.response
- the HTTP response.context
- the execution context.
IOException
- in case of an I/O error.
HttpException
- in case of HTTP protocol violation or a processing
problem.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |