com.cybersource.ws.client

Class ClientException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.cybersource.ws.client.ClientException

All Implemented Interfaces:

Serializable

public class ClientException
extends Exception

Used by both Basic and XML clients. All exceptions other than faults are wrapped in ClientException.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ClientException(Exception _innerException, boolean _critical, Logger logger)
ClientException(Exception _innerException, Logger logger)
ClientException(int _httpStatusCode, Logger logger)
ClientException(int _httpStatusCode, String _httpError, boolean _critical, Logger logger)
ClientException(int _httpStatusCode, String _httpError, Logger logger)

Method Summary

Modifier and Type	Method and Description
String	getHttpError() Returns additional HTTP error information, if any.
int	getHttpStatusCode() Returns the HTTP status code, if any.
Exception	getInnerException() Returns the actual exception that occurred, if any.
String	getMessage() Returns a description of the exception.
boolean	isCritical() Returns whether or not this exception is critical.

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

ClientException

public ClientException(Exception _innerException,
                       Logger logger)

Parameters:

_innerException - the actual exception that occurred.

logger - used to log the exception details.

ClientException

public ClientException(Exception _innerException,
                       boolean _critical,
                       Logger logger)

Parameters:

_innerException - the actual exception that occurred.

_critical - flag that tells whether or not the exception occurred at a critical point in the transaction.

logger - used to log the exception details.

ClientException

public ClientException(int _httpStatusCode,
                       Logger logger)

Parameters:

_httpStatusCode - HTTP status code

logger - used to log the exception details.

ClientException

public ClientException(int _httpStatusCode,
                       String _httpError,
                       Logger logger)

Parameters:

_httpStatusCode - HTTP status code

_httpError - Additional HTTP error information; may be null.

logger - used to log the exception details.

ClientException

public ClientException(int _httpStatusCode,
                       String _httpError,
                       boolean _critical,
                       Logger logger)

Parameters:

_httpStatusCode - HTTP status code

_httpError - Additional HTTP error information; may be null.

_critical - flag that tells whether or not the exception occurred at a critical point in the transaction.

logger - used to log the exception details.

Method Detail

getInnerException

public Exception getInnerException()

Returns the actual exception that occurred, if any.

Returns:

the actual exception that occurred or null if this object was constructed using an HTTP status code.

isCritical

public boolean isCritical()

Returns whether or not this exception is critical. It will return true in the following cases:

• An exception occurred while parsing the reply or fault.
• An HTTP status code of HttpURLConnection.HTTP_GATEWAY_TIMEOUT was returned.

Returns:

whether or not this exception is critical.

getHttpStatusCode

public int getHttpStatusCode()

Returns the HTTP status code, if any.

Returns:

the HTTP status code or -1 if this object was constructed using an actual exception that occurred.

getHttpError

public String getHttpError()

Returns additional HTTP error information, if any.

Returns:

additional HTTP error information or null if this object was constructed using an actual exception that occurred.

getMessage

public String getMessage()

Returns a description of the exception.

Overrides:

getMessage in class Throwable

Returns:

a description of the exception.