com.scaleoutsoftware.soss.client.da

Class StateServerException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.scaleoutsoftware.soss.client.da.StateServerException

All Implemented Interfaces:

ReWrappableException<StateServerException>, java.io.Serializable

Direct Known Subclasses:

NotLicensedException, ObjectExistsException, ObjectLockedException, ObjectNotFoundException, ReadThroughPendingException, RemoteStoreConfigurationException, ServiceUnavailableException, StateServerChannelException

public class StateServerException
extends java.lang.Exception
implements ReWrappableException<StateServerException>

An exception thrown when an unexpected error occurs while performing a StateServer operation.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
StateServerException(StatusCodes statusCode) creates a state server exception
StateServerException(StatusCodes statusCode, java.lang.String message) Creates a state server exception.
StateServerException(StatusCodes statusCode, java.lang.String message, java.lang.Throwable cause) Creates a state server exception with an original exception
StateServerException(StatusCodes statusCode, java.lang.Throwable cause) Creates a state server exception

Method Summary

Modifier and Type	Method and Description
protected int	getCreatedOnThread()
StatusCodes	getStatusCode()
StateServerException	reWrap(StateServerException e) Rewrap existing an StateServerException with a new one if the thread the initial exception was generated on is different from the current thread.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, 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

StateServerException

public StateServerException(StatusCodes statusCode)

creates a state server exception

Parameters:

statusCode - the status code returned from the server

StateServerException

public StateServerException(StatusCodes statusCode,
                            java.lang.String message)

Creates a state server exception.

Parameters:

statusCode - the status code returned from the server.

message - the string message to display

StateServerException

public StateServerException(StatusCodes statusCode,
                            java.lang.Throwable cause)

Creates a state server exception

Parameters:

statusCode - the status code returned from the server

cause - the original exception

StateServerException

public StateServerException(StatusCodes statusCode,
                            java.lang.String message,
                            java.lang.Throwable cause)

Creates a state server exception with an original exception

Parameters:

statusCode - the status code returned from the server

message - the message to display

cause - the original exception

Method Detail

getStatusCode

public StatusCodes getStatusCode()

getCreatedOnThread

protected int getCreatedOnThread()

reWrap

public StateServerException reWrap(StateServerException e)

Rewrap existing an StateServerException with a new one if the thread the initial exception was generated on is different from the current thread.

The exception stack trace stops at the initial method of the current thread. If this exception came from a different thread, we won't see the call stack that initiated the request. So, we rethrow the same exception with the same message and status, nesting the original exception within so that we can see a full stack trace.

Specified by:

reWrap in interface ReWrappableException<StateServerException>

Parameters:

e - the original StateServerException

Returns:

if we're still on the same thread that e was generated on, e. Otherwise a new StateServerException that wraps e.