Package org.geotools.http

Class SimpleHttpClient

Object

AbstractHttpClient

SimpleHttpClient

All Implemented Interfaces:

HTTPBehavior, HTTPClient, HTTPProxy

public class SimpleHttpClient
extends AbstractHttpClient
implements HTTPProxy

A simple HTTPClient that creates a new HTTP connection for each request.

Author:

groldan

Field Summary

Fields inherited from class AbstractHttpClient

connectTimeout, extraParams, password, readTimeout, tryGzip, user

Constructor Summary

Constructors

Constructor	Description
SimpleHttpClient()	A SimpleHttpClient should be initiated by a call to HTTPFactoryFinder.getHttpClientFactory().getClient();

Method Summary

Modifier and Type	Method	Description
HTTPResponse	get(URL url)	Executes an HTTP GET request against the provided URL and returns the server response.
HTTPResponse	get(URL url, Map<String,String> headers)	Executes an HTTP GET request against the provided URL and returns the server response.
HTTPResponse	post(URL url, InputStream content, String contentType)	Executes an HTTP POST request against the provided URL, sending the contents of postContent as the POST method body and setting the Content-Type request header to postContentType if given, and returns the server response.
HTTPResponse	post(URL url, InputStream postContent, String postContentType, Map<String,String> headers)	Executes an HTTP POST request against the provided URL, sending the contents of postContent as the POST method body and setting the Content-Type request header to postContentType if given, and returns the server response.

Methods inherited from class AbstractHttpClient

appendURL, createFileResponse, getConnectTimeout, getExtraParams, getPassword, getReadTimeout, getUser, isFile, isTryGzip, setConnectTimeout, setExtraParams, setPassword, setReadTimeout, setTryGzip, setUser

Methods inherited from class Object

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

Constructor Details

SimpleHttpClient

public SimpleHttpClient()

A SimpleHttpClient should be initiated by a call to HTTPFactoryFinder.getHttpClientFactory().getClient();

Method Details

get

public HTTPResponse get(URL url)
                 throws IOException

Description copied from interface: HTTPClient

Executes an HTTP GET request against the provided URL and returns the server response.

If an HTTP authentication user and password is set, the appropriate authentication HTTP header will be sent with the request.

If a connection timeout is set, the http connection will be set to respect that timeout.

If a read timeout is set, the http connection will be set to respect it.

Specified by:

get in interface HTTPClient

Parameters:

url - the URL to retrieve

Returns:

an HTTPResponse encapsulating the response to the HTTP GET request

Throws:

IOException

See Also:

• HTTPClient.get(java.net.URL)

get

public HTTPResponse get(URL url,
 Map<String,String> headers)
                 throws IOException

Description copied from interface: HTTPClient

Executes an HTTP GET request against the provided URL and returns the server response.

If an HTTP authentication user and password is set, the appropriate authentication HTTP header will be sent with the request.

If a connection timeout is set, the http connection will be set to respect that timeout.

If a read timeout is set, the http connection will be set to respect it.

header parameter contains additional headers to add to the request.

Specified by:

get in interface HTTPClient

Parameters:

url - the URL to retrieve

headers - a list of custom headers to add to the request.

Returns:

an HTTPResponse encapsulating the response to the HTTP GET request

Throws:

IOException

See Also:

• HTTPClient.get(URL, Map)

post

public HTTPResponse post(URL url,
 InputStream content,
 String contentType)
                  throws IOException

Description copied from interface: HTTPClient

Executes an HTTP POST request against the provided URL, sending the contents of postContent as the POST method body and setting the Content-Type request header to postContentType if given, and returns the server response.

If an HTTP authentication user and password is set, the appropriate authentication HTTP header will be sent with the request.

If a connection timeout is set, the http connection will be set to respect that timeout.

If a read timeout is set, the http connection will be set to respect it.

Specified by:

post in interface HTTPClient

Specified by:

post in class AbstractHttpClient

Parameters:

url - the URL against which to execute the POST request

content - an input stream with the contents of the POST body

contentType - the MIME type of the contents sent as the request POST body, can be null

Returns:

the HTTPResponse encapsulating the response to the HTTP POST request

Throws:

IOException

See Also:

• HTTPClient.post(URL, InputStream, String, Map)

post

public HTTPResponse post(URL url,
 InputStream postContent,
 String postContentType,
 Map<String,String> headers)
                  throws IOException

Description copied from interface: HTTPClient

Executes an HTTP POST request against the provided URL, sending the contents of postContent as the POST method body and setting the Content-Type request header to postContentType if given, and returns the server response.

If an HTTP authentication user and password is set, the appropriate authentication HTTP header will be sent with the request.

If a connection timeout is set, the http connection will be set to respect that timeout.

If a read timeout is set, the http connection will be set to respect it.

header parameter contains additional headers to add to the request.

Specified by:

post in interface HTTPClient

Parameters:

url - the URL against which to execute the POST request

postContent - an input stream with the contents of the POST body

postContentType - the MIME type of the contents sent as the request POST body, can be null

headers - a list of custom headers to add to the request.

Returns:

the HTTPResponse encapsulating the response to the HTTP POST request

Throws:

IOException

See Also:

• HTTPClient.post(URL, InputStream, String)