Package com.mongodb

Class MongoException

All Implemented Interfaces:
Serializable
Direct Known Subclasses:
MongoChangeStreamException, MongoClientException, MongoExecutionTimeoutException, MongoGridFSException, MongoIncompatibleDriverException, MongoInternalException, MongoInterruptedException, MongoServerException, MongoSocketException

public class MongoException extends RuntimeException
Top level Exception for all Exceptions, server-side or client-side, that come from the driver.
  • Field Details

    • TRANSIENT_TRANSACTION_ERROR_LABEL

      public static final String TRANSIENT_TRANSACTION_ERROR_LABEL
      An error label indicating that the exception can be treated as a transient transaction error.
      Since:
      3.8
      See Also:
    • UNKNOWN_TRANSACTION_COMMIT_RESULT_LABEL

      public static final String UNKNOWN_TRANSACTION_COMMIT_RESULT_LABEL
      An error label indicating that the exception can be treated as an unknown transaction commit result.
      Since:
      3.8
      See Also:
  • Constructor Details

    • MongoException

      public MongoException(String msg)
      Parameters:
      msg - the message
    • MongoException

      public MongoException(int code, String msg)
      Parameters:
      code - the error code
      msg - the message
    • MongoException

      public MongoException(@Nullable String msg, @Nullable Throwable t)
      Parameters:
      msg - the message
      t - the throwable cause
    • MongoException

      public MongoException(int code, String msg, Throwable t)
      Parameters:
      code - the error code
      msg - the message
      t - the throwable cause
    • MongoException

      public MongoException(int code, String msg, BsonDocument response)
      Parameters:
      code - the error code
      msg - the message
      response - the response
      Since:
      4.1
  • Method Details

    • fromThrowable

      @Nullable public static MongoException fromThrowable(@Nullable Throwable t)
      Static helper to create or cast a MongoException from a throwable
      Parameters:
      t - a throwable, which may be null
      Returns:
      a MongoException
    • fromThrowableNonNull

      public static MongoException fromThrowableNonNull(Throwable t)
      Static helper to create or cast a MongoException from a throwable
      Parameters:
      t - a throwable, which may not be null
      Returns:
      a MongoException
      Since:
      3.7
    • getCode

      public int getCode()
      Gets the exception code
      Returns:
      the error code.
    • addLabel

      public void addLabel(String errorLabel)
      Adds the given error label to the exception.
      Parameters:
      errorLabel - the non-null error label to add to the exception
      Since:
      3.8
    • removeLabel

      public void removeLabel(String errorLabel)
      Removes the given error label from the exception.
      Parameters:
      errorLabel - the non-null error label to remove from the exception
      Since:
      3.8
    • getErrorLabels

      public Set<String> getErrorLabels()
      Gets the set of error labels associated with this exception.
      Returns:
      the error labels, which may not be null but may be empty
      Since:
      3.8
    • hasErrorLabel

      public boolean hasErrorLabel(String errorLabel)
      Return true if the exception is labelled with the given error label, and false otherwise.
      Parameters:
      errorLabel - the non-null error label
      Returns:
      true if the exception is labelled with the given error label
      Since:
      3.8
    • addLabels

      protected void addLabels(BsonArray labels)
      Add labels.
      Parameters:
      labels - the labels
    • addLabels

      protected void addLabels(Collection<String> labels)
      Add labels.
      Parameters:
      labels - the labels