com.amazonservices.mws.client

Class MwsUtl

java.lang.Object

com.amazonservices.mws.client.MwsUtl

public class MwsUtl
extends Object

Static utility functions used by MWS client classes.

Author:

mayerj

Method Summary

Methods

Modifier and Type	Method and Description
static void	close(Closeable a) Close a Closeable if it is not null.
static String	escapeAppName(String s) Escape application name before using to form user agent string.
static String	escapeAppVersion(String s) Escape an application version string.
static String	escapeAttributeName(String s) Standardize and escape an attribute name.
static String	escapeAttributeValue(String s) Standardize and escape an attribute value.
static DatatypeFactory	getDTF() Get a thread local DatatypeFactory.
static TransformerFactory	getTF() Get a thread local transformer factory.
protected static String	urlEncode(String value, boolean path) URL encode a value.
static RuntimeException	wrap(Throwable e) Wrap Checked exceptions in runtime exception.

Methods inherited from class java.lang.Object

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

Method Detail

urlEncode

protected static String urlEncode(String value,
               boolean path)

URL encode a value.

Parameters:

value -

path - true if is a path and '/' should not be encoded.

Returns:

The encoded string.

close

public static void close(Closeable a)

Close a Closeable if it is not null.

Parameters:

a - The Closeable or null.

escapeAppName

public static String escapeAppName(String s)

Escape application name before using to form user agent string.

Clean up white space and then escape back slash and forward slash characters.

Parameters:

s -

Returns:

The escaped app name.

escapeAppVersion

public static String escapeAppVersion(String s)

Escape an application version string.

Parameters:

s -

Returns:

The escaped app version.

escapeAttributeName

public static String escapeAttributeName(String s)

Standardize and escape an attribute name.

Clean white space. Escape back-slashes and equals-sign with a back-slash.

Parameters:

s - The attribute name to standardize and escape.

Returns:

The standardized and escaped attribute name.

escapeAttributeValue

public static String escapeAttributeValue(String s)

Standardize and escape an attribute value.

Clean white space. Escape back-slashes, semi-colons, and right parenthesis with a back-slash.

Parameters:

s - The attribute value to standardize and escape.

Returns:

The standardized and escaped attribute value.

getDTF

public static DatatypeFactory getDTF()

Get a thread local DatatypeFactory.

DatatypeFactory is NOT required to be thread safe. This method uses a thread local to create one per calling thread.

Returns:

A thread local DatatypeFactory.

getTF

public static TransformerFactory getTF()

Get a thread local transformer factory.

Returns:

The factory.

wrap

public static RuntimeException wrap(Throwable e)

Wrap Checked exceptions in runtime exception.

Parameters:

e -

Returns:

e, wrapped in a runtime exception if necessary.