alluxio.exception.status

Class AlluxioStatusException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

alluxio.exception.status.AlluxioStatusException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

AbortedException, AlreadyExistsException, CanceledException, DataLossException, DeadlineExceededException, FailedPreconditionException, InternalException, InvalidArgumentException, NotFoundException, OutOfRangeException, PermissionDeniedException, ResourceExhaustedException, UnauthenticatedException, UnavailableException, UnimplementedException, UnknownException

public class AlluxioStatusException
extends IOException

An exception thrown by Alluxio. getStatus() can be used to determine the represented class of error.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AlluxioStatusException(Status status, String message)
AlluxioStatusException(Status status, String message, Throwable cause)
AlluxioStatusException(Status status, Throwable cause)

Method Summary

Modifier and Type	Method and Description
static AlluxioStatusException	from(Status status, String m) Converts an Alluxio exception from status and message representation to native representation.
static AlluxioStatusException	fromAlluxioException(AlluxioException ae) Converts checked Alluxio exceptions to Alluxio status exceptions.
static AlluxioStatusException	fromCheckedException(Throwable throwable) Converts checked throwables to Alluxio status exceptions.
static AlluxioStatusException	fromIOException(IOException ioe) Converts an IOException to a corresponding status exception.
static AlluxioStatusException	fromThrift(AlluxioTException e) Converts an Alluxio exception from Thrift representation to native representation.
static AlluxioStatusException	fromThrowable(Throwable t) Converts an arbitrary throwable to an Alluxio status exception.
Status	getStatus()
AlluxioException	toAlluxioException()
AlluxioTException	toThrift()

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

AlluxioStatusException

public AlluxioStatusException(Status status,
                              String message)

Parameters:

status - the status code for this exception

message - the exception message

AlluxioStatusException

public AlluxioStatusException(Status status,
                              Throwable cause)

Parameters:

status - the status code for this exception

cause - the cause of the exception

AlluxioStatusException

public AlluxioStatusException(Status status,
                              String message,
                              Throwable cause)

Parameters:

status - the status code for this exception

message - the exception message

cause - the cause of the exception

Method Detail

getStatus

public Status getStatus()

Returns:

the status code for this exception

toThrift

public AlluxioTException toThrift()

Returns:

the Thrift representation of this exception

toAlluxioException

public AlluxioException toAlluxioException()

Returns:

a specific AlluxioException corresponding to this exception if there is one; otherwise return a generic AlluxioException

fromThrift

public static AlluxioStatusException fromThrift(AlluxioTException e)

Converts an Alluxio exception from Thrift representation to native representation.

Parameters:

e - the Thrift exception

Returns:

the native Alluxio exception

from

public static AlluxioStatusException from(Status status,
                                          String m)

Converts an Alluxio exception from status and message representation to native representation. The status must not be null or Status.OK.

Parameters:

status - the status

m - the message

Returns:

an AlluxioStatusException for the given status and message

fromCheckedException

public static AlluxioStatusException fromCheckedException(Throwable throwable)

Converts checked throwables to Alluxio status exceptions. Unchecked throwables should not be passed to this method. Use Throwables.propagateIfPossible before passing a Throwable to this method.

Parameters:

throwable - a throwable

Returns:

the converted AlluxioStatusException

fromThrowable

public static AlluxioStatusException fromThrowable(Throwable t)

Converts an arbitrary throwable to an Alluxio status exception. This method should be used with caution because it could potentially convert an unchecked exception (indicating a bug) to a checked Alluxio status exception.

Parameters:

t - a throwable

Returns:

the converted AlluxioStatusException

fromAlluxioException

public static AlluxioStatusException fromAlluxioException(AlluxioException ae)

Converts checked Alluxio exceptions to Alluxio status exceptions.

Parameters:

ae - the Alluxio exception to convert

Returns:

the converted AlluxioStatusException

fromIOException

public static AlluxioStatusException fromIOException(IOException ioe)

Converts an IOException to a corresponding status exception. Unless special cased, IOExceptions are converted to UnavailableException.

Parameters:

ioe - the IO exception to convert

Returns:

the corresponding status exception