com.google.common.truth

Class Subject<S extends Subject<S,T>,T>

java.lang.Object

com.google.common.truth.Subject<S,T>

Direct Known Subclasses:

AbstractArraySubject, ClassSubject, ComparableSubject, DefaultSubject, GuavaOptionalSubject, IterableSubject, MapSubject, MultimapSubject, TableSubject, ThrowableSubject

public class Subject<S extends Subject<S,T>,T>
extends Object

Propositions for arbitrarily typed subjects and for properties of Object

Author:

David Saff, Christian Gruber

Field Summary

Fields

Modifier and Type	Field and Description
protected FailureStrategy	failureStrategy

Constructor Summary

Constructors

Constructor and Description
Subject(FailureStrategy failureStrategy, T subject)

Method Summary

Modifier and Type	Method and Description
protected TestVerb	check() A convenience for implementers of Subject subclasses to use other truth Subject wrappers within their own propositional logic.
boolean	equals(Object o) Deprecated. Object.equals(Object) is not supported on Truth subjects. If you meant to test object equality, use isEqualTo(Object) instead.
protected void	fail(String verb) Assembles a failure message and passes such to the FailureStrategy
protected void	fail(String verb, Object... messageParts) Assembles a failure message and passes such to the FailureStrategy
protected void	fail(String verb, Object other) Assembles a failure message and passes such to the FailureStrategy.
protected void	failWithBadResults(String verb, Object expected, String failVerb, Object actual) Assembles a failure message and passes it to the FailureStrategy
protected void	failWithCustomSubject(String verb, Object expected, Object actual) Assembles a failure message with an alternative representation of the wrapped subject and passes it to the FailureStrategy
protected void	failWithoutSubject(String verb) Assembles a failure message without a given subject and passes it to the FailureStrategy
protected void	failWithRawMessage(String message, Object... parameters) Passes through a failure message verbatim.
protected String	getDisplaySubject()
protected T	getSubject()
int	hashCode() Deprecated. Object.hashCode() is not supported on Truth subjects.
protected String	internalCustomName()
void	isAnyOf(Object first, Object second, Object... rest) Fails unless the subject is equal to any of the given elements.
void	isEqualTo(Object other) Fails if the subject is not equal to the given object.
void	isIn(Iterable<?> iterable) Fails unless the subject is equal to any element in the given iterable.
void	isInstanceOf(Class<?> clazz) Fails if the subject is not an instance of the given class.
void	isNoneOf(Object first, Object second, Object... rest) Fails if the subject is equal to any of the given elements.
void	isNotEqualTo(Object other) Fails if the subject is equal to the given object.
void	isNotIn(Iterable<?> iterable) Fails if the subject is equal to any element in the given iterable.
void	isNotInstanceOf(Class<?> clazz) Fails if the subject is an instance of the given class.
void	isNotNull() Fails if the subject is null.
void	isNotSameAs(Object other) Fails if the subject is the same instance as the given object.
void	isNull() Fails if the subject is not null.
void	isSameAs(Object other) Fails if the subject is not the same instance as the given object.
S	named(String name) Renames the subject so that this name appears in the error messages in place of string representations of the subject.

Methods inherited from class java.lang.Object

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

Field Detail

failureStrategy

protected final FailureStrategy failureStrategy

Constructor Detail

Subject

public Subject(FailureStrategy failureStrategy,
               @Nullable
               T subject)

Method Detail

internalCustomName

protected String internalCustomName()

named

public S named(String name)

Renames the subject so that this name appears in the error messages in place of string representations of the subject.

isNull

public void isNull()

Fails if the subject is not null.

isNotNull

public void isNotNull()

Fails if the subject is null.

isEqualTo

public void isEqualTo(@Nullable
                      Object other)

Fails if the subject is not equal to the given object. For the purposes of this comparison, two objects are equal if any of the following is true:

• they are equal according to Objects.equal(java.lang.Object, java.lang.Object)
• they are arrays and are considered equal by the appropriate Arrays#equals overload
• they are boxed integer types (Byte, Short, Character, Integer, or Long) and they are numerically equal when converted to Long.

isNotEqualTo

public void isNotEqualTo(@Nullable
                         Object other)

Fails if the subject is equal to the given object. The meaning of equality is the same as for the isEqualTo(java.lang.Object) method.

isSameAs

public void isSameAs(@Nullable
                     Object other)

Fails if the subject is not the same instance as the given object.

isNotSameAs

public void isNotSameAs(@Nullable
                        Object other)

Fails if the subject is the same instance as the given object.

isInstanceOf

public void isInstanceOf(Class<?> clazz)

Fails if the subject is not an instance of the given class.

isNotInstanceOf

public void isNotInstanceOf(Class<?> clazz)

Fails if the subject is an instance of the given class.

isIn

public void isIn(Iterable<?> iterable)

Fails unless the subject is equal to any element in the given iterable.

isAnyOf

public void isAnyOf(@Nullable
                    Object first,
                    @Nullable
                    Object second,
                    @Nullable
                    Object... rest)

Fails unless the subject is equal to any of the given elements.

isNotIn

public void isNotIn(Iterable<?> iterable)

Fails if the subject is equal to any element in the given iterable.

isNoneOf

public void isNoneOf(@Nullable
                     Object first,
                     @Nullable
                     Object second,
                     @Nullable
                     Object... rest)

Fails if the subject is equal to any of the given elements.

getSubject

protected T getSubject()

getDisplaySubject

protected String getDisplaySubject()

check

protected TestVerb check()

A convenience for implementers of Subject subclasses to use other truth Subject wrappers within their own propositional logic.

fail

protected void fail(String verb)

Assembles a failure message and passes such to the FailureStrategy

Parameters:

verb - the proposition being asserted

fail

protected void fail(String verb,
                    Object other)

Assembles a failure message and passes such to the FailureStrategy. Also performs disambiguation if the subject and other have the same toString()'s.

Parameters:

verb - the proposition being asserted

other - the value against which the subject is compared

fail

protected void fail(String verb,
                    Object... messageParts)

Assembles a failure message and passes such to the FailureStrategy

Parameters:

verb - the proposition being asserted

messageParts - the expectations against which the subject is compared

failWithBadResults

protected void failWithBadResults(String verb,
                                  Object expected,
                                  String failVerb,
                                  Object actual)

Assembles a failure message and passes it to the FailureStrategy

Parameters:

verb - the proposition being asserted

expected - the expectations against which the subject is compared

failVerb - the failure of the proposition being asserted

actual - the actual value the subject was compared against

failWithCustomSubject

protected void failWithCustomSubject(String verb,
                                     Object expected,
                                     Object actual)

Assembles a failure message with an alternative representation of the wrapped subject and passes it to the FailureStrategy

Parameters:

verb - the proposition being asserted

expected - the expected value of the proposition

actual - the custom representation of the subject to be reported in the failure.

failWithoutSubject

protected void failWithoutSubject(String verb)

Assembles a failure message without a given subject and passes it to the FailureStrategy

Parameters:

verb - the proposition being asserted

failWithRawMessage

protected void failWithRawMessage(String message,
                                  Object... parameters)

Passes through a failure message verbatim. Used for Subject subclasses which need to provide alternate language for more fit-to-purpose error messages.

Parameters:

message - the message template to be passed to the failure. Note, this method only guarantees to process %s tokens. It is not guaranteed to be compatible with String.format(). Any other formatting desired (such as floats or scientific notation) should be performed before the method call and the formatted value passed in as a string.

parameters - the object parameters which will be applied to the message template.

equals

@Deprecated
public boolean equals(@Nullable
                                  Object o)

Deprecated. Object.equals(Object) is not supported on Truth subjects. If you meant to test object equality, use isEqualTo(Object) instead.

Overrides:

equals in class Object

Throws:

UnsupportedOperationException - always

hashCode

@Deprecated
public int hashCode()

Deprecated. Object.hashCode() is not supported on Truth subjects.

Overrides:

hashCode in class Object

Throws:

UnsupportedOperationException - always