Apache HttpComponents Core HTTP/1.1 5.2.4 · org.apache.hc.core5.http.protocol.RequestContent

RequestContent is the most important interceptor for outgoing requests. It is responsible for delimiting content length by adding Content-Length or Transfer-Content headers based on the properties of the enclosed entity and the protocol version. This interceptor is required for correct functioning of client side protocol processors.

Field Summary

Modifier and Type	Field and Description
public static final HttpRequestInterceptor	INSTANCE Singleton instance.
private final boolean	overwrite

Constructor Summary

Access	Constructor and Description
public	RequestContent() Default constructor.
public	RequestContent(final boolean If set to `true` the `Content-Length` and `Transfer-Encoding` headers will be created or updated if already present. If set to `false` the `Content-Length` and `Transfer-Encoding` headers will cause the interceptor to throw `ProtocolException` if already present in the response message. overwrite) Constructor that can be used to fine-tune behavior of this interceptor.

Method Summary

Modifier and Type	Method and Description
public void	process(final HttpRequest the request to process request, final EntityDetails the request entity details or `null` if not available entity, final HttpContext the context for the request context) Implements org.apache.hc.core5.http.HttpRequestInterceptor.process. Processes a request.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

INSTANCE	back to summary
public static final HttpRequestInterceptor INSTANCE Singleton instance. Since 5.2

INSTANCE

back to summary

public static final HttpRequestInterceptor INSTANCE

Singleton instance.

Since: 5.2

overwrite	back to summary
private final boolean overwrite

Constructor Detail

RequestContent	back to summary
public RequestContent() Default constructor. The `Content-Length` or `Transfer-Encoding` will cause the interceptor to throw `ProtocolException` if already present in the response message.

RequestContent back to summary

RequestContent	back to summary
public RequestContent(final boolean overwrite) Constructor that can be used to fine-tune behavior of this interceptor. Parameters overwrite:boolean If set to `true` the `Content-Length` and `Transfer-Encoding` headers will be created or updated if already present. If set to `false` the `Content-Length` and `Transfer-Encoding` headers will cause the interceptor to throw `ProtocolException` if already present in the response message. Since 4.2

public RequestContent(final boolean overwrite)

Constructor that can be used to fine-tune behavior of this interceptor.

Parameters

overwrite:boolean: If set to true the Content-Length and Transfer-Encoding headers will be created or updated if already present. If set to false the Content-Length and Transfer-Encoding headers will cause the interceptor to throw ProtocolException if already present in the response message.

Since

4.2

Method Detail

process back to summary

process	back to summary
public void process(final HttpRequest request, final EntityDetails entity, final HttpContext context) throws HttpException, IOException Implements org.apache.hc.core5.http.HttpRequestInterceptor.process. Doc from org.apache.hc.core5.http.HttpRequestInterceptor.process. Processes a request. On the client side, this step is performed before the request is sent to the server. On the server side, this step is performed on incoming messages before the message body is evaluated. Parameters request:HttpRequest the request to process entity:EntityDetails the request entity details or `null` if not available context:HttpContext the context for the request Annotations @Override Exceptions HttpException: in case of an HTTP protocol violation IOException: in case of an I/O error

public void process(final HttpRequest request, final EntityDetails entity, final HttpContext context) throws HttpException, IOException

Implements org.apache.hc.core5.http.HttpRequestInterceptor.process.

Doc from org.apache.hc.core5.http.HttpRequestInterceptor.process.

Processes a request. On the client side, this step is performed before the request is sent to the server. On the server side, this step is performed on incoming messages before the message body is evaluated.