com.amazonservices.mws.client

Class MwsException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.amazonservices.mws.client.MwsException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

MarketplaceWebServiceOrdersException

public class MwsException
extends RuntimeException

Exception thrown by MWS API requests.

Author:

mayerj

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	MwsException.XmlMwsException Used to read MWSException from XML since MWSException cannot extend AbstractMwsObject.

Constructor Summary

Constructors

Constructor and Description
MwsException(int statusCode, String message, String errorCode, String errorType, String xml, MwsResponseHeaderMetadata rhmd) Initializes MwsException with information available from service.
MwsException(int statusCode, String message, Throwable cause) Initialize and set cause from another exception.
MwsException(Throwable cause) Create wrap around another MwsException.

Method Summary

Methods

Modifier and Type	Method and Description
String	getDetail() The error detail information.
String	getErrorCode() Gets error code returned by the service if available.
String	getErrorType() Gets error type returned by the service if available.
String	getMessage()
String	getRequestId() Get the request id from the response header metadata.
MwsResponseHeaderMetadata	getResponseHeaderMetadata() Get the response header metadata.
int	getStatusCode() Gets status code returned by the service if available.
String	getTimestamp() Get the timestamp from the response header metadata.
String	getXML() Gets XML returned by the service if available.
protected void	setResponseHeaderMetadata(MwsResponseHeaderMetadata rhmd) Set the response header metadata.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

MwsException

public MwsException(int statusCode,
            String message,
            String errorCode,
            String errorType,
            String xml,
            MwsResponseHeaderMetadata rhmd)

Initializes MwsException with information available from service.

Parameters:

statusCode - HTTP status code for error response.

message - Error message from HTTP header.

errorCode - Error code from response XML.

errorType - Error type from response XML.

xml - Compete XML found in response.

rhmd - The response header metadata.

MwsException

public MwsException(int statusCode,
            String message,
            Throwable cause)

Initialize and set cause from another exception.

If cause is an MwsException copies that exception's attributes to this one, ignoring the statusCode and message parameters that were passed in.

Parameters:

statusCode -

message -

cause -

MwsException

public MwsException(Throwable cause)

Create wrap around another MwsException.

Parameters:

cause - Exception to wrap

Method Detail

setResponseHeaderMetadata

protected void setResponseHeaderMetadata(MwsResponseHeaderMetadata rhmd)

Set the response header metadata.

Parameters:

rhmd -

getDetail

public String getDetail()

The error detail information.

Returns:

The debugging detail information.

getErrorCode

public String getErrorCode()

Gets error code returned by the service if available.

Returns:

Error Code returned by the service

getErrorType

public String getErrorType()

Gets error type returned by the service if available.

Returns:

Error Type returned by the service

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

getRequestId

public String getRequestId()

Get the request id from the response header metadata.

Returns:

The request id.

getResponseHeaderMetadata

public MwsResponseHeaderMetadata getResponseHeaderMetadata()

Get the response header metadata.

Returns:

The response header metadata.

getStatusCode

public int getStatusCode()

Gets status code returned by the service if available. If status code is set to -1, it means that status code was unavailable at the time exception was thrown

Returns:

status code returned by the service

getTimestamp

public String getTimestamp()

Get the timestamp from the response header metadata.

Returns:

The timestamp.

getXML

public String getXML()

Gets XML returned by the service if available.

Returns:

XML returned by the service