Class AbstractSoftAssertions

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      private void addLineNumberToErrorMessage​(java.lang.Throwable error)  
      private java.util.List<java.lang.Throwable> addLineNumberToErrorMessages​(java.util.List<java.lang.Throwable> errors)  
      private java.lang.String buildErrorMessageWithLineNumber​(java.lang.String originalErrorMessage, java.lang.StackTraceElement testStackTraceElement)  
      private void changeErrorMessage​(java.lang.Throwable error, java.lang.String errorMessageWithLineNumber)  
      java.util.List<java.lang.Throwable> errorsCollected()
      Returns a copy of list of soft assertions collected errors.
      void fail​(java.lang.String failureMessage)
      Fails with the given message.
      void fail​(java.lang.String failureMessage, java.lang.Object... args)
      Fails with the given message built like String.format(String, Object...).
      void fail​(java.lang.String failureMessage, java.lang.Throwable realCause)
      Fails with the given message and with the Throwable that caused the failure.
      void failBecauseExceptionWasNotThrown​(java.lang.Class<? extends java.lang.Throwable> throwableClass)
      Fails with a message explaining that a Throwable of given class was expected to be thrown but had not been.
      private java.lang.StackTraceElement getFirstStackTraceElementFromTest​(java.lang.StackTraceElement[] stacktrace)  
      <T,​V>
      V
      proxy​(java.lang.Class<V> assertClass, java.lang.Class<T> actualClass, T actual)  
      void shouldHaveThrown​(java.lang.Class<? extends java.lang.Throwable> throwableClass)
      Fails with a message explaining that a Throwable of given class was expected to be thrown but had not been.
      private java.lang.String simpleClassNameOf​(java.lang.StackTraceElement testStackTraceElement)  
      boolean wasSuccess()
      Returns the result of last soft assertion which can be used to decide what the next one should be.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • AbstractSoftAssertions

        public AbstractSoftAssertions()
    • Method Detail

      • proxy

        public <T,​V> V proxy​(java.lang.Class<V> assertClass,
                                   java.lang.Class<T> actualClass,
                                   T actual)
      • fail

        public void fail​(java.lang.String failureMessage)
        Fails with the given message.
        Parameters:
        failureMessage - error message.
        Since:
        2.6.0 / 3.6.0
      • fail

        public void fail​(java.lang.String failureMessage,
                         java.lang.Object... args)
        Fails with the given message built like String.format(String, Object...).
        Parameters:
        failureMessage - error message.
        Since:
        2.6.0 / 3.6.0
      • fail

        public void fail​(java.lang.String failureMessage,
                         java.lang.Throwable realCause)
        Fails with the given message and with the Throwable that caused the failure.
        Parameters:
        failureMessage - error message.
        realCause - cause of the error.
        Since:
        2.6.0 / 3.6.0
      • failBecauseExceptionWasNotThrown

        public void failBecauseExceptionWasNotThrown​(java.lang.Class<? extends java.lang.Throwable> throwableClass)
        Fails with a message explaining that a Throwable of given class was expected to be thrown but had not been.
        Parameters:
        throwableClass - the Throwable class that was expected to be thrown.
        Throws:
        java.lang.AssertionError - with a message explaining that a Throwable of given class was expected to be thrown but had not been.
        Since:
        2.6.0 / 3.6.0 Fail.shouldHaveThrown(Class) can be used as a replacement.
      • shouldHaveThrown

        public void shouldHaveThrown​(java.lang.Class<? extends java.lang.Throwable> throwableClass)
        Fails with a message explaining that a Throwable of given class was expected to be thrown but had not been.
        Parameters:
        throwableClass - the Throwable class that was expected to be thrown.
        Throws:
        java.lang.AssertionError - with a message explaining that a Throwable of given class was expected to be thrown but had not been.
        Since:
        2.6.0 / 3.6.0
      • errorsCollected

        public java.util.List<java.lang.Throwable> errorsCollected()
        Returns a copy of list of soft assertions collected errors.
        Returns:
        a copy of list of soft assertions collected errors.
      • wasSuccess

        public boolean wasSuccess()
        Returns the result of last soft assertion which can be used to decide what the next one should be.

        Example :

         Person person = ...
         SoftAssertions soft = new SoftAssertions();
         if (soft.assertThat(person.getAddress()).isNotNull().wasSuccess()) {
             soft.assertThat(person.getAddress().getStreet()).isNotNull();
         }
        Returns:
        true if the last assertion was a success.
      • addLineNumberToErrorMessages

        private java.util.List<java.lang.Throwable> addLineNumberToErrorMessages​(java.util.List<java.lang.Throwable> errors)
      • addLineNumberToErrorMessage

        private void addLineNumberToErrorMessage​(java.lang.Throwable error)
      • buildErrorMessageWithLineNumber

        private java.lang.String buildErrorMessageWithLineNumber​(java.lang.String originalErrorMessage,
                                                                 java.lang.StackTraceElement testStackTraceElement)
      • changeErrorMessage

        private void changeErrorMessage​(java.lang.Throwable error,
                                        java.lang.String errorMessageWithLineNumber)
      • simpleClassNameOf

        private java.lang.String simpleClassNameOf​(java.lang.StackTraceElement testStackTraceElement)
      • getFirstStackTraceElementFromTest

        private java.lang.StackTraceElement getFirstStackTraceElementFromTest​(java.lang.StackTraceElement[] stacktrace)