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, they should instead use Subject.check() to invoke other subjects using the current strategy. When you really do need to create your own strategy prefer to extend AbstractFailureStrategy rather than this class directly.

Implementation Note: the concrete methods in this class will be made abstract in the near future (see b/37472530); please do not depend on these existing implementations in new code, prefer AbstractFailureStrategy.

Constructor Summary

Constructors

Constructor and Description
FailureStrategy()

Method Summary

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

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

fail

public 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 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 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.