com.atlassian.httpclient.api

Class ForwardingHttpClient

java.lang.Object

com.google.common.collect.ForwardingObject

com.atlassian.httpclient.api.ForwardingHttpClient

All Implemented Interfaces:

HttpClient

public abstract class ForwardingHttpClient
extends com.google.common.collect.ForwardingObject
implements HttpClient

An HTTP Client which forwards all its method calls to another HTTP Client. Subclasses should override one or more methods to modify the behavior of the backing HTTP Client as desired per the decorator pattern.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForwardingHttpClient() Constructor for use by subclasses.

Method Summary

Modifier and Type	Method and Description
protected abstract HttpClient	delegate()
void	flushCacheByUriPattern(Pattern uriPattern) Flush the cache entries by matching the URI using a regular expression
Request.Builder	newRequest() Constructs a new request.
Request.Builder	newRequest(String uri) Constructs a new Request with the specified URI.
Request.Builder	newRequest(String uri, String contentType, String entity) Constructs a new Request with the specified URI, contentType, and entity.
Request.Builder	newRequest(URI uri) Constructs a new Request with the specified URI.
Request.Builder	newRequest(URI uri, String contentType, String entity) Constructs a new Request with the specified URI, contentType, and entity.

Methods inherited from class com.google.common.collect.ForwardingObject

toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.httpclient.api.HttpClient

execute, transformation

Constructor Detail

ForwardingHttpClient

protected ForwardingHttpClient()

Constructor for use by subclasses.

Method Detail

delegate

protected abstract HttpClient delegate()

Specified by:

delegate in class com.google.common.collect.ForwardingObject

newRequest

public Request.Builder newRequest()

Description copied from interface: HttpClient

Constructs a new request. Sets the accept property to a default of "*/*".

Specified by:

newRequest in interface HttpClient

Returns:

The new request object

newRequest

public Request.Builder newRequest(URI uri)

Description copied from interface: HttpClient

Constructs a new Request with the specified URI. Sets the accept property to a default of "*/*".

Specified by:

newRequest in interface HttpClient

Parameters:

uri - The endpoint URI for this request

Returns:

The new request object

newRequest

public Request.Builder newRequest(String uri)

Description copied from interface: HttpClient

Constructs a new Request with the specified URI. Sets the accept property to a default of "*/*".

Specified by:

newRequest in interface HttpClient

Parameters:

uri - The endpoint URI for this request

Returns:

The new request object

newRequest

public Request.Builder newRequest(URI uri,
                                  String contentType,
                                  String entity)

Description copied from interface: HttpClient

Constructs a new Request with the specified URI, contentType, and entity. Sets the accept property to a default of "*/*", and the content charset property to "UTF-8". This should only be used for sending textual content types, typically via the POST or PUT HTTP methods.

Specified by:

newRequest in interface HttpClient

Parameters:

uri - The endpoint URI for this request

contentType - A textual IANA media type

entity - A string entity to send as this request's message body

Returns:

The new request object

newRequest

public Request.Builder newRequest(String uri,
                                  String contentType,
                                  String entity)

Description copied from interface: HttpClient

Constructs a new Request with the specified URI, contentType, and entity. Sets the accept property to a default of "*/*", and the content charset property to "UTF-8". This should only be used for sending textual content types, typically via the POST or PUT HTTP methods.

Specified by:

newRequest in interface HttpClient

Parameters:

uri - The endpoint URI for this request

contentType - A textual IANA media type

entity - A string entity to send as this request's message body

Returns:

The new request object

flushCacheByUriPattern

public void flushCacheByUriPattern(Pattern uriPattern)

Description copied from interface: HttpClient

Flush the cache entries by matching the URI using a regular expression

Specified by:

flushCacheByUriPattern in interface HttpClient

Parameters:

uriPattern - The regular expression to match