alluxio.exception.runtime

Class FailedPreconditionRuntimeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

alluxio.exception.runtime.AlluxioRuntimeException

alluxio.exception.runtime.FailedPreconditionRuntimeException

All Implemented Interfaces:

Serializable

public class FailedPreconditionRuntimeException
extends AlluxioRuntimeException

Exception indicating that operation was rejected because the system is not in a state required for the operation's execution. For example, directory to be deleted may be non-empty, an rmdir operation is applied to a non-directory, etc. A litmus test that may help a service implementor in deciding between FailedPrecondition, Aborted, and Unavailable:

   (a) Use Unavailable if the client can retry just the failing call.
   (b) Use Aborted if the client should retry at a higher-level (e.g., restarting a
       read-modify-write sequence).
   (c) Use FailedPrecondition if the client should not retry until the system state has
       been explicitly fixed. E.g., if an "rmdir" fails because the directory is non-empty,
       FailedPrecondition should be thrown since the client should not retry unless they
       have first fixed up the directory by deleting files from it.
   (d) Use FailedPrecondition if the client performs conditional REST Get/Update/Delete
       on a resource and the resource on the server does not match the condition. E.g.,
       conflicting read-modify-write on the same resource.
 

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
FailedPreconditionRuntimeException(String message) Constructor.
FailedPreconditionRuntimeException(String message, Throwable t) Constructor.
FailedPreconditionRuntimeException(Throwable t) Constructor.

Method Summary

Methods inherited from class alluxio.exception.runtime.AlluxioRuntimeException

from, from, from, from, getMessage, getStatus, isRetryable, toGrpcStatusException, toGrpcStatusRuntimeException

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

FailedPreconditionRuntimeException

public FailedPreconditionRuntimeException(Throwable t)

Constructor.

Parameters:

t - cause

FailedPreconditionRuntimeException

public FailedPreconditionRuntimeException(String message)

Constructor.

Parameters:

message - error message

FailedPreconditionRuntimeException

public FailedPreconditionRuntimeException(String message,
                                          Throwable t)

Constructor.

Parameters:

message - error message

t - cause