Package org.apache.http.protocol

Class HttpService

java.lang.Object

org.apache.http.protocol.HttpService

@Contract(threading=IMMUTABLE_CONDITIONAL)
public class HttpService
extends Object

HttpService is a server side HTTP protocol handler based on the classic (blocking) I/O model.

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 HttpRequestHandlers are expected to implement application specific content generation and processing.

HttpService uses HttpRequestHandlerMapper to map 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.

Since:

4.0

Constructor Summary

Constructors

Constructor	Description
HttpService(HttpProcessor proc, ConnectionReuseStrategy connStrategy, HttpResponseFactory responseFactory)	Deprecated. (4.1) use HttpService(HttpProcessor, ConnectionReuseStrategy, HttpResponseFactory, HttpRequestHandlerResolver, HttpParams)
HttpService(HttpProcessor processor, ConnectionReuseStrategy connStrategy, HttpResponseFactory responseFactory, HttpRequestHandlerMapper handlerMapper)	Create a new HTTP service.
HttpService(HttpProcessor processor, ConnectionReuseStrategy connStrategy, HttpResponseFactory responseFactory, HttpRequestHandlerMapper handlerMapper, HttpExpectationVerifier expectationVerifier)	Create a new HTTP service.
HttpService(HttpProcessor processor, ConnectionReuseStrategy connStrategy, HttpResponseFactory responseFactory, HttpRequestHandlerResolver handlerResolver, HttpParams params)	Deprecated. (4.3) use HttpService(HttpProcessor, ConnectionReuseStrategy, HttpResponseFactory, HttpRequestHandlerMapper)
HttpService(HttpProcessor processor, ConnectionReuseStrategy connStrategy, HttpResponseFactory responseFactory, HttpRequestHandlerResolver handlerResolver, HttpExpectationVerifier expectationVerifier, HttpParams params)	Deprecated. (4.3) use HttpService(HttpProcessor, ConnectionReuseStrategy, HttpResponseFactory, HttpRequestHandlerMapper, HttpExpectationVerifier)
HttpService(HttpProcessor processor, HttpRequestHandlerMapper handlerMapper)	Create a new HTTP service.

Method Summary

Modifier and Type	Method	Description
HttpParams	getParams()	Deprecated. (4.3) no longer used.
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. (4.1) set ConnectionReuseStrategy using constructor
void	setExpectationVerifier(HttpExpectationVerifier expectationVerifier)	Deprecated. (4.1) set HttpExpectationVerifier using constructor
void	setHandlerResolver(HttpRequestHandlerResolver handlerResolver)	Deprecated. (4.1) set HttpRequestHandlerResolver using constructor
void	setHttpProcessor(HttpProcessor processor)	Deprecated. (4.1) set HttpProcessor using constructor
void	setParams(HttpParams params)	Deprecated. (4.1) set HttpResponseFactory using constructor
void	setResponseFactory(HttpResponseFactory responseFactory)	Deprecated. (4.1) set HttpResponseFactory using constructor

Methods inherited from class java.lang.Object

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

Constructor Details

HttpService

@Deprecated
public HttpService(HttpProcessor processor,
 ConnectionReuseStrategy connStrategy,
 HttpResponseFactory responseFactory,
 HttpRequestHandlerResolver handlerResolver,
 HttpExpectationVerifier expectationVerifier,
 HttpParams params)

Deprecated.

(4.3) use HttpService(HttpProcessor, ConnectionReuseStrategy, HttpResponseFactory, HttpRequestHandlerMapper, HttpExpectationVerifier)

Create a new HTTP service.

Parameters:

processor - the processor to use on requests and responses

connStrategy - the connection reuse strategy

responseFactory - the response factory

handlerResolver - the handler resolver. May be null.

expectationVerifier - the expectation verifier. May be null.

params - the HTTP parameters

Since:

4.1

HttpService

@Deprecated
public HttpService(HttpProcessor processor,
 ConnectionReuseStrategy connStrategy,
 HttpResponseFactory responseFactory,
 HttpRequestHandlerResolver handlerResolver,
 HttpParams params)

Deprecated.

(4.3) use HttpService(HttpProcessor, ConnectionReuseStrategy, HttpResponseFactory, HttpRequestHandlerMapper)

Create a new HTTP service.

Parameters:

processor - the processor to use on requests and responses

connStrategy - the connection reuse strategy

responseFactory - the response factory

handlerResolver - the handler resolver. May be null.

params - the HTTP parameters

Since:

4.1

HttpService

@Deprecated
public HttpService(HttpProcessor proc,
 ConnectionReuseStrategy connStrategy,
 HttpResponseFactory responseFactory)

Deprecated.

(4.1) use HttpService(HttpProcessor, ConnectionReuseStrategy, HttpResponseFactory, HttpRequestHandlerResolver, HttpParams)

Create a new HTTP service.

Parameters:

proc - the processor to use on requests and responses

connStrategy - the connection reuse strategy

responseFactory - the response factory

HttpService

public HttpService(HttpProcessor processor,
 ConnectionReuseStrategy connStrategy,
 HttpResponseFactory responseFactory,
 HttpRequestHandlerMapper handlerMapper,
 HttpExpectationVerifier expectationVerifier)

Create a new HTTP service.

Parameters:

processor - the processor to use on requests and responses

connStrategy - the connection reuse strategy. If null DefaultConnectionReuseStrategy.INSTANCE will be used.

responseFactory - the response factory. If null DefaultHttpResponseFactory.INSTANCE will be used.

handlerMapper - the handler mapper. May be null.

expectationVerifier - the expectation verifier. May be null.

Since:

4.3

HttpService

public HttpService(HttpProcessor processor,
 ConnectionReuseStrategy connStrategy,
 HttpResponseFactory responseFactory,
 HttpRequestHandlerMapper handlerMapper)

Create a new HTTP service.

Parameters:

processor - the processor to use on requests and responses

connStrategy - the connection reuse strategy. If null DefaultConnectionReuseStrategy.INSTANCE will be used.

responseFactory - the response factory. If null DefaultHttpResponseFactory.INSTANCE will be used.

handlerMapper - the handler mapper. May be null.

Since:

4.3

HttpService

public HttpService(HttpProcessor processor,
 HttpRequestHandlerMapper handlerMapper)

Create a new HTTP service.

Parameters:

processor - the processor to use on requests and responses

handlerMapper - the handler mapper. May be null.

Since:

4.3

Method Details

setHttpProcessor

@Deprecated
public void setHttpProcessor(HttpProcessor processor)

Deprecated.

(4.1) set HttpProcessor using constructor

setConnReuseStrategy

@Deprecated
public void setConnReuseStrategy(ConnectionReuseStrategy connStrategy)

Deprecated.

(4.1) set ConnectionReuseStrategy using constructor

setResponseFactory

@Deprecated
public void setResponseFactory(HttpResponseFactory responseFactory)

Deprecated.

(4.1) set HttpResponseFactory using constructor

setParams

@Deprecated
public void setParams(HttpParams params)

Deprecated.

(4.1) set HttpResponseFactory using constructor

setHandlerResolver

@Deprecated
public void setHandlerResolver(HttpRequestHandlerResolver handlerResolver)

Deprecated.

(4.1) set HttpRequestHandlerResolver using constructor

setExpectationVerifier

@Deprecated
public void setExpectationVerifier(HttpExpectationVerifier expectationVerifier)

Deprecated.

(4.1) set HttpExpectationVerifier using constructor

getParams

@Deprecated
public HttpParams getParams()

Deprecated.

(4.3) no longer used.

handleRequest

public void handleRequest(HttpServerConnection conn,
 HttpContext context)
                   throws IOException,
HttpException

Handles receives one HTTP request over the given connection within the given execution context and sends a response back to the client.

Parameters:

conn - the active connection to the client

context - the actual execution context.

Throws:

IOException - in case of an I/O error.

HttpException - in case of HTTP protocol violation or a processing problem.