|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
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.public interface EnumerableAssert<S extends EnumerableAssert<S,T>,T>
Assertions applicable to groups of values that can be enumerated (e.g. arrays, collections or strings.)
| Method Summary | |
|---|---|
S |
hasSameSizeAs(Iterable<?> other)
Verifies that the actual group has the same size as given Iterable. |
S |
hasSameSizeAs(Object[] other)
Verifies that the actual group has the same size as given array. |
S |
hasSize(int expected)
Verifies that the number of values in the actual group is equal to the given one. |
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 |
usingDefaultElementComparator()
Revert to standard comparison for incoming assertion group element checks. |
S |
usingElementComparator(Comparator<? super T> customComparator)
Use given custom comparator instead of relying on actual type A equals method to compare group elements for
incoming assertion checks. |
| Method Detail |
|---|
void isNullOrEmpty()
null or empty.
AssertionError - if the actual group of values is not null or not empty.void isEmpty()
AssertionError - if the actual group of values is not empty.S isNotEmpty()
this assertion object.
AssertionError - if the actual group of values is empty.S hasSize(int expected)
expected - the expected number of values in the actual group.
this assertion object.
AssertionError - if the number of values of the actual group is not equal to the given one.S hasSameSizeAs(Iterable<?> other)
Iterable.
other - the Iterable to compare size with actual group.
this assertion object.
AssertionError - if the actual group is null.
AssertionError - if the other Iterable is null.
AssertionError - if actual group and given Iterable don't have the same size.S hasSameSizeAs(Object[] other)
other - the array to compare size with actual group.
this assertion object.
AssertionError - if the actual group is null.
AssertionError - if the other array is null.
AssertionError - if actual group and given array don't have the same size.S usingElementComparator(Comparator<? super T> customComparator)
equals method to compare group elements for
incoming assertion checks.
Custom comparator is bound to assertion instance, meaning that if a new assertion is created, it will use default comparison strategy.
Examples :
// 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 falls back to standard comparison strategy
// based on Invoice's equal method to compare invoiceList elements to lowestInvoice.
assertThat(invoiceList).contains(lowestInvoice).
// standard comparison : the fellowshipOfTheRing includes Gandalf but not Sauron (believe me) ...
assertThat(fellowshipOfTheRing).contains(gandalf)
.doesNotContain(sauron);
// ... but if we compare only races, Sauron is in fellowshipOfTheRing because he's a Maia like Gandalf.
assertThat(fellowshipOfTheRing).usingElementComparator(raceComparator)
.contains(sauron);
customComparator - the comparator to use for incoming assertion checks.
this assertion object.
NullPointerException - if the given comparator is null.S usingDefaultElementComparator()
This method should be used to disable a custom comparison strategy set by calling usingElementComparator(Comparator).
this assertion object.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||