Package org.fest.assertions.core

Interface ObjectEnumerableAssert<S extends ObjectEnumerableAssert<S,T>,T>

Type Parameters:

S - the "self" type of this assertion class. Please read "Emulating 'self types' using Java Generics to simplify fluent API implementation" for more details.

T - the type of elements of the "actual" value.

All Superinterfaces:

EnumerableAssert<S,T>

All Known Subinterfaces:

IndexedObjectEnumerableAssert<S,T>

All Known Implementing Classes:

AbstractIterableAssert, IterableAssert, ListAssert, ObjectArrayAssert

public interface ObjectEnumerableAssert<S extends ObjectEnumerableAssert<S,T>,T>
extends EnumerableAssert<S,T>

Assertions methods applicable to groups of objects (e.g. arrays or collections.)

Author:

Yvonne Wang, Alex Ruiz, Nicolas François, Mikhail Mazursky, Joel Costigliola, Nicolas François

Method Summary

Modifier and Type	Method	Description
S	are(Condition<? super T> condition)	Verifies that each element value satisfies the given condition
S	areAtLeast(int n, Condition<? super T> condition)	Verifies that there is at least n elements in the actual group satisfying the given condition.
S	areAtMost(int n, Condition<? super T> condition)	Verifies that there is at most n elements in the actual group satisfying the given condition.
S	areExactly(int n, Condition<? super T> condition)	Verifies that there is exactly n elements in the actual group satisfying the given condition.
S	areNot(Condition<? super T> condition)	Verifies that each element value not satisfies the given condition
S	areNotAtLeast(int n, Condition<? super T> condition)	Verifies that there is at least n elements in the actual group not satisfying the given condition.
S	areNotAtMost(int n, Condition<? super T> condition)	Verifies that there is at most n elements in the actual group not satisfying the given condition.
S	areNotExactly(int n, Condition<? super T> condition)	Verifies that there is exactly n elements in the actual group not satisfying the given condition.
S	contains(T... values)	Verifies that the actual group contains the given values, in any order.
S	containsAll(java.lang.Iterable<? extends T> iterable)	Verifies that the actual group contains all the elements of given Iterable, in any order.
S	containsExactly(T... values)	Verifies that the actual group contains only the given values and nothing else, in order. This assertion should only be used with Iterable that have a consistent iteration order (i.e.
S	containsNull()	Verifies that the actual group contains at least a null element.
S	containsOnly(T... values)	Verifies that the actual group contains only the given values and nothing else, in any order.
S	containsSequence(T... sequence)	Verifies that the actual group contains the given sequence, without any other values between them.
S	doesNotContain(T... values)	Verifies that the actual group does not contain the given values.
S	doesNotContainNull()	Verifies that the actual group does not contain null elements.
S	doesNotHaveDuplicates()	Verifies that the actual group does not contain duplicates.
S	doNotHave(Condition<? super T> condition)	Verifies that each element value not satisfies the given condition
S	doNotHaveAtLeast(int n, Condition<? super T> condition)	This method is an alias areNotAtLeast(int, Condition).
S	doNotHaveAtMost(int n, Condition<? super T> condition)	This method is an alias areNotAtMost(int, Condition).
S	doNotHaveExactly(int n, Condition<? super T> condition)	This method is an alias areNotExactly(int, Condition).
S	endsWith(T... sequence)	Verifies that the actual group ends with the given sequence of objects, without any other objects between them.
S	have(Condition<? super T> condition)	Verifies that each element value satisfies the given condition
S	haveAtLeast(int n, Condition<? super T> condition)	This method is an alias for areAtLeast(int, Condition).
S	haveAtMost(int n, Condition<? super T> condition)	This method is an alias areAtMost(int, Condition).
S	haveExactly(int n, Condition<? super T> condition)	This method is an alias areExactly(int, Condition).
S	startsWith(T... sequence)	Verifies that the actual group starts with the given sequence of objects, without any other objects between them.

Methods inherited from interface org.fest.assertions.core.EnumerableAssert

hasSameSizeAs, hasSameSizeAs, hasSize, isEmpty, isNotEmpty, isNullOrEmpty, usingDefaultElementComparator, usingElementComparator

Method Detail

contains

S contains(T... values)

Verifies that the actual group contains the given values, in any order.

Parameters:

values - the given values.

Returns:

this assertion object.

Throws:

java.lang.NullPointerException - if the given argument is null.

java.lang.IllegalArgumentException - if the given argument is an empty array.

java.lang.AssertionError - if the actual group is null.

java.lang.AssertionError - if the actual group does not contain the given values.

containsOnly

S containsOnly(T... values)

Verifies that the actual group contains only the given values and nothing else, in any order.

Parameters:

values - the given values.

Returns:

this assertion object.

Throws:

java.lang.NullPointerException - if the given argument is null.

java.lang.IllegalArgumentException - if the given argument is an empty array.

java.lang.AssertionError - if the actual group is null.

java.lang.AssertionError - if the actual group does not contain the given values, i.e. the actual group contains some or none of the given values, or the actual group contains more values than the given ones.

containsExactly

S containsExactly(T... values)

Verifies that the actual group contains only the given values and nothing else, in order.
This assertion should only be used with Iterable that have a consistent iteration order (i.e. don't use it with HashSet, prefer containsOnly(Object...) in that case).

Example :

 Iterable<Ring> elvesRings = newArrayList(vilya, nenya, narya);
 
 // assertion will pass
 assertThat(elvesRings).containsExactly(vilya, nenya, narya);
 
 // assertion will fail as actual and expected orders differ.
 assertThat(elvesRings).containsExactly(nenya, vilya, narya);
 

Parameters:

values - the given values.

Returns:

this assertion object.

Throws:

java.lang.NullPointerException - if the given argument is null.

java.lang.IllegalArgumentException - if the given argument is an empty array.

java.lang.AssertionError - if the actual group is null.

java.lang.AssertionError - if the actual group does not contain the given values with same order, i.e. the actual group contains some or none of the given values, or the actual group contains more values than the given ones or values are not in same order.

containsSequence

S containsSequence(T... sequence)

Verifies that the actual group contains the given sequence, without any other values between them.

Parameters:

sequence - the sequence of objects to look for.

Returns:

this assertion object.

Throws:

java.lang.AssertionError - if the actual group is null.

java.lang.AssertionError - if the given array is null.

java.lang.AssertionError - if the actual group does not contain the given sequence.

doesNotContain

S doesNotContain(T... values)

Verifies that the actual group does not contain the given values.

Parameters:

values - the given values.

Returns:

this assertion object.

Throws:

java.lang.NullPointerException - if the given argument is null.

java.lang.IllegalArgumentException - if the given argument is an empty array.

java.lang.AssertionError - if the actual group is null.

java.lang.AssertionError - if the actual group contains any of the given values.

doesNotHaveDuplicates

S doesNotHaveDuplicates()

Verifies that the actual group does not contain duplicates.

Returns:

this assertion object.

Throws:

java.lang.AssertionError - if the actual group is null.

java.lang.AssertionError - if the actual group contains duplicates.

startsWith

S startsWith(T... sequence)

Verifies that the actual group starts with the given sequence of objects, without any other objects between them. Similar to containsSequence(Object...), but it also verifies that the first element in the sequence is also first element of the actual group.

Parameters:

sequence - the sequence of objects to look for.

Returns:

this assertion object.

Throws:

java.lang.NullPointerException - if the given argument is null.

java.lang.IllegalArgumentException - if the given argument is an empty array.

java.lang.AssertionError - if the actual group is null.

java.lang.AssertionError - if the actual group does not start with the given sequence of objects.

endsWith

S endsWith(T... sequence)

Verifies that the actual group ends with the given sequence of objects, without any other objects between them. Similar to containsSequence(Object...), but it also verifies that the last element in the sequence is also last element of the actual group.

Parameters:

sequence - the sequence of objects to look for.

Returns:

this assertion object.

Throws:

java.lang.NullPointerException - if the given argument is null.

java.lang.IllegalArgumentException - if the given argument is an empty array.

java.lang.AssertionError - if the actual group is null.

java.lang.AssertionError - if the actual group does not end with the given sequence of objects.

containsNull

S containsNull()

Verifies that the actual group contains at least a null element.

Returns:

this assertion object.

Throws:

java.lang.AssertionError - if the actual group is null.

java.lang.AssertionError - if the actual group does not contain a null element.

doesNotContainNull

S doesNotContainNull()

Verifies that the actual group does not contain null elements.

Returns:

this assertion object.

Throws:

java.lang.AssertionError - if the actual group is null.

java.lang.AssertionError - if the actual group contains a null element.

are

S are(Condition<? super T> condition)

Verifies that each element value satisfies the given condition

Parameters:

condition - the given condition.

Returns:

this object.

Throws:

java.lang.NullPointerException - if the given condition is null.

java.lang.AssertionError - if a element cannot be cast to E.

java.lang.AssertionError - if one or more element not satisfy the given condition.

areNot

S areNot(Condition<? super T> condition)

Verifies that each element value not satisfies the given condition

Parameters:

condition - the given condition.

Returns:

this object.

Throws:

java.lang.NullPointerException - if the given condition is null.

java.lang.AssertionError - if a element cannot be cast to E.

java.lang.AssertionError - if one or more element satisfy the given condition.

have

S have(Condition<? super T> condition)

Verifies that each element value satisfies the given condition

Parameters:

condition - the given condition.

Returns:

this object.

Throws:

java.lang.NullPointerException - if the given condition is null.

java.lang.AssertionError - if a element cannot be cast to E.

java.lang.AssertionError - if one or more element not satisfy the given condition.

doNotHave

S doNotHave(Condition<? super T> condition)

Verifies that each element value not satisfies the given condition

Parameters:

condition - the given condition.

Returns:

this object.

Throws:

java.lang.NullPointerException - if the given condition is null.

java.lang.AssertionError - if a element cannot be cast to E.

java.lang.AssertionError - if one or more element satisfy the given condition.

areAtLeast

S areAtLeast(int n,
             Condition<? super T> condition)

Verifies that there is at least n elements in the actual group satisfying the given condition.

Parameters:

n - the minimum number of times the condition should be verified.

condition - the given condition.

Returns:

this object.

Throws:

java.lang.NullPointerException - if the given condition is null.

java.lang.AssertionError - if an element can not be cast to E.

java.lang.AssertionError - if the number of elements satisfying the given condition is < n.

areNotAtLeast

S areNotAtLeast(int n,
                Condition<? super T> condition)

Verifies that there is at least n elements in the actual group not satisfying the given condition.

Parameters:

n - the number of times the condition should not be verified at least.

condition - the given condition.

Returns:

this object.

Throws:

java.lang.NullPointerException - if the given condition is null.

java.lang.AssertionError - if a element cannot be cast to E.

java.lang.AssertionError - if the number of elements not satisfying the given condition is < n.

areAtMost

S areAtMost(int n,
            Condition<? super T> condition)

Verifies that there is at most n elements in the actual group satisfying the given condition.

Parameters:

n - the number of times the condition should be at most verified.

condition - the given condition.

Returns:

this object.

Throws:

java.lang.NullPointerException - if the given condition is null.

java.lang.AssertionError - if a element cannot be cast to E.

java.lang.AssertionError - if the number of elements satisfying the given condition is > n.

areNotAtMost

S areNotAtMost(int n,
               Condition<? super T> condition)

Verifies that there is at most n elements in the actual group not satisfying the given condition.

Parameters:

n - the number of times the condition should not be verified at most.

condition - the given condition.

Returns:

this object.

Throws:

java.lang.NullPointerException - if the given condition is null.

java.lang.AssertionError - if a element cannot be cast to E.

java.lang.AssertionError - if the number of elements not satisfying the given condition is > n.

areExactly

S areExactly(int n,
             Condition<? super T> condition)

Verifies that there is exactly n elements in the actual group satisfying the given condition.

Parameters:

n - the exact number of times the condition should be verified.

condition - the given condition.

Returns:

this object.

Throws:

java.lang.NullPointerException - if the given condition is null.

java.lang.AssertionError - if a element cannot be cast to E.

java.lang.AssertionError - if the number of elements satisfying the given condition is ≠ n.

areNotExactly

S areNotExactly(int n,
                Condition<? super T> condition)

Verifies that there is exactly n elements in the actual group not satisfying the given condition.

Parameters:

n - the exact number of times the condition should not be verified.

condition - the given condition.

Returns:

this object.

Throws:

java.lang.NullPointerException - if the given condition is null.

java.lang.AssertionError - if a element cannot be cast to E.

java.lang.AssertionError - if the number of elements not satisfying the given condition is ≠ n.

haveAtLeast

S haveAtLeast(int n,
              Condition<? super T> condition)

This method is an alias for areAtLeast(int, Condition).

doNotHaveAtLeast

S doNotHaveAtLeast(int n,
                   Condition<? super T> condition)

This method is an alias areNotAtLeast(int, Condition).

haveAtMost

S haveAtMost(int n,
             Condition<? super T> condition)

This method is an alias areAtMost(int, Condition).

doNotHaveAtMost

S doNotHaveAtMost(int n,
                  Condition<? super T> condition)

This method is an alias areNotAtMost(int, Condition).

haveExactly

S haveExactly(int n,
              Condition<? super T> condition)

This method is an alias areExactly(int, Condition).

doNotHaveExactly

S doNotHaveExactly(int n,
                   Condition<? super T> condition)

This method is an alias areNotExactly(int, Condition).

containsAll

S containsAll(java.lang.Iterable<? extends T> iterable)

Verifies that the actual group contains all the elements of given Iterable, in any order.

Parameters:

iterable - the given Iterable we will get elements from.

Returns:

this assertion object.

Throws:

java.lang.NullPointerException - if the given argument is null.

java.lang.AssertionError - if the actual group is null.

java.lang.AssertionError - if the actual group does not contain all the elements of given Iterable.