Class FDBException

All Implemented Interfaces:
CloneableException, Serializable

public class FDBException extends RuntimeException implements CloneableException
An Error from the native layers of FoundationDB. Each FDBException sets the message of the underlying Java Exception. FDB exceptions expose a number of functions including, for example, isRetryable() that evaluate predicates on the internal FDB error. Most clients should use those methods in order to implement special handling for certain errors if their application requires it.

Errors in FDB should generally be retried if they match the isRetryable() predicate. In addition, as with any distributed system, certain classes of errors may fail in such a way that it is unclear whether the transaction succeeded (they may be committed or not). To handle these cases, clients are generally advised to make their database operations idempotent and to place their operations within retry loops. The FDB Java API provides some default retry loops within the Database interface. See the discussion within the documentation of Database.runAsync() for more details.

See Also:
  • Constructor Details

    • FDBException

      public FDBException(String message, int code)
      A general constructor. Not for use by client code.
      Parameters:
      message - error message of this exception
      code - internal FDB error code of this exception
  • Method Details

    • getCode

      public int getCode()
      Gets the code for this error. A list of common errors codes are published elsewhere within our documentation.
      Returns:
      the internal FDB error code
    • isSuccess

      public boolean isSuccess()
      Determine if this FDBException represents a success code from the native layer.
      Returns:
      true if this error represents success, false otherwise
    • retargetClone

      public Exception retargetClone()
      Description copied from interface: CloneableException
      Create and return a new Exception that has a backtrace including the calling line of code.
      Specified by:
      retargetClone in interface CloneableException
      Returns:
      a newly created Exception.
    • isRetryable

      public boolean isRetryable()
      Returns true if the error indicates the operations in the transactions should be retried because of transient error.
      Returns:
      true if this FDBException is retryable
    • isMaybeCommitted

      public boolean isMaybeCommitted()
      Returns true if the error indicates the transaction may have succeeded, though not in a way the system can verify.
      Returns:
      true if this FDBException is maybe_committed
    • isRetryableNotCommitted

      public boolean isRetryableNotCommitted()
      Returns true if the error indicates the transaction has not committed, though in a way that can be retried.
      Returns:
      true if this FDBException is retryable_not_committed