com.ibm.cloud.objectstorage.transform

Class StandardErrorUnmarshaller

java.lang.Object

com.ibm.cloud.objectstorage.transform.AbstractErrorUnmarshaller<Node>

com.ibm.cloud.objectstorage.transform.StandardErrorUnmarshaller

All Implemented Interfaces:

Unmarshaller<AmazonServiceException,Node>

public class StandardErrorUnmarshaller
extends AbstractErrorUnmarshaller<Node>

Error unmarshaller that knows how to interpret a standard AWS error message (i.e. where to find the AWS error code, the error message, etc.) and turn it into an AmazonServiceException.

See Also:

LegacyErrorUnmarshaller

Field Summary

Fields inherited from class com.ibm.cloud.objectstorage.transform.AbstractErrorUnmarshaller

exceptionClass

Constructor Summary

Constructors

Constructor and Description
StandardErrorUnmarshaller() Constructs a new unmarshaller that will unmarshall a standard AWS error message as a generic AmazonServiceException object.
StandardErrorUnmarshaller(Class<? extends AmazonServiceException> exceptionClass) Constructor allowing subclasses to specify a specific type of AmazonServiceException to instantiating when populating the exception object with data from the error message.

Method Summary

Modifier and Type	Method and Description
String	getErrorPropertyPath(String property) Returns the path to the specified property within an error response.
String	parseErrorCode(Node in) Returns the AWS error code for the specified error response.
String	parseErrorCode(Node in, XPath xpath)
AmazonServiceException	unmarshall(Node in)

Methods inherited from class com.ibm.cloud.objectstorage.transform.AbstractErrorUnmarshaller

newException

Methods inherited from class java.lang.Object

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

Constructor Detail

StandardErrorUnmarshaller

public StandardErrorUnmarshaller()

Constructs a new unmarshaller that will unmarshall a standard AWS error message as a generic AmazonServiceException object.

StandardErrorUnmarshaller

public StandardErrorUnmarshaller(Class<? extends AmazonServiceException> exceptionClass)

Constructor allowing subclasses to specify a specific type of AmazonServiceException to instantiating when populating the exception object with data from the error message.

Parameters:

exceptionClass - The class of AmazonServiceException to create and populate when unmarshalling the error message.

Method Detail

unmarshall

public AmazonServiceException unmarshall(Node in)
                                  throws Exception

Throws:

Exception

See Also:

Unmarshaller.unmarshall(java.lang.Object)

parseErrorCode

public String parseErrorCode(Node in)
                      throws Exception

Returns the AWS error code for the specified error response.

Parameters:

in - The DOM tree node containing the error response.

Returns:

The AWS error code contained in the specified error response.

Throws:

Exception - If any problems were encountered pulling out the AWS error code.

parseErrorCode

public String parseErrorCode(Node in,
                             XPath xpath)
                      throws Exception

Throws:

Exception

getErrorPropertyPath

public String getErrorPropertyPath(String property)

Returns the path to the specified property within an error response.

Parameters:

property - The name of the desired property.

Returns:

The path to the specified property within an error message.