io.servicetalk.http.api

Interface BlockingStreamingHttpRequester

All Superinterfaces:

AutoCloseable, BlockingStreamingHttpRequestFactory, GracefulAutoCloseable

All Known Subinterfaces:

BlockingStreamingHttpClient, BlockingStreamingHttpConnection, ReservedBlockingStreamingHttpConnection

public interface BlockingStreamingHttpRequester
extends BlockingStreamingHttpRequestFactory, GracefulAutoCloseable

The equivalent of StreamingHttpRequester but with synchronous/blocking APIs instead of asynchronous APIs.

Method Summary

Modifier and Type	Method and Description
default void	close()
HttpExecutionContext	executionContext() Get the HttpExecutionContext used during construction of this object.
BlockingStreamingHttpResponseFactory	httpResponseFactory() Get a BlockingStreamingHttpResponseFactory.
default BlockingStreamingHttpResponse	request(BlockingStreamingHttpRequest request) Send a request.
default BlockingStreamingHttpResponse	request(HttpExecutionStrategy strategy, BlockingStreamingHttpRequest request) Deprecated. Use request(BlockingStreamingHttpRequest). If an HttpExecutionStrategy needs to be altered, provide a value for HttpContextKeys.HTTP_EXECUTION_STRATEGY_KEY in the request context.

Methods inherited from interface BlockingStreamingHttpRequestFactory

connect, delete, get, head, newRequest, options, patch, post, put, trace

Methods inherited from interface GracefulAutoCloseable

closeGracefully

Method Detail

request

default BlockingStreamingHttpResponse request(BlockingStreamingHttpRequest request)
                                       throws Exception

Send a request.

Parameters:

request - the request to send.

Returns:

The response.

Throws:

Exception

request

@Deprecated
default BlockingStreamingHttpResponse request(HttpExecutionStrategy strategy,
                                                          BlockingStreamingHttpRequest request)
                                                   throws Exception

Deprecated. Use request(BlockingStreamingHttpRequest). If an HttpExecutionStrategy needs to be altered, provide a value for HttpContextKeys.HTTP_EXECUTION_STRATEGY_KEY in the request context.

Send a request using the passed strategy.

Parameters:

strategy - HttpExecutionStrategy to use.

request - the request to send.

Returns:

The response.

Throws:

Exception - if an exception occurs during the request processing.

executionContext

HttpExecutionContext executionContext()

Get the HttpExecutionContext used during construction of this object.

Note that the ExecutionContext.ioExecutor() will not necessarily be associated with a specific thread unless that was how this object was built.

Returns:

the HttpExecutionContext used during construction of this object.

httpResponseFactory

BlockingStreamingHttpResponseFactory httpResponseFactory()

Get a BlockingStreamingHttpResponseFactory.

Returns:

a BlockingStreamingHttpResponseFactory.

close

default void close()
            throws Exception

Specified by:

close in interface AutoCloseable

Throws:

Exception