Package org.assertj.core.api

Class AbstractSoftAssertions

    • Constructor Detail

      • AbstractSoftAssertions

        protected AbstractSoftAssertions()

    • Method Detail

      • proxy

        public <SELF extends Assert<? extends SELF,​? extends ACTUAL>,​ACTUAL> SELF proxy​(java.lang.Class<SELF> assertClass,
                                                                                            java.lang.Class<ACTUAL> actualClass,
                                                                                            ACTUAL actual)
        Description copied from interface: SoftAssertionsProvider
        Creates a proxied assertion class of the given type. The returned value is an assertion object compatible with the supplied assertion class, but instead of throwing errors it will collect them and store.
        Specified by:
        proxy in interface SoftAssertionsProvider
        Type Parameters:
        SELF - The type of the assertion class
        ACTUAL - The type of the object-under-test
        Parameters:
        assertClass - Class instance for the assertion type.
        actualClass - Class instance for the type of the object-under-test.
        actual - The actual object-under-test.
        Returns:
        A proxied assertion class for the given object-under-test.

      • fail

        @Contract("_ -> fail")
public <T> T fail​(java.lang.String failureMessage)
        Fails with the given message.
        Type Parameters:
        T - dummy return value type
        Parameters:
        failureMessage - error message.
        Returns:
        nothing, it's just to be used in doSomething(optional.orElseGet(() -> softly.fail("boom")));.
        Since:
        2.6.0 / 3.6.0

      • fail

        @Contract(" -> fail")
public <T> T fail()
        Fails with an empty message to be used in code like: 
         doSomething(optional.orElseGet(() -> softly.fail()));
        Type Parameters:
        T - dummy return value type
        Returns:
        nothing, it's just to be used in doSomething(optional.orElseGet(() -> softly.fail()));.
        Since:
        3.26.0

      • fail

        @Contract("_, _ -> fail")
public <T> T fail​(java.lang.String failureMessage,
                  java.lang.Object... args)
        Fails with the given message built like String.format(String, Object...).
        Type Parameters:
        T - dummy return value type
        Parameters:
        failureMessage - error message.
        args - Arguments referenced by the format specifiers in the format string.
        Returns:
        nothing, it's just to be used in doSomething(optional.orElseGet(() -> softly.fail("boom")));.
        Since:
        2.6.0 / 3.6.0

      • fail

        @Contract("_, _ -> fail")
public <T> T fail​(java.lang.String failureMessage,
                  java.lang.Throwable realCause)
        Fails with the given message and with the Throwable that caused the failure.
        Type Parameters:
        T - dummy return value type
        Parameters:
        failureMessage - error message.
        realCause - cause of the error.
        Returns:
        nothing, it's just to be used in doSomething(optional.orElseGet(() -> softly.fail("boom")));.
        Since:
        2.6.0 / 3.6.0

      • fail

        @Contract("_ -> fail")
public <T> T fail​(java.lang.Throwable realCause)
        Fails with the Throwable that caused the failure and an empty message.

        Example: 

         doSomething(optional.orElseGet(() -> softly.fail(cause)));
        Type Parameters:
        T - dummy return value type
        Parameters:
        realCause - cause of the error.
        Returns:
        nothing, it's just to be used in doSomething(optional.orElseGet(() -> softly.fail(cause)));.
        Since:
        3.26.0

      • failBecauseExceptionWasNotThrown

        @Contract("_ -> fail")
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
        See Also:
        shouldHaveThrown(Class)

      • shouldHaveThrown

        @Contract("_ -> fail")
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.