Package com.mongodb

Class MongoException

    • Field Detail

      • 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:
        hasErrorLabel(String), Constant Field Values
      • 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:
        hasErrorLabel(String), Constant Field Values
    • Constructor Detail

      • 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,
                              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 Detail

      • 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)