ch.powerunit

Interface AssertThatIterable<T>

Type Parameters:

T - the Element type of the Iterator

All Superinterfaces:

AssertThatObject<Iterable<T>>

public interface AssertThatIterable<T>
extends AssertThatObject<Iterable<T>>

DSL on assertion on iterable.

This interface is returned by the various methods assertThatIterable exposed by TestSuite.

Author:

borettim

See Also:

assertion on object are also available on iterable.

Method Summary

Modifier and Type	Method and Description
default boolean	contains(T... items) Check that the iterable contains the items.
default boolean	containsInAnyOrder(T... items) Check that the iterable contains the items in any order.
default boolean	containsInAnyOrderMatching(Matcher<? super T>... items) Check that the iterable contains the items in any order.
default boolean	containsMatching(Matcher<? super T>... items) Check that the iterable contains the items.
default boolean	hasNotSize(int size) Check the size is not the one passed.
default boolean	hasSize(int size) Check the size of the iterable.

Methods inherited from interface ch.powerunit.AssertThatObject

is, is, isA, isNot, isNot, isNotNull, isNull

Method Detail

hasSize

default boolean hasSize(int size)

Check the size of the iterable.

For instance :

 assertThatIterable(myCollection).hasSize(3);
 

By default, assertion can only be used from the main thread of the test ; When used from another thread, the assertion will be lost. In the case the fastFail attribute of @Test annotation is used, the assertion may not be lost, in case the thread use an assertion method from the test object instance.

Parameters:

size - the expected size.

Returns:

true if the assertion is valid ; If the assertion is false, depending on Test.fastFail() : If true, then fail the test, else, return false and the test will be failed later.

hasNotSize

default boolean hasNotSize(int size)

Check the size is not the one passed.

For instance :

 assertThatIterable(myCollection).hasNotSize(4);
 

By default, assertion can only be used from the main thread of the test ; When used from another thread, the assertion will be lost. In the case the fastFail attribute of @Test annotation is used, the assertion may not be lost, in case the thread use an assertion method from the test object instance.

Parameters:

size - the not expected size.

Returns:

true if the assertion is valid ; If the assertion is false, depending on Test.fastFail() : If true, then fail the test, else, return false and the test will be failed later.

See Also:

The documentation of the fastFail attribute of the @Test annotation, regarding the action done by this assertion.

contains

default boolean contains(T... items)

Check that the iterable contains the items.

For instance :

 assertThatIterable(myList).contains(1, 3, 5);
 

By default, assertion can only be used from the main thread of the test ; When used from another thread, the assertion will be lost. In the case the fastFail attribute of @Test annotation is used, the assertion may not be lost, in case the thread use an assertion method from the test object instance.

Parameters:

items - the expected items.

Returns:

true if the assertion is valid ; If the assertion is false, depending on Test.fastFail() : If true, then fail the test, else, return false and the test will be failed later.

See Also:

The documentation of the fastFail attribute of the @Test annotation, regarding the action done by this assertion.

containsMatching

default boolean containsMatching(Matcher<? super T>... items)

Check that the iterable contains the items.

For instance

 assertThatIterable(myList).containsMatching(equalTo(1), equalTo(3), equalTo(5));
 

By default, assertion can only be used from the main thread of the test ; When used from another thread, the assertion will be lost. In the case the fastFail attribute of @Test annotation is used, the assertion may not be lost, in case the thread use an assertion method from the test object instance.

Parameters:

items - the matcher for each item.

Returns:

true if the assertion is valid ; If the assertion is false, depending on Test.fastFail() : If true, then fail the test, else, return false and the test will be failed later.

See Also:

The documentation of the fastFail attribute of the @Test annotation, regarding the action done by this assertion.

containsInAnyOrder

default boolean containsInAnyOrder(T... items)

Check that the iterable contains the items in any order.

For instance :

 assertThatIterable(myCollection).containsInAnyOrder(5, 3, 1);
 

By default, assertion can only be used from the main thread of the test ; When used from another thread, the assertion will be lost. In the case the fastFail attribute of @Test annotation is used, the assertion may not be lost, in case the thread use an assertion method from the test object instance.

Parameters:

items - the expected items.

Returns:

true if the assertion is valid ; If the assertion is false, depending on Test.fastFail() : If true, then fail the test, else, return false and the test will be failed later.

See Also:

The documentation of the fastFail attribute of the @Test annotation, regarding the action done by this assertion.

containsInAnyOrderMatching

default boolean containsInAnyOrderMatching(Matcher<? super T>... items)

Check that the iterable contains the items in any order.

For instance :

 assertThatIterable(myCollection).containsInAnyOrderMatching(equalTo(5),
                equalTo(3), equalTo(1));
 

By default, assertion can only be used from the main thread of the test ; When used from another thread, the assertion will be lost. In the case the fastFail attribute of @Test annotation is used, the assertion may not be lost, in case the thread use an assertion method from the test object instance.

Parameters:

items - the matcher for each item.

Returns:

true if the assertion is valid ; If the assertion is false, depending on Test.fastFail() : If true, then fail the test, else, return false and the test will be failed later.

See Also:

The documentation of the fastFail attribute of the @Test annotation, regarding the action done by this assertion.