io.servicetalk.http.utils

Class RedirectingHttpRequesterFilter

Object

RedirectingHttpRequesterFilter

All Implemented Interfaces:

HttpExecutionStrategyInfluencer, StreamingHttpClientFilterFactory, StreamingHttpConnectionFilterFactory, ExecutionStrategyInfluencer<HttpExecutionStrategy>

public final class RedirectingHttpRequesterFilter
extends Object
implements StreamingHttpClientFilterFactory, StreamingHttpConnectionFilterFactory

An HTTP request filter that performs automatic redirection if a client receives 3XX status code in the response.

Notes:

• This implementation will not parse a payload for 300 (Multiple Choices) response code, if a preferred choice's URI reference is not returned in the Location header.
• Depending on its parameters and context: HttpClient or HttpConnection, this filter may be limited to automatically following relative redirects only.
• This implementation will automatically redirect headers and message body for relative locations.
• For security reasons, this implementation will NOT automatically redirect headers and message body for non-relative locations. Use RedirectConfig to opt-in for redirect of requires request components.

Constructor Summary

Constructors

Constructor and Description
RedirectingHttpRequesterFilter() Create a new instance, only performing relative redirects.
RedirectingHttpRequesterFilter(RedirectConfig config) Create a new instance.

Method Summary

Modifier and Type	Method and Description
StreamingHttpClientFilter	create(FilterableStreamingHttpClient client)
StreamingHttpConnectionFilter	create(FilterableStreamingHttpConnection connection)
HttpExecutionStrategy	requiredOffloads()

Methods inherited from class Object

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

Methods inherited from interface HttpExecutionStrategyInfluencer

defaultStreamingInfluencer, influenceStrategy

Constructor Detail

RedirectingHttpRequesterFilter

public RedirectingHttpRequesterFilter()

Create a new instance, only performing relative redirects.

RedirectingHttpRequesterFilter

public RedirectingHttpRequesterFilter(RedirectConfig config)

Create a new instance.

Parameters:

config - RedirectConfig to customize the behavior.

Method Detail

create

public StreamingHttpClientFilter create(FilterableStreamingHttpClient client)

Specified by:

create in interface StreamingHttpClientFilterFactory

create

public StreamingHttpConnectionFilter create(FilterableStreamingHttpConnection connection)

Specified by:

create in interface StreamingHttpConnectionFilterFactory

requiredOffloads

public HttpExecutionStrategy requiredOffloads()

Specified by:

requiredOffloads in interface HttpExecutionStrategyInfluencer

Specified by:

requiredOffloads in interface ExecutionStrategyInfluencer<HttpExecutionStrategy>