org.assertj.core.api

Class AbstractSoftAssertions

java.lang.Object

org.assertj.core.api.AbstractSoftAssertions

Direct Known Subclasses:

Java6AbstractBDDSoftAssertions, Java6AbstractStandardSoftAssertions

public class AbstractSoftAssertions
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
protected org.assertj.core.api.SoftProxies	proxies

Constructor Summary

Constructors

Constructor and Description
AbstractSoftAssertions()

Method Summary

Modifier and Type	Method and Description
protected List<Throwable>	decorateErrorsCollected(List<Throwable> errors) Modifies collected errors.
List<Throwable>	errorsCollected() Returns a copy of list of soft assertions collected errors.
void	fail(String failureMessage) Fails with the given message.
void	fail(String failureMessage, Object... args) Fails with the given message built like String.format(String, Object...).
void	fail(String failureMessage, Throwable realCause) Fails with the given message and with the Throwable that caused the failure.
void	failBecauseExceptionWasNotThrown(Class<? extends Throwable> throwableClass) Fails with a message explaining that a Throwable of given class was expected to be thrown but had not been.
<T,V> V	proxy(Class<V> assertClass, Class<T> actualClass, T actual)
void	shouldHaveThrown(Class<? extends Throwable> throwableClass) Fails with a message explaining that a Throwable of given class was expected to be thrown but had not been.
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

Field Detail

proxies

protected final org.assertj.core.api.SoftProxies proxies

Constructor Detail

AbstractSoftAssertions

public AbstractSoftAssertions()

Method Detail

proxy

public <T,V> V proxy(Class<V> assertClass,
                     Class<T> actualClass,
                     T actual)

fail

public void fail(String failureMessage)

Fails with the given message.

Parameters:

failureMessage - error message.

Since:

2.6.0 / 3.6.0

fail

public void fail(String failureMessage,
                 Object... args)

Fails with the given message built like String.format(String, Object...).

Parameters:

failureMessage - error message.

args - Arguments referenced by the format specifiers in the format string.

Since:

2.6.0 / 3.6.0

fail

public void fail(String failureMessage,
                 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(Class<? extends 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:

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(Class<? extends 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:

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 List<Throwable> errorsCollected()

Returns a copy of list of soft assertions collected errors.

Returns:

a copy of list of soft assertions collected errors.

decorateErrorsCollected

protected List<Throwable> decorateErrorsCollected(List<Throwable> errors)

Modifies collected errors. Override to customize modification.

Parameters:

errors - list of errors to decorate

Returns:

decorated list

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.