org.assertj.core.api

Interface IndexedObjectEnumerableAssert<S extends IndexedObjectEnumerableAssert<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>, ObjectEnumerableAssert<S,T>

All Known Implementing Classes:

AbstractListAssert, AbstractObjectArrayAssert, ClassBasedNavigableListAssert, FactoryBasedNavigableListAssert, ListAssert, ObjectArrayAssert

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

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

Author:

Alex Ruiz, Mikhail Mazursky

Method Summary

Modifier and Type	Method and Description
S	contains(T value, Index index) Verifies that the actual group contains the given object at the given index.
S	doesNotContain(T value, Index index) Verifies that the actual group does not contain the given object at the given index.

Methods inherited from interface org.assertj.core.api.ObjectEnumerableAssert

allMatch, are, areAtLeast, areAtLeastOne, areAtMost, areExactly, areNot, contains, containsAll, containsExactly, containsExactlyElementsOf, containsExactlyInAnyOrder, containsNull, containsOnly, containsOnlyElementsOf, containsOnlyOnce, containsSequence, containsSubsequence, doesNotContain, doesNotContainAnyElementsOf, doesNotContainNull, doesNotHaveDuplicates, doNotHave, endsWith, hasAtLeastOneElementOfType, hasOnlyElementsOfType, hasSameElementsAs, have, haveAtLeast, haveAtLeastOne, haveAtMost, haveExactly, isSubsetOf, isSubsetOf, startsWith

Methods inherited from interface org.assertj.core.api.EnumerableAssert

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

Method Detail

contains

S contains(T value,
           Index index)

Verifies that the actual group contains the given object at the given index.

Example:

 List<Ring> elvesRings = newArrayList(vilya, nenya, narya);

 // assertions will pass
 assertThat(elvesRings).contains(vilya, atIndex(0));
 assertThat(elvesRings).contains(nenya, atIndex(1));
 assertThat(elvesRings).contains(narya, atIndex(2));

 // assertions will fail
 assertThat(elvesRings).contains(vilya, atIndex(1));
 assertThat(elvesRings).contains(nenya, atIndex(2));
 assertThat(elvesRings).contains(narya, atIndex(0));

Parameters:

value - the object to look for.

index - the index where the object should be stored in the actual group.

Returns:

this assertion object.

Throws:

AssertionError - if the actual group is null or empty.

NullPointerException - if the given Index is null.

IndexOutOfBoundsException - if the value of the given Index is equal to or greater than the size of the actual group.

AssertionError - if the actual group does not contain the given object at the given index.

doesNotContain

S doesNotContain(T value,
                 Index index)

Verifies that the actual group does not contain the given object at the given index.

Example:

 List<Ring> elvesRings = newArrayList(vilya, nenya, narya);

 // assertions will pass
 assertThat(elvesRings).contains(vilya, atIndex(1));
 assertThat(elvesRings).contains(nenya, atIndex(2));
 assertThat(elvesRings).contains(narya, atIndex(0));

 // assertions will fail
 assertThat(elvesRings).contains(vilya, atIndex(0));
 assertThat(elvesRings).contains(nenya, atIndex(1));
 assertThat(elvesRings).contains(narya, atIndex(2));

Parameters:

value - the object to look for.

index - the index where the object should not be stored in the actual group.

Returns:

this assertion object.

Throws:

AssertionError - if the actual group is null.

NullPointerException - if the given Index is null.

AssertionError - if the actual group contains the given object at the given index.