com.amazonaws.util

Class HttpUtils

java.lang.Object

com.amazonaws.util.HttpUtils

public class HttpUtils
extends Object

HTTP utils class.

Constructor Summary

Constructors

Constructor and Description
HttpUtils()

Method Summary

Modifier and Type	Method and Description
static String	appendUri(String baseUri, String path) Append the given path to the given baseUri.
static String	appendUri(String baseUri, String path, boolean escapeDoubleSlash) Append the given path to the given baseUri.
static String	encodeParameters(Request<?> request) Creates an encoded query string from all the parameters in the specified request.
static InputStream	fetchFile(URI uri, ClientConfiguration config) Fetches a file from the URI given and returns an input stream to it.
static boolean	isUsingNonDefaultPort(URI uri) Returns true if the specified URI is using a non-standard port (i.e.
static String	urlDecode(String value) Decode a string for use in the path of a URL; uses URLDecoder.decode, which decodes a string for use in the query portion of a URL.
static String	urlEncode(String value, boolean path) Encode a string for use in the path of a URL; uses URLEncoder.encode, (which encodes a string for use in the query portion of a URL), then applies some postfilters to fix things up per the RFC.
static boolean	usePayloadForQueryParameters(Request<?> request)

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpUtils

public HttpUtils()

Method Detail

urlEncode

public static String urlEncode(String value,
                               boolean path)

Encode a string for use in the path of a URL; uses URLEncoder.encode, (which encodes a string for use in the query portion of a URL), then applies some postfilters to fix things up per the RFC. Can optionally handle strings which are meant to encode a path (ie include '/'es which should NOT be escaped).

Parameters:

value - the value to encode

path - true if the value is intended to represent a path

Returns:

the encoded value

urlDecode

public static String urlDecode(String value)

Decode a string for use in the path of a URL; uses URLDecoder.decode, which decodes a string for use in the query portion of a URL.

Parameters:

value - The value to decode

Returns:

The decoded value if parameter is not null, otherwise, null is returned.

isUsingNonDefaultPort

public static boolean isUsingNonDefaultPort(URI uri)

Returns true if the specified URI is using a non-standard port (i.e. any port other than 80 for HTTP URIs or any port other than 443 for HTTPS URIs).

Parameters:

uri - the URI.

Returns:

True if the specified URI is using a non-standard port, otherwise false.

usePayloadForQueryParameters

public static boolean usePayloadForQueryParameters(Request<?> request)

Parameters:

request - the request.

Returns:

true if request is post and request has no payload.

encodeParameters

public static String encodeParameters(Request<?> request)

Creates an encoded query string from all the parameters in the specified request.

Parameters:

request - The request containing the parameters to encode.

Returns:

Null if no parameters were present, otherwise the encoded query string for the parameters present in the specified request.

appendUri

public static String appendUri(String baseUri,
                               String path)

Append the given path to the given baseUri. By default, all slash characters in path will not be url-encoded.

Parameters:

baseUri - the base URI.

path - the path.

Returns:

the appended URI.

appendUri

public static String appendUri(String baseUri,
                               String path,
                               boolean escapeDoubleSlash)

Append the given path to the given baseUri.

This method will encode the given path but not the given baseUri.

Parameters:

baseUri - The URI to append to (required, may be relative)

path - The path to append (may be null or empty)

escapeDoubleSlash - Whether double-slash in the path should be escaped to "/%2F"

Returns:

The baseUri with the (encoded) path appended

fetchFile

public static InputStream fetchFile(URI uri,
                                    ClientConfiguration config)
                             throws IOException

Fetches a file from the URI given and returns an input stream to it.

Parameters:

uri - the uri of the file to fetch

config - optional configuration overrides

Returns:

an InputStream containing the retrieved data

Throws:

IOException - on error