Package org.fest.assertions.internal
Class ObjectArrays
java.lang.Object
org.fest.assertions.internal.ObjectArrays
Reusable assertions for arrays of objects.
- Author:
- Alex Ruiz, Joel Costigliola, Nicolas François, Mikhail Mazursky
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescription<E> void
assertAre
(AssertionInfo info, E[] actual, Condition<? super E> condition) Assert that each element of given array satisfies the given condition.<E> void
assertAreAtLeast
(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Assert that there is at least n array elements satisfying the given condition.<E> void
assertAreAtMost
(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Assert that there is at most n array elements satisfying the given condition.<E> void
assertAreExactly
(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Verifies that there is exactly n array elements satisfying the given condition.<E> void
assertAreNot
(AssertionInfo info, E[] actual, Condition<? super E> condition) Assert that each element of given array not satisfies the given condition.<E> void
assertAreNotAtLeast
(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Assert that there is at least n array elements not satisfying the given condition.<E> void
assertAreNotAtMost
(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Verifies that there is at most n array elements not satisfying the given condition.<E> void
assertAreNotExactly
(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Verifies that there is exactly n elements in the actualIterable
not satisfying the given condition.void
assertContains
(AssertionInfo info, Object[] actual, Object[] values) Asserts that the given array contains the given values, in any order.void
assertContains
(AssertionInfo info, Object[] actual, Object value, Index index) Verifies that the given array contains the given object at the given index.<E> void
assertContainsAll
(AssertionInfo info, E[] actual, Iterable<? extends E> other) Asserts that the given array contains all the elements of the givenIterable
, in any order.void
assertContainsNull
(AssertionInfo info, Object[] actual) Asserts that the given array contains at least a null element.void
assertContainsOnly
(AssertionInfo info, Object[] actual, Object[] values) Asserts that the given array contains only the given values and nothing else, in any order.void
assertContainsSequence
(AssertionInfo info, Object[] actual, Object[] sequence) Verifies that the given array contains the given sequence of objects, without any other objects between them.void
assertDoesNotContain
(AssertionInfo info, Object[] actual, Object[] values) Asserts that the given array does not contain the given values.void
assertDoesNotContain
(AssertionInfo info, Object[] actual, Object value, Index index) Verifies that the given array does not contain the given object at the given index.void
assertDoesNotContainNull
(AssertionInfo info, Object[] actual) Asserts that the given array does not contain null elements.void
assertDoesNotHaveDuplicates
(AssertionInfo info, Object[] actual) Asserts that the given array does not have duplicate values.<E> void
assertDoNotHave
(AssertionInfo info, E[] actual, Condition<? super E> condition) Assert that each element of given array not satisfies the given condition.<E> void
assertDoNotHaveAtLeast
(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreNotAtLeast(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs).<E> void
assertDoNotHaveAtMost
(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreNotAtMost(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs).<E> void
assertDoNotHaveExactly
(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreNotExactly(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs).void
assertEmpty
(AssertionInfo info, Object[] actual) Asserts that the given array is empty.void
assertEndsWith
(AssertionInfo info, Object[] actual, Object[] sequence) Verifies that the given array ends with the given sequence of objects, without any other objects between them.void
assertHasSameSizeAs
(AssertionInfo info, Object[] actual, Iterable<?> other) Assert that the actual array has the same size as the otherIterable
.void
assertHasSameSizeAs
(AssertionInfo info, Object[] actual, Object[] other) Assert that the actual array has the same size as the other array.void
assertHasSize
(AssertionInfo info, Object[] actual, int expectedSize) Asserts that the number of elements in the given array is equal to the expected one.<E> void
assertHave
(AssertionInfo info, E[] actual, Condition<? super E> condition) Assert that each element of given array satisfies the given condition.<E> void
assertHaveAtLeast
(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreAtLeast(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs).<E> void
assertHaveAtMost
(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreAtMost(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs).<E> void
assertHaveExactly
(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreExactly(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs).void
assertIsSorted
(AssertionInfo info, Object[] actual) Concrete implementation ofArraySortedAssert.isSorted()
.<E> void
assertIsSortedAccordingToComparator
(AssertionInfo info, E[] actual, Comparator<? super E> comparator) Concrete implementation ofArraySortedAssert.isSortedAccordingTo(Comparator)
.void
assertNotEmpty
(AssertionInfo info, Object[] actual) Asserts that the given array is not empty.void
assertNullOrEmpty
(AssertionInfo info, Object[] actual) Asserts that the given array isnull
or empty.void
assertStartsWith
(AssertionInfo info, Object[] actual, Object[] sequence) Verifies that the given array starts with the given sequence of objects, without any other objects between them.Comparator
<?> static ObjectArrays
instance()
Returns the singleton instance of this class.
-
Constructor Details
-
ObjectArrays
-
-
Method Details
-
instance
Returns the singleton instance of this class.- Returns:
- the singleton instance of this class.
-
getComparator
-
assertNullOrEmpty
Asserts that the given array isnull
or empty.- Parameters:
info
- contains information about the assertion.actual
- the given array.- Throws:
AssertionError
- if the given array is notnull
*and* contains one or more elements.
-
assertEmpty
Asserts that the given array is empty.- Parameters:
info
- contains information about the assertion.actual
- the given array.- Throws:
AssertionError
- if the given array isnull
.AssertionError
- if the given array is not empty.
-
assertNotEmpty
Asserts that the given array is not empty.- Parameters:
info
- contains information about the assertion.actual
- the given array.- Throws:
AssertionError
- if the given array isnull
.AssertionError
- if the given array is empty.
-
assertHasSize
Asserts that the number of elements in the given array is equal to the expected one.- Parameters:
info
- contains information about the assertion.actual
- the given array.expectedSize
- the expected size ofactual
.- Throws:
AssertionError
- if the given array isnull
.AssertionError
- if the number of elements in the given array is different than the expected one.
-
assertHasSameSizeAs
Assert that the actual array has the same size as the otherIterable
.- Parameters:
info
- contains information about the assertion.actual
- the given iterable.other
- the group to compare- Throws:
AssertionError
- if the actual group isnull
.AssertionError
- if the other group isnull
.AssertionError
- if the actual group does not have the same size.
-
assertHasSameSizeAs
Assert that the actual array has the same size as the other array.- Parameters:
info
- contains information about the assertion.actual
- the given array.other
- the group to compare- Throws:
AssertionError
- if the actual group isnull
.AssertionError
- if the other group isnull
.AssertionError
- if the actual group does not have the same size.
-
assertContains
Asserts that the given array contains the given values, in any order.- Parameters:
info
- contains information about the assertion.actual
- the given array.values
- the values that are expected to be in the given array.- Throws:
NullPointerException
- if the array of values isnull
.IllegalArgumentException
- if the array of values is empty.AssertionError
- if the given array isnull
.AssertionError
- if the given array does not contain the given values.
-
assertContains
Verifies that the given array contains the given object at the given index.- Parameters:
info
- contains information about the assertion.actual
- the given array.value
- the object to look for.index
- the index where the object should be stored in the given array.- Throws:
AssertionError
- if the given array isnull
or empty.NullPointerException
- if the givenIndex
isnull
.IndexOutOfBoundsException
- if the value of the givenIndex
is equal to or greater than the size of the given array.AssertionError
- if the given array does not contain the given object at the given index.
-
assertDoesNotContain
Verifies that the given array does not contain the given object at the given index.- Parameters:
info
- contains information about the assertion.actual
- the given array.value
- the object to look for.index
- the index where the object should be stored in the given array.- Throws:
AssertionError
- if the given array isnull
.NullPointerException
- if the givenIndex
isnull
.AssertionError
- if the given array contains the given object at the given index.
-
assertContainsOnly
Asserts that the given array contains only the given values and nothing else, in any order.- Parameters:
info
- contains information about the assertion.actual
- the given array.values
- the values that are expected to be in the given array.- Throws:
NullPointerException
- if the array of values isnull
.IllegalArgumentException
- if the array of values is empty.AssertionError
- if the given array isnull
.AssertionError
- if the given array does not contain the given values or if the given array contains values that are not in the given array.
-
assertContainsSequence
Verifies that the given array contains the given sequence of objects, without any other objects between them.- Parameters:
info
- contains information about the assertion.actual
- the given array.sequence
- the sequence of objects to look for.- Throws:
AssertionError
- if the given array isnull
.NullPointerException
- if the given sequence isnull
.IllegalArgumentException
- if the given sequence is empty.AssertionError
- if the given array does not contain the given sequence of objects.
-
assertDoesNotContain
Asserts that the given array does not contain the given values.- Parameters:
info
- contains information about the assertion.actual
- the given array.values
- the values that are expected not to be in the given array.- Throws:
NullPointerException
- if the array of values isnull
.IllegalArgumentException
- if the array of values is empty.AssertionError
- if the given array isnull
.AssertionError
- if the given array contains any of given values.
-
assertDoesNotHaveDuplicates
Asserts that the given array does not have duplicate values.- Parameters:
info
- contains information about the assertion.actual
- the given array.- Throws:
NullPointerException
- if the array of values isnull
.IllegalArgumentException
- if the array of values is empty.AssertionError
- if the given array isnull
.AssertionError
- if the given array contains duplicate values.
-
assertStartsWith
Verifies that the given array starts with the given sequence of objects, without any other objects between them. Similar to
, but it also verifies that the first element in the sequence is also the first element of the given array.assertContainsSequence(AssertionInfo, Object[], Object[])
- Parameters:
info
- contains information about the assertion.actual
- the given array.sequence
- the sequence of objects to look for.- Throws:
NullPointerException
- if the given argument isnull
.IllegalArgumentException
- if the given argument is an empty array.AssertionError
- if the given array isnull
.AssertionError
- if the given array does not start with the given sequence of objects.
-
assertEndsWith
Verifies that the given array ends with the given sequence of objects, without any other objects between them. Similar to
, but it also verifies that the last element in the sequence is also the last element of the given array.assertContainsSequence(AssertionInfo, Object[], Object[])
- Parameters:
info
- contains information about the assertion.actual
- the given array.sequence
- the sequence of objects to look for.- Throws:
NullPointerException
- if the given argument isnull
.IllegalArgumentException
- if the given argument is an empty array.AssertionError
- if the given array isnull
.AssertionError
- if the given array does not end with the given sequence of objects.
-
assertContainsNull
Asserts that the given array contains at least a null element.- Parameters:
info
- contains information about the assertion.actual
- the given array.- Throws:
AssertionError
- if the given array isnull
.AssertionError
- if the given array does not contain a null element.
-
assertDoesNotContainNull
Asserts that the given array does not contain null elements.- Parameters:
info
- contains information about the assertion.actual
- the given array.- Throws:
AssertionError
- if the given array isnull
.AssertionError
- if the given array contains a null element.
-
assertAre
Assert that each element of given array satisfies the given condition.- Parameters:
info
- contains information about the assertion.actual
- the given array.condition
- the givenCondition
.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if one or more element not satisfy the given condition.
-
assertAreNot
Assert that each element of given array not satisfies the given condition.- Parameters:
info
- contains information about the assertion.actual
- the given array.condition
- the givenCondition
.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if one or more element satisfy the given condition.
-
assertHave
Assert that each element of given array satisfies the given condition.- Parameters:
info
- contains information about the assertion.actual
- the given array.condition
- the givenCondition
.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if one or more element not satisfy the given condition.
-
assertDoNotHave
Assert that each element of given array not satisfies the given condition.- Parameters:
info
- contains information about the assertion.actual
- the given array.condition
- the givenCondition
.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if one or more element satisfy the given condition.
-
assertAreAtLeast
public <E> void assertAreAtLeast(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Assert that there is at least n array elements satisfying the given condition.- Parameters:
info
- contains information about the assertion.actual
- the given array.n
- the minimum number of times the condition should be verified.condition
- the givenCondition
.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if the number of elements satisfying the given condition is < n.
-
assertAreNotAtLeast
public <E> void assertAreNotAtLeast(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Assert that there is at least n array elements not satisfying the given condition.- Parameters:
info
- contains information about the assertion.actual
- the given array.n
- the number of times the condition should not be verified at least.condition
- the givenCondition
.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if the number of elements not satisfying the given condition is < n.
-
assertAreAtMost
public <E> void assertAreAtMost(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Assert that there is at most n array elements satisfying the given condition.- Parameters:
info
- contains information about the assertion.actual
- the given array.n
- the number of times the condition should be at most verified.condition
- the givenCondition
.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if the number of elements satisfying the given condition is > n.
-
assertAreNotAtMost
public <E> void assertAreNotAtMost(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Verifies that there is at most n array elements not satisfying the given condition.- Parameters:
info
- contains information about the assertion.actual
- the given array.n
- the number of times the condition should not be verified at most.condition
- the givenCondition
.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if the number of elements not satisfying the given condition is > n.
-
assertAreExactly
public <E> void assertAreExactly(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Verifies that there is exactly n array elements satisfying the given condition.- Parameters:
info
- contains information about the assertion.actual
- the given array.n
- the exact number of times the condition should be verified.condition
- the givenCondition
.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if the number of elements satisfying the given condition is ≠ n.
-
assertAreNotExactly
public <E> void assertAreNotExactly(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Verifies that there is exactly n elements in the actualIterable
not satisfying the given condition.- Parameters:
info
- contains information about the assertion.actual
- the given array.n
- most times the condition should not be verify.condition
- the givenCondition
.- Throws:
NullPointerException
- if the given condition isnull
.AssertionError
- if the number of elements not satisfying the given condition is ≠ n.
-
assertHaveAtLeast
public <E> void assertHaveAtLeast(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreAtLeast(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs). -
assertDoNotHaveAtLeast
public <E> void assertDoNotHaveAtLeast(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreNotAtLeast(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs). -
assertHaveAtMost
public <E> void assertHaveAtMost(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreAtMost(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs). -
assertDoNotHaveAtMost
public <E> void assertDoNotHaveAtMost(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreNotAtMost(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs). -
assertHaveExactly
public <E> void assertHaveExactly(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreExactly(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs). -
assertDoNotHaveExactly
public <E> void assertDoNotHaveExactly(AssertionInfo info, E[] actual, int times, Condition<? super E> condition) An alias method ofassertAreNotExactly(AssertionInfo, Object[], int, Condition)
to provide a richer fluent api (same logic, only error message differs). -
assertIsSorted
Concrete implementation ofArraySortedAssert.isSorted()
.- Parameters:
info
- contains information about the assertion.actual
- the given array.
-
assertIsSortedAccordingToComparator
public <E> void assertIsSortedAccordingToComparator(AssertionInfo info, E[] actual, Comparator<? super E> comparator) Concrete implementation ofArraySortedAssert.isSortedAccordingTo(Comparator)
.- Parameters:
info
- contains information about the assertion.actual
- the given array.comparator
- theComparator
used to compare array elements
-
assertContainsAll
Asserts that the given array contains all the elements of the givenIterable
, in any order.- Parameters:
info
- contains information about the assertion.actual
- the given array.other
- the otherIterable
.- Throws:
NullPointerException
- ifIterable
isnull
.AssertionError
- if the givenIterable
isnull
.AssertionError
- if the givenIterable
does not contain all the elements of the otherIterable
, in any order.
-