com.atlassian.confluence.util.http
Interface HttpRetrievalService

All Known Implementing Classes:

BaseHttpRetrievalService, HttpClientHttpRetrievalService

public interface HttpRetrievalService

Field Summary

static int	DEFAULT_MAX_CACHE_AGE
static int	DEFAULT_MAX_DOWNLOAD_SIZE
static java.lang.String	HTTP_INCLUDE_STACK_HEADER Deprecated. since 3.3 use ResponseHeaderNames.STACK_DEPTH
static int	HTTP_INCLUDE_STACK_MAX_DEPTH
static java.lang.String	HTTP_USER_AGENT_STRING

Method Summary

HttpResponse	get(HttpRequest request) Retrieve a URL using custom HttpRequest settings
HttpResponse	get(java.lang.String url) Retrieve a URL using the default HttpRequest settings for that URL.
java.lang.Class[]	getAvailableAuthenticators() Retrieve the list of authenticators that can be used with this HttpRetrievalService
HttpRequest	getDefaultRequestFor(java.lang.String url) Retrieve the default configured HttpRequest for a particular URL.
HttpRetrievalServiceConfig	getHttpRetrievalServiceConfig() Retrieve the configuration for this service
void	setHttpRetrievalServiceConfig(HttpRetrievalServiceConfig config) Overwrite the configuration for this service

Field Detail

DEFAULT_MAX_DOWNLOAD_SIZE

static final int DEFAULT_MAX_DOWNLOAD_SIZE

See Also:

Constant Field Values

DEFAULT_MAX_CACHE_AGE

static final int DEFAULT_MAX_CACHE_AGE

See Also:

Constant Field Values

HTTP_INCLUDE_STACK_HEADER

@Deprecated
static final java.lang.String HTTP_INCLUDE_STACK_HEADER

Deprecated. since 3.3 use ResponseHeaderNames.STACK_DEPTH

See Also:

Constant Field Values

HTTP_INCLUDE_STACK_MAX_DEPTH

static final int HTTP_INCLUDE_STACK_MAX_DEPTH

See Also:

Constant Field Values

HTTP_USER_AGENT_STRING

static final java.lang.String HTTP_USER_AGENT_STRING

See Also:

Constant Field Values

Method Detail

get

HttpResponse get(java.lang.String url)
                 throws java.io.IOException

Retrieve a URL using the default HttpRequest settings for that URL. The equivalent of calling get(service.getDefaultRequestFor(url));

Parameters:

url - the URL to retrieve

Returns:

a response object encapsulating the result of the request

Throws:

java.io.IOException - if the retrieval fails

get

HttpResponse get(HttpRequest request)
                 throws java.io.IOException

Retrieve a URL using custom HttpRequest settings

Parameters:

request - the request we want to make

Returns:

a response object encapsulating the result of the request

Throws:

java.io.IOException - if the retrieval fails

getDefaultRequestFor

HttpRequest getDefaultRequestFor(java.lang.String url)

Retrieve the default configured HttpRequest for a particular URL. Will come prepackaged with the configured system defaults for authentication, retrieval size and caching.

Parameters:

url - the URL that is going to be retrieved

Returns:

the system default HttpRequest for that URL.

getAvailableAuthenticators

java.lang.Class[] getAvailableAuthenticators()

Retrieve the list of authenticators that can be used with this HttpRetrievalService

Returns:

the list of authenticators that can be used with this HttpRetrievalService

getHttpRetrievalServiceConfig

HttpRetrievalServiceConfig getHttpRetrievalServiceConfig()

Retrieve the configuration for this service

Returns:

the service configuration

setHttpRetrievalServiceConfig

void setHttpRetrievalServiceConfig(HttpRetrievalServiceConfig config)

Overwrite the configuration for this service

Parameters:

config - the service configuration to save