|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.fest.assertions.api.AbstractAssert<S,A>
org.fest.assertions.api.AbstractIterableAssert<S,A>
S
- the "self" type of this assertion class. Please read
"Emulating 'self types' using Java Generics to simplify fluent
API implementation" for more details.A
- the type of the "actual" value.public abstract class AbstractIterableAssert<S,A extends Iterable<?>>
Base class for implementations of
whose actual value type is
ObjectEnumerableAssert
.
Collection
Field Summary |
---|
Fields inherited from class org.fest.assertions.api.AbstractAssert |
---|
actual, myself |
Constructor Summary | |
---|---|
protected |
AbstractIterableAssert(A actual,
Class<S> selfType)
|
Method Summary | ||
---|---|---|
|
are(Condition<E> condition)
Verifies that each element value satisfies the given condition |
|
|
areAtLeast(int times,
Condition<E> condition)
Verifies that there is at least n elements in the actual group satisfying the given condition. |
|
|
areAtMost(int times,
Condition<E> condition)
Verifies that there is at most n elements in the actual group satisfying the given condition. |
|
|
areExactly(int times,
Condition<E> condition)
Verifies that there is exactly n elements in the actual group satisfying the given condition. |
|
|
areNot(Condition<E> condition)
Verifies that each element value not satisfies the given condition |
|
|
areNotAtLeast(int times,
Condition<E> condition)
Verifies that there is at least n elements in the actual group not satisfying the given condition. |
|
|
areNotAtMost(int times,
Condition<E> condition)
Verifies that there is at most n elements in the actual group not satisfying the given condition. |
|
|
areNotExactly(int times,
Condition<E> condition)
Verifies that there is exactly n elements in the actual group not satisfying the given condition. |
|
S |
contains(Object... values)
Verifies that the actual group contains the given values, in any order. |
|
S |
containsNull()
Verifies that the actual group contains at least a null element. |
|
S |
containsOnly(Object... values)
Verifies that the actual group contains only the given values and nothing else, in any order. |
|
S |
containsSequence(Object... sequence)
Verifies that the actual group contains the given sequence, without any other values between them. |
|
S |
doesNotContain(Object... 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. |
|
|
doNotHave(Condition<E> condition)
Verifies that each element value not satisfies the given condition |
|
|
doNotHaveAtLeast(int times,
Condition<E> condition)
This method is an alias ObjectEnumerableAssert.areNotAtLeast(int, Condition) . |
|
|
doNotHaveAtMost(int times,
Condition<E> condition)
This method is an alias ObjectEnumerableAssert.areNotAtMost(int, Condition) . |
|
|
doNotHaveExactly(int times,
Condition<E> condition)
This method is an alias ObjectEnumerableAssert.areNotExactly(int, Condition) . |
|
S |
endsWith(Object... sequence)
Verifies that the actual group ends with the given sequence of objects, without any other objects between them. |
|
S |
hasSize(int expected)
Verifies that the number of values in the actual group is equal to the given one. |
|
|
have(Condition<E> condition)
Verifies that each element value satisfies the given condition |
|
|
haveAtLeast(int times,
Condition<E> condition)
This method is an alias for ObjectEnumerableAssert.areAtLeast(int, Condition) . |
|
|
haveAtMost(int times,
Condition<E> condition)
This method is an alias ObjectEnumerableAssert.areAtMost(int, Condition) . |
|
|
haveExactly(int times,
Condition<E> condition)
This method is an alias ObjectEnumerableAssert.areExactly(int, Condition) . |
|
void |
isEmpty()
Verifies that the actual group of values is empty. |
|
S |
isNotEmpty()
Verifies that the actual group of values is not empty. |
|
void |
isNullOrEmpty()
Verifies that the actual group of values is null or empty. |
|
S |
isSubsetOf(Iterable<?> values)
Verifies that all the elements of the actual Iterable are present in the given Iterable . |
|
S |
startsWith(Object... sequence)
Verifies that the actual group starts with the given sequence of objects, without any other objects between them. |
|
S |
usingComparator(Comparator<?> customComparator)
Use given custom comparator instead of relying on actual type A equals method for incoming assertion checks. |
|
S |
usingDefaultComparator()
Revert to standard comparison for incoming assertion checks. |
Methods inherited from class org.fest.assertions.api.AbstractAssert |
---|
as, as, describedAs, describedAs, descriptionText, doesNotHave, equals, has, hashCode, is, isEqualTo, isIn, isIn, isNot, isNotEqualTo, isNotIn, isNotIn, isNotNull, isNotSameAs, isNull, isSameAs |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected AbstractIterableAssert(A actual, Class<S> selfType)
Method Detail |
---|
public final void isNullOrEmpty()
null
or empty.
isNullOrEmpty
in interface EnumerableAssert<S>
public final void isEmpty()
isEmpty
in interface EnumerableAssert<S>
public final S isNotEmpty()
isNotEmpty
in interface EnumerableAssert<S>
this
assertion object.public final S hasSize(int expected)
hasSize
in interface EnumerableAssert<S>
expected
- the expected number of values in the actual group.
this
assertion object.public final S contains(Object... values)
contains
in interface ObjectEnumerableAssert<S>
values
- the given values.
this
assertion object.public final S containsOnly(Object... values)
containsOnly
in interface ObjectEnumerableAssert<S>
values
- the given values.
this
assertion object.public final S isSubsetOf(Iterable<?> values)
Iterable
are present in the given Iterable
.
values
- the Iterable
that should contain all actual elements.
AssertionError
- if the actual Iterable
is null
.
NullPointerException
- if the given Iterable
is null
.
AssertionError
- if the actual Iterable
is not subset of set Iterable
.public final S containsSequence(Object... sequence)
containsSequence
in interface ObjectEnumerableAssert<S>
sequence
- the sequence of objects to look for.
public final S doesNotContain(Object... values)
doesNotContain
in interface ObjectEnumerableAssert<S>
values
- the given values.
this
assertion object.public final S doesNotHaveDuplicates()
doesNotHaveDuplicates
in interface ObjectEnumerableAssert<S>
this
assertion object.public final S startsWith(Object... sequence)
ObjectEnumerableAssert.containsSequence(Object...)
, but it also verifies that the first element in the
sequence is also first element of the actual group.
startsWith
in interface ObjectEnumerableAssert<S>
sequence
- the sequence of objects to look for.
public final S endsWith(Object... sequence)
ObjectEnumerableAssert.containsSequence(Object...)
, but it also verifies that the last element in the
sequence is also last element of the actual group.
endsWith
in interface ObjectEnumerableAssert<S>
sequence
- the sequence of objects to look for.
public S containsNull()
containsNull
in interface ObjectEnumerableAssert<S>
this
assertion object.public S doesNotContainNull()
doesNotContainNull
in interface ObjectEnumerableAssert<S>
this
assertion object.public <E> S are(Condition<E> condition)
are
in interface ObjectEnumerableAssert<S>
condition
- the given condition.
this
object.public <E> S areNot(Condition<E> condition)
areNot
in interface ObjectEnumerableAssert<S>
condition
- the given condition.
this
object.public <E> S have(Condition<E> condition)
have
in interface ObjectEnumerableAssert<S>
condition
- the given condition.
this
object.public <E> S doNotHave(Condition<E> condition)
doNotHave
in interface ObjectEnumerableAssert<S>
condition
- the given condition.
this
object.public <E> S areAtLeast(int times, Condition<E> condition)
areAtLeast
in interface ObjectEnumerableAssert<S>
times
- the minimum number of times the condition should be verified.condition
- the given condition.
this
object.public <E> S areNotAtLeast(int times, Condition<E> condition)
areNotAtLeast
in interface ObjectEnumerableAssert<S>
times
- the number of times the condition should not be verified at least.condition
- the given condition.
this
object.public <E> S areAtMost(int times, Condition<E> condition)
areAtMost
in interface ObjectEnumerableAssert<S>
times
- the number of times the condition should be at most verified.condition
- the given condition.
this
object.public <E> S areNotAtMost(int times, Condition<E> condition)
areNotAtMost
in interface ObjectEnumerableAssert<S>
times
- the number of times the condition should not be verified at most.condition
- the given condition.
this
object.public <E> S areExactly(int times, Condition<E> condition)
areExactly
in interface ObjectEnumerableAssert<S>
times
- the exact number of times the condition should be verified.condition
- the given condition.
this
object.public <E> S areNotExactly(int times, Condition<E> condition)
areNotExactly
in interface ObjectEnumerableAssert<S>
times
- the exact number of times the condition should not be verified.condition
- the given condition.
this
object.public <E> S haveAtLeast(int times, Condition<E> condition)
ObjectEnumerableAssert.areAtLeast(int, Condition)
.
haveAtLeast
in interface ObjectEnumerableAssert<S>
public <E> S doNotHaveAtLeast(int times, Condition<E> condition)
ObjectEnumerableAssert.areNotAtLeast(int, Condition)
.
doNotHaveAtLeast
in interface ObjectEnumerableAssert<S>
public <E> S haveAtMost(int times, Condition<E> condition)
ObjectEnumerableAssert.areAtMost(int, Condition)
.
haveAtMost
in interface ObjectEnumerableAssert<S>
public <E> S doNotHaveAtMost(int times, Condition<E> condition)
ObjectEnumerableAssert.areNotAtMost(int, Condition)
.
doNotHaveAtMost
in interface ObjectEnumerableAssert<S>
public <E> S haveExactly(int times, Condition<E> condition)
ObjectEnumerableAssert.areExactly(int, Condition)
.
haveExactly
in interface ObjectEnumerableAssert<S>
public <E> S doNotHaveExactly(int times, Condition<E> condition)
ObjectEnumerableAssert.areNotExactly(int, Condition)
.
doNotHaveExactly
in interface ObjectEnumerableAssert<S>
public S usingComparator(Comparator<?> customComparator)
AbstractAssert
// compares invoices by payee assertThat(invoiceList).usingComparator(invoicePayeeComparator).isEqualTo(expectedInvoiceList). // compares invoices by date, doesNotHaveDuplicates and contains both use the given invoice date comparator assertThat(invoiceList).usingComparator(invoiceDateComparator).doesNotHaveDuplicates().contains(may2010Invoice) // as assertThat(invoiceList) creates a new assertion, it uses standard comparison strategy (Invoice's equal method) to compare invoiceList elements to lowestInvoice. assertThat(invoiceList).contains(lowestInvoice).Custom comparator is not parameterized with actual type A (ie. Comparator<A>) because if it was, we could not write the following code :
// frodo and sam are instances of Character (a Character having a Race) // raceComparator implements Comparator<Character> // assertThat(frodo) returns an ObjectAssert and not a custom CharacterAssert implementing Assert<CharacterAssert, Character> assertThat(frodo).usingComparator(raceComparator).isEqualTo(sam); // won't compile ! The code does not compile because assertThat(frodo) returns an ObjectAssert, thus usingComparator expects a Comparator<Object> and Comparator<Character> is not a Comparator<Object> as generics are not reified. Note that, it would have worked if assertThat(frodo) returned a CharacterAssert implementing Assert<CharacterAssert, Character>.
usingComparator
in interface Assert<S,A extends Iterable<?>>
usingComparator
in class AbstractAssert<S,A extends Iterable<?>>
customComparator
- the comparator to use for incoming assertion checks.
this
assertion object.public S usingDefaultComparator()
AbstractAssert
Assert.usingComparator(Comparator)
.
usingDefaultComparator
in interface Assert<S,A extends Iterable<?>>
usingDefaultComparator
in class AbstractAssert<S,A extends Iterable<?>>
this
assertion object.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |