Package org.apache.juneau.assertions

Class AnyAssertion<T>

java.lang.Object

org.apache.juneau.assertions.Assertion

org.apache.juneau.assertions.FluentAssertion<R>

org.apache.juneau.assertions.FluentObjectAssertion<T,R>

org.apache.juneau.assertions.FluentAnyAssertion<T,AnyAssertion<T>>

org.apache.juneau.assertions.AnyAssertion<T>

Type Parameters:

T - The object type.

public class AnyAssertion<T>
extends FluentAnyAssertion<T,AnyAssertion<T>>

Used for assertion calls against generic POJOs.

Extends from ObjectAssertion allowing you to perform basic assertions, but adds several transform methods to convert to more-specific assertion types.

Example:

import static org.apache.juneau.assertions.Assertions.*; List<MyBean> listOfBeans = ...; assertList(listOfBeans) .asItem(1) // Returns an AnyAssertion. .asBean() // Transforms to BeanAssertion. .asProperty("foo") // Returns an AnyAssertion. .asString() // Transforms to StringAssertion. .is("bar"); // Performs test.

Test Methods:

• FluentObjectAssertion
  • isExists()
  • is(Object)
  • is(Predicate)
  • isNot(Object)
  • isAny(Object...)
  • isNotAny(Object...)
  • isNull()
  • isNotNull()
  • isString(String)
  • isJson(String)
  • isSame(Object)
  • isSameJsonAs(Object)
  • isSameSortedJsonAs(Object)
  • isSameSerializedAs(Object, WriterSerializer)
  • isType(Class)
  • isExactType(Class)

Transform Methods:

• FluentAnyAssertion
  • asArray(Class)
  • asIntArray()
  • asLongArray()
  • asShortArray()
  • asFloatArray()
  • asDoubleArray()
  • asCharArray()
  • asByteArray()
  • asBooleanArray()
  • asBoolean()
  • asBytes()
  • asCollection()
  • asCollection(Class)
  • asStringList()
  • asComparable()
  • asDate()
  • asInteger()
  • asLong()
  • asList()
  • asList(Class)
  • asMap()
  • asMap(Class,Class)
  • asBean()
  • asBean(Class)
  • asBeanList(Class)
  • asZonedDateTime()
• FluentObjectAssertion
  • asString()
  • asString(WriterSerializer)
  • asString(Function)
  • asJson()
  • asJsonSorted()
  • asApplied(Function)
  • asAny()

Configuration Methods:

• Assertion
  • setMsg(String, Object...)
  • setOut(PrintStream)
  • setSilent()
  • setStdOut()
  • setThrowable(Class)

See Also:

• Overview > juneau-assertions > Overview

Constructor Summary

Constructors

Constructor	Description
AnyAssertion(T value)	Constructor.

Method Summary

Modifier and Type	Method	Description
static <T> AnyAssertion<T>	create(T value)	Static creator.
AnyAssertion<T>	setMsg(String msg, Object... args)	Allows you to override the assertion failure message.
AnyAssertion<T>	setOut(PrintStream value)	If an error occurs, send the error message to the specified stream instead of STDERR.
AnyAssertion<T>	setSilent()	Suppresses output to STDERR.
AnyAssertion<T>	setStdOut()	If an error occurs, send the error message to STDOUT instead of STDERR.
AnyAssertion<T>	setThrowable(Class<? extends RuntimeException> value)	If an error occurs, throw this exception instead of the standard AssertionError.

Methods inherited from class org.apache.juneau.assertions.FluentAnyAssertion

asArray, asBean, asBean, asBeanList, asBoolean, asBooleanArray, asByteArray, asBytes, asCharArray, asCollection, asCollection, asComparable, asDate, asDoubleArray, asFloatArray, asIntArray, asInteger, asList, asList, asLong, asLongArray, asMap, asMap, asShortArray, asStringList, asZonedDateTime

Methods inherited from class org.apache.juneau.assertions.FluentObjectAssertion

asAny, asJson, asJsonSorted, asString, asString, asString, asTransformed, asTransformedTo, equals, getFailureMessage, is, is, isAny, isExactType, isExists, isJson, isNot, isNotAny, isNotNull, isNull, isSame, isSameJsonAs, isSameSerializedAs, isSameSortedJsonAs, isString, isType, map, opt, orElse, toString, value, valueAsString, valueIsNotNull, valueIsNull

Methods inherited from class org.apache.juneau.assertions.FluentAssertion

returns

Methods inherited from class org.apache.juneau.assertions.Assertion

arrayClass, className, error, error

Methods inherited from class java.lang.Object

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

Constructor Details

AnyAssertion

public AnyAssertion(T value)

Constructor.

Parameters:

value - The object being tested.
Can be null.

Method Details

create

public static <T> AnyAssertion<T> create(T value)

Static creator.

Type Parameters:

T - The value type.

Parameters:

value - The object being tested.
Can be null.

Returns:

A new assertion object.

setMsg

public AnyAssertion<T> setMsg(String msg,
 Object... args)

Description copied from class: Assertion

Allows you to override the assertion failure message.

String can contain "{msg}" to represent the original message.

Example:

import static org.apache.juneau.assertions.Assertions.*; // Throws an assertion with a custom message instead of the default "Value was null." assertString(myString) .setMsg("My string was bad: {msg}") .isNotNull();

Overrides:

setMsg in class FluentAnyAssertion<T,AnyAssertion<T>>

Parameters:

msg - The assertion failure message.

args - Optional message arguments.

Returns:

This object.

setOut

public AnyAssertion<T> setOut(PrintStream value)

Description copied from class: Assertion

If an error occurs, send the error message to the specified stream instead of STDERR.

Overrides:

setOut in class FluentAnyAssertion<T,AnyAssertion<T>>

Parameters:

value - The output stream. Can be null to suppress output.

Returns:

This object.

setSilent

public AnyAssertion<T> setSilent()

Description copied from class: Assertion

Suppresses output to STDERR.

This is the equivalent to calling out(null).

Overrides:

setSilent in class FluentAnyAssertion<T,AnyAssertion<T>>

Returns:

This object.

setStdOut

public AnyAssertion<T> setStdOut()

Description copied from class: Assertion

If an error occurs, send the error message to STDOUT instead of STDERR.

Overrides:

setStdOut in class FluentAnyAssertion<T,AnyAssertion<T>>

Returns:

This object.

setThrowable

public AnyAssertion<T> setThrowable(Class<? extends RuntimeException> value)

Description copied from class: Assertion

If an error occurs, throw this exception instead of the standard AssertionError.

The throwable class must have a public constructor that takes in any of the following parameters:

• Throwable - The caused-by exception (if there is one).
• String - The assertion failure message.

If the throwable cannot be instantiated, a RuntimeException is thrown instead.

Example:

import static org.apache.juneau.assertions.Assertions.*; // Throws a BadRequest instead of an AssertionError if the string is null. assertString(myString) .setThrowable(BadRequest.class) .isNotNull();

Overrides:

setThrowable in class FluentAnyAssertion<T,AnyAssertion<T>>

Parameters:

value - The new value for this setting.

Returns:

This object.