com.google.common.truth

Class FailureStrategy

java.lang.Object

com.google.common.truth.FailureStrategy

Direct Known Subclasses:

AbstractFailureStrategy, AbstractVerb.MessagePrependingFailureStrategy

public abstract class FailureStrategy
extends Object

A FailureStrategy defines how assertion failures are handled. In Truth, failures throw AssertionErrors; other assertion entry-points like Expect and TruthJUnit.assume() have different failure behavior.

It should generally be unnecessary for Truth SPI developers to define their own FailureStrategy implementations. When you really do need to create your own strategy prefer to extend AbstractFailureStrategy rather than this class directly.

Alternatives to creating a custom FailureStrategy implementation:

• For unit tests of a custom subject and assert on the failure behavior use ExpectFailure
• To create subjects of other types within your own subject (e.g. for chained assertions) use Subject.check()
• To return a no-op subject after a previous assertion has failed (e.g. for chained assertions) use Subject.ignoreCheck()

Constructor Summary

Constructors

Constructor and Description
FailureStrategy()

Method Summary

Modifier and Type	Method and Description
abstract void	fail(String message) Report an assertion failure with a text message.
abstract void	fail(String message, Throwable cause) Report an assertion failure with a text message and a throwable that indicates the cause of the failure.
abstract void	failComparing(String message, CharSequence expected, CharSequence actual) Convenience method to report string-comparison failures with more detail (e.g.
abstract void	failComparing(String message, CharSequence expected, CharSequence actual, Throwable cause) Convenience method to report string-comparison failures with more detail (e.g.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FailureStrategy

public FailureStrategy()

Method Detail

fail

public abstract void fail(String message)

Report an assertion failure with a text message. This method should generally delegate to fail(String, Throwable).

fail

public abstract void fail(String message,
                          Throwable cause)

Report an assertion failure with a text message and a throwable that indicates the cause of the failure. This will be reported as the cause of the exception raised by this method (if one is thrown) or otherwise recorded by the strategy as the underlying cause of the failure.

failComparing

public abstract void failComparing(String message,
                                   CharSequence expected,
                                   CharSequence actual)

Convenience method to report string-comparison failures with more detail (e.g. character differences). This method should generally delegate to failComparing(String, CharSequence, CharSequence, Throwable).

failComparing

public abstract void failComparing(String message,
                                   CharSequence expected,
                                   CharSequence actual,
                                   Throwable cause)

Convenience method to report string-comparison failures with more detail (e.g. character differences), along with a throwable that indicates the cause of the failure. This will be reported as the cause of the exception raised by this method (if one is thrown) or otherwise recorded by the strategy as the underlying cause of the failure.