Class ChecksumFailureException

  • All Implemented Interfaces:
    java.io.Serializable

    public class ChecksumFailureException
    extends RepositoryException
    Thrown in case of a checksum failure during an artifact/metadata download.
    See Also:
    Serialized Form
    • Field Summary

      Fields 
      Modifier and Type Field Description
      private java.lang.String actual  
      private java.lang.String expected  
      private boolean retryWorthy  
    • Constructor Summary

      Constructors 
      Constructor Description
      ChecksumFailureException​(boolean retryWorthy, java.lang.String message, java.lang.Throwable cause)
      Creates a new exception with the specified retry flag, detail message and cause.
      ChecksumFailureException​(java.lang.String message)
      Creates a new exception with the specified detail message.
      ChecksumFailureException​(java.lang.String expected, java.lang.String actual)
      Creates a new exception with the specified expected and actual checksum.
      ChecksumFailureException​(java.lang.String message, java.lang.Throwable cause)
      Creates a new exception with the specified detail message and cause.
      ChecksumFailureException​(java.lang.Throwable cause)
      Creates a new exception with the specified cause.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.String getActual()
      Gets the actual checksum for the downloaded artifact/metadata.
      java.lang.String getExpected()
      Gets the expected checksum for the downloaded artifact/metadata.
      boolean isRetryWorthy()
      Indicates whether the corresponding download is retry-worthy.
      • 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
    • Field Detail

      • expected

        private final java.lang.String expected
      • actual

        private final java.lang.String actual
      • retryWorthy

        private final boolean retryWorthy
    • Constructor Detail

      • ChecksumFailureException

        public ChecksumFailureException​(java.lang.String expected,
                                        java.lang.String actual)
        Creates a new exception with the specified expected and actual checksum. The resulting exception is retry-worthy.
        Parameters:
        expected - The expected checksum as declared by the hosting repository, may be null.
        actual - The actual checksum as computed from the local bytes, may be null.
      • ChecksumFailureException

        public ChecksumFailureException​(java.lang.String message)
        Creates a new exception with the specified detail message. The resulting exception is not retry-worthy.
        Parameters:
        message - The detail message, may be null.
      • ChecksumFailureException

        public ChecksumFailureException​(java.lang.Throwable cause)
        Creates a new exception with the specified cause. The resulting exception is not retry-worthy.
        Parameters:
        cause - The exception that caused this one, may be null.
      • ChecksumFailureException

        public ChecksumFailureException​(java.lang.String message,
                                        java.lang.Throwable cause)
        Creates a new exception with the specified detail message and cause. The resulting exception is not retry-worthy.
        Parameters:
        message - The detail message, may be null.
        cause - The exception that caused this one, may be null.
      • ChecksumFailureException

        public ChecksumFailureException​(boolean retryWorthy,
                                        java.lang.String message,
                                        java.lang.Throwable cause)
        Creates a new exception with the specified retry flag, detail message and cause.
        Parameters:
        retryWorthy - true if the exception is retry-worthy, false otherwise.
        message - The detail message, may be null.
        cause - The exception that caused this one, may be null.
    • Method Detail

      • getExpected

        public java.lang.String getExpected()
        Gets the expected checksum for the downloaded artifact/metadata.
        Returns:
        The expected checksum as declared by the hosting repository or null if unknown.
      • getActual

        public java.lang.String getActual()
        Gets the actual checksum for the downloaded artifact/metadata.
        Returns:
        The actual checksum as computed from the local bytes or null if unknown.
      • isRetryWorthy

        public boolean isRetryWorthy()
        Indicates whether the corresponding download is retry-worthy.
        Returns:
        true if retrying the download might solve the checksum failure, false if the checksum failure is non-recoverable.