net.lenni0451.commons.httpclient

Class HttpClient

java.lang.Object

net.lenni0451.commons.httpclient.HeaderStore<HttpClient>

net.lenni0451.commons.httpclient.HttpClient

All Implemented Interfaces:

HttpRequestBuilder

public class HttpClient
extends HeaderStore<HttpClient>
implements HttpRequestBuilder

Constructor Summary

Constructors

Constructor and Description
HttpClient()

Method Summary

Modifier and Type	Method and Description
HttpResponse	execute(HttpRequest request) Execute a request and return the response.
<R> R	execute(HttpRequest request, HttpResponseHandler<R> responseHandler) Execute a request and pass the response to the response handler.
int	getConnectTimeout()
java.net.CookieManager	getCookieManager()
int	getReadTimeout()
RetryHandler	getRetryHandler()
boolean	isFollowRedirects()
HttpClient	setConnectTimeout(int connectTimeout) Set the connect timeout for all requests.
HttpClient	setCookieManager(java.net.CookieManager cookieManager) Set the cookie manager to use for all requests.
HttpClient	setFollowRedirects(boolean followRedirects) Set whether redirects should be followed.
HttpClient	setReadTimeout(int readTimeout) Set the read timeout for all requests.
HttpClient	setRetryHandler(RetryHandler retryHandler) Set the retry handler for all requests.

Methods inherited from class net.lenni0451.commons.httpclient.HeaderStore

appendHeader, appendHeader, appendHeader, clearHeaders, getFirstHeader, getHeader, getHeaders, getLastHeader, hasHeader, hasHeader, hasHeader, removeHeader, setHeader, setHeader, setHeader

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.lenni0451.commons.httpclient.HttpRequestBuilder

contentRequest, contentRequest, delete, delete, get, get, head, head, post, post, put, put, request, request

Constructor Detail

HttpClient

public HttpClient()

Method Detail

getCookieManager

@Nullable
public java.net.CookieManager getCookieManager()

Returns:

The cookie manager

setCookieManager

public HttpClient setCookieManager(@Nullable
                                   java.net.CookieManager cookieManager)

Set the cookie manager to use for all requests.
If this is null no cookies will be used.

Parameters:

cookieManager - The cookie manager to use

Returns:

This instance for chaining

isFollowRedirects

public boolean isFollowRedirects()

Returns:

Whether redirects should be followed

setFollowRedirects

public HttpClient setFollowRedirects(boolean followRedirects)

Set whether redirects should be followed.

Parameters:

followRedirects - Whether redirects should be followed

Returns:

This instance for chaining

getConnectTimeout

public int getConnectTimeout()

Returns:

The connect timeout for all requests in milliseconds

setConnectTimeout

public HttpClient setConnectTimeout(int connectTimeout)

Set the connect timeout for all requests.

Parameters:

connectTimeout - The connect timeout in milliseconds

Returns:

This instance for chaining

getReadTimeout

public int getReadTimeout()

Returns:

The read timeout for all requests in milliseconds

setReadTimeout

public HttpClient setReadTimeout(int readTimeout)

Set the read timeout for all requests.

Parameters:

readTimeout - The read timeout in milliseconds

Returns:

This instance for chaining

getRetryHandler

public RetryHandler getRetryHandler()

Returns:

The retry handler

setRetryHandler

public HttpClient setRetryHandler(RetryHandler retryHandler)

Set the retry handler for all requests.

Parameters:

retryHandler - The retry handler

Returns:

This instance for chaining

execute

public <R> R execute(@Nonnull
                     HttpRequest request,
                     @Nonnull
                     HttpResponseHandler<R> responseHandler)
              throws java.io.IOException

Execute a request and pass the response to the response handler.
The return value of the response handler will be returned.

Type Parameters:

R - The return type of the response handler

Parameters:

request - The request to execute

responseHandler - The response handler

Returns:

The return value of the response handler

Throws:

java.io.IOException - If an I/O error occurs

execute

public HttpResponse execute(@Nonnull
                            HttpRequest request)
                     throws java.io.IOException

Execute a request and return the response.

Parameters:

request - The request to execute

Returns:

The response

Throws:

java.io.IOException - If an I/O error occurs

RetryExceededException - If the maximum header retry count was exceeded

java.lang.IllegalStateException - If the maximum retry count was exceeded but no exception was thrown