org.apache.hc.core5.http.nio

接口 AsyncServerRequestHandler<T>

类型参数:

T - request representation.

@Contract(threading=STATELESS)
public interface AsyncServerRequestHandler<T>

AsyncServerRequestHandler represents a routine for processing of a specific group of HTTP requests. Request execution filters are designed to take care of protocol specific aspects, whereas individual request handlers are expected to take care of application specific HTTP processing. The main purpose of a request handler is to generate a response object with a content entity to be sent back to the client in response to the given request.

从以下版本开始:

5.0

嵌套类概要

嵌套类

限定符和类型	接口和说明
static interface	AsyncServerRequestHandler.ResponseTrigger Response trigger that can be used to submit a final HTTP response and terminate HTTP request processing.

方法概要

限定符和类型	方法和说明
void	handle(T requestObject, AsyncServerRequestHandler.ResponseTrigger responseTrigger, HttpContext context) Triggered to handles the request object produced by the AsyncRequestConsumer returned from the prepare(HttpRequest, EntityDetails, HttpContext) method.
AsyncRequestConsumer<T>	prepare(HttpRequest request, EntityDetails entityDetails, HttpContext context) Triggered to signal new incoming request.

方法详细资料

prepare

AsyncRequestConsumer<T> prepare(HttpRequest request,
                                EntityDetails entityDetails,
                                HttpContext context)
                         throws HttpException

Triggered to signal new incoming request. The handler can create a AsyncRequestConsumer based on properties of the request head and entity details and let it process the request data stream. The request handler will be used to generate an object that represents request data.

参数:

request - the incoming request head.

entityDetails - the request entity details or null if the request does not enclose an entity.

context - the actual execution context.

返回:

the request handler.

抛出:

HttpException

handle

void handle(T requestObject,
            AsyncServerRequestHandler.ResponseTrigger responseTrigger,
            HttpContext context)
     throws HttpException,
            IOException

Triggered to handles the request object produced by the AsyncRequestConsumer returned from the prepare(HttpRequest, EntityDetails, HttpContext) method. The handler can choose to send response messages immediately inside the call or asynchronously at some later point.

参数:

requestObject - the request object.

responseTrigger - the response trigger.

context - the actual execution context.

抛出:

HttpException

IOException