Class EarlyHintsAsyncExec

java.lang.Object

org.apache.hc.client5.http.impl.async.EarlyHintsAsyncExec

All Implemented Interfaces:

AsyncExecChainHandler

public final class EarlyHintsAsyncExec
extends Object
implements AsyncExecChainHandler

Execution chain handler that delivers 103 Early Hints informational responses to a user-provided EarlyHintsListener without affecting processing of the final (non-1xx) response.

This handler forwards each 103 informational response to the listener. All other responses (including the final response) are delegated unchanged.

For security and interoperability, applications typically act only on headers considered safe in Early Hints (for example, Link with rel=preload or rel=preconnect).

Since:

5.6

See Also:

• EarlyHintsListener
• HttpStatus.SC_EARLY_HINTS
• ResponseChannel.sendInformation(org.apache.hc.core5.http.HttpResponse, org.apache.hc.core5.http.protocol.HttpContext)

Field Summary

Fields

Modifier and Type	Field	Description
private final EarlyHintsListener	listener

Constructor Summary

Constructors

Constructor	Description
EarlyHintsAsyncExec(EarlyHintsListener listener)

Method Summary

Modifier and Type	Method	Description
void	execute(org.apache.hc.core5.http.HttpRequest request, org.apache.hc.core5.http.nio.AsyncEntityProducer entityProducer, AsyncExecChain.Scope scope, AsyncExecChain chain, AsyncExecCallback callback)	Executes the actual HTTP request.

Methods inherited from class Object

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

Field Details

listener

private final EarlyHintsListener listener

Constructor Details

EarlyHintsAsyncExec

public EarlyHintsAsyncExec(EarlyHintsListener listener)

Method Details

execute

public void execute(org.apache.hc.core5.http.HttpRequest request,
 org.apache.hc.core5.http.nio.AsyncEntityProducer entityProducer,
 AsyncExecChain.Scope scope,
 AsyncExecChain chain,
 AsyncExecCallback callback)
             throws org.apache.hc.core5.http.HttpException,
IOException

Description copied from interface: AsyncExecChainHandler

Executes the actual HTTP request. The handler can choose to return a response message immediately inside the call or asynchronously at some later point or delegate request execution to the next element in the execution chain.

Specified by:

execute in interface AsyncExecChainHandler

Parameters:

request - the actual request.

entityProducer - the request entity producer or null if the request does not enclose an entity.

scope - the execution scope .

chain - the next element in the request execution chain.

callback - the execution callback.

Throws:

org.apache.hc.core5.http.HttpException - If a protocol error occurs.

IOException - If an I/O error occurs.