com.google.common.truth

Class AbstractVerb<T extends AbstractVerb<T>>

java.lang.Object

com.google.common.truth.FailureContext

com.google.common.truth.AbstractVerb<T>

Direct Known Subclasses:

TestVerb

Deprecated.

Instead of subclassing AbstractVerb, subclass CustomSubjectBuilder. CustomSubjectBuilder is the new way of defining custom that() methods, and it doesn't require you to write boilerplate to store and propagate the failure message.

@Deprecated
public abstract class AbstractVerb<T extends AbstractVerb<T>>
extends FailureContext

A parent type for some infrastructure used in the Verb.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractVerb.DelegatedVerb<S extends Subject<S,T>,T> Deprecated. This class is being renamed to SimpleSubjectBuilder.
protected static class	AbstractVerb.MessagePrependingFailureStrategy Deprecated. To prepend a message, use StandardSubjectBuilder.withMessage(java.lang.String). If you are using MessagePrependingFailureStrategy to store and propagate the failure message as part of subclassing AbstractVerb or TestVerb, you will no longer need it when you migrate off those classes, as described in their deprecation text.

Constructor Summary

Constructors

Constructor and Description
AbstractVerb(FailureStrategy failureStrategy) Deprecated.
AbstractVerb(FailureStrategy failureStrategy, String format, Object... args) Deprecated.

Method Summary

Modifier and Type	Method and Description
<V extends AbstractDelegatedVerb> V	about(DelegatedVerbFactory<V> factory) Deprecated. When you switch from implementing DelegatedVerbFactory to implementing CustomSubjectBuilderFactory, you'll switch from this overload to the overload that accepts a CustomSubjectBuilderFactory.
<S extends Subject<S,D>,D,SF extends SubjectFactory<S,D>> AbstractVerb.DelegatedVerb<S,D>	about(SF factory) Deprecated. The recommended method of extension of Truth to new types, which is documented in com.google.common.truth.delegation.DelegationTest.
void	fail() Deprecated. Triggers the failure strategy with an empty failure message
void	fail(String format, Object... args) Deprecated. Triggers the failure strategy with the given failure message
protected FailureStrategy	getFailureStrategy() Deprecated.
abstract T	withMessage(String messageToPrepend) Deprecated. Overrides the failure message of the subsequent subject's propositions.
abstract T	withMessage(String format, Object... args) Deprecated. Overrides the failure message of the subsequent subject's propositions.

Methods inherited from class com.google.common.truth.FailureContext

getFailureMessage, hasFailureMessage

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractVerb

public AbstractVerb(FailureStrategy failureStrategy)

Deprecated.

AbstractVerb

public AbstractVerb(FailureStrategy failureStrategy,
                    @Nullable
                    String format,
                    Object... args)

Deprecated.

Method Detail

getFailureStrategy

protected FailureStrategy getFailureStrategy()

Deprecated.

fail

public void fail()

Deprecated.

Triggers the failure strategy with an empty failure message

fail

public void fail(@Nullable
                 String format,
                 Object... args)

Deprecated.

Triggers the failure strategy with the given failure message

withMessage

public abstract T withMessage(@Nullable
                              String messageToPrepend)

Deprecated.

Overrides the failure message of the subsequent subject's propositions.

Parameters:

messageToPrepend - a descriptive message.

Returns:

A custom verb which will show the descriptive message along with the normal failure text.

See Also:

com.google.common.truth.delegation.DelegationTest

withMessage

public abstract T withMessage(@Nullable
                              String format,
                              Object... args)

Deprecated.

Overrides the failure message of the subsequent subject's propositions.

Parameters:

format - a descriptive message with formatting template content.

args - object parameters to be substituted into the message template.

Returns:

A custom verb which will show the descriptive message along with the normal failure text.

See Also:

com.google.common.truth.delegation.DelegationTest

about

public <S extends Subject<S,D>,D,SF extends SubjectFactory<S,D>> AbstractVerb.DelegatedVerb<S,D> about(SF factory)

Deprecated.

The recommended method of extension of Truth to new types, which is documented in com.google.common.truth.delegation.DelegationTest.

Parameters:

factory - a SubjectFactory<S, D> implementation

Returns:

A custom verb for the type returned by the SubjectFactory

See Also:

com.google.common.truth.delegation.DelegationTest

about

@Deprecated
public final <V extends AbstractDelegatedVerb> V about(DelegatedVerbFactory<V> factory)

Deprecated. When you switch from implementing DelegatedVerbFactory to implementing CustomSubjectBuilderFactory, you'll switch from this overload to the overload that accepts a CustomSubjectBuilderFactory.

A generic, advanced method of extension of Truth to new types, which is documented on DelegatedVerbFactory. Extension creators should prefer SubjectFactory if possible.

Type Parameters:

V - the type of AbstractDelegatedVerb to return

Parameters:

factory - a DelegatedVerbFactory<V> implementation

Returns:

A custom verb of type <V>