Package org.assertj.core.internal
Class ObjectArrays
java.lang.Object
org.assertj.core.internal.ObjectArrays
Reusable assertions for arrays of objects.
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate Arrays
(package private) Conditions
(package private) Failures
private static final ObjectArrays
-
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 are 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 are 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 are 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.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
assertContainsAnyOf
(AssertionInfo info, Object[] actual, Object[] values) void
assertContainsExactly
(AssertionInfo info, Object[] actual, Object[] values) void
assertContainsExactlyInAnyOrder
(AssertionInfo info, Object[] actual, Object[] values) 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
assertContainsOnlyNulls
(AssertionInfo info, Object[] actual) Asserts that the given array contains only null elements.void
assertContainsOnlyOnce
(AssertionInfo info, Object[] actual, Object[] values) Asserts that the given array contains only once the given values.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
assertContainsSubsequence
(AssertionInfo info, Object[] actual, Object[] subsequence) Verifies that the given array contains the given subsequence of objects (possibly with other values 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.<T> void
assertDoesNotContainAnyElementsOf
(AssertionInfo info, Object[] actual, Iterable<? extends T> iterable) void
assertDoesNotContainNull
(AssertionInfo info, Object[] actual) Asserts that the given array does not contain null elements.void
assertDoesNotContainSequence
(AssertionInfo info, Object[] actual, Object[] sequence) Verifies that the given array does not contain the given sequence of objects in order.void
assertDoesNotContainSubsequence
(AssertionInfo info, Object[] actual, Object[] subsequence) Verifies that the given array does not contain the given subsequence of objects (possibly with other values between them).<E> void
assertDoesNotHaveAnyElementsOfTypes
(AssertionInfo info, E[] actual, Class<?>... unexpectedTypes) 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.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
assertEndsWith
(AssertionInfo info, Object[] actual, Object first, Object[] rest) Verifies that the given array ends with the given sequence of objects, without any other objects between them.<E> void
assertHasAtLeastOneElementOfType
(AssertionInfo info, E[] actual, Class<?> type) <E> void
assertHasExactlyElementsOfTypes
(AssertionInfo info, E[] actual, Class<?>... expectedTypes) <E> void
assertHasOnlyElementsOfType
(AssertionInfo info, E[] actual, Class<?> type) <E> void
assertHasOnlyElementsOfTypes
(AssertionInfo info, E[] actual, Class<?>... types) 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.void
assertHasSizeBetween
(AssertionInfo info, Object[] actual, int lowerBoundary, int higherBoundary) Asserts that the number of elements in the given array is between the given lower and higher boundary (inclusive).void
assertHasSizeGreaterThan
(AssertionInfo info, Object[] actual, int boundary) Asserts that the number of elements in the given array is greater than the given boundary.void
assertHasSizeGreaterThanOrEqualTo
(AssertionInfo info, Object[] actual, int boundary) Asserts that the number of elements in the given array is greater than or equal to the given boundary.void
assertHasSizeLessThan
(AssertionInfo info, Object[] actual, int boundary) Asserts that the number of elements in the given array is less than the given boundary.void
assertHasSizeLessThanOrEqualTo
(AssertionInfo info, Object[] actual, int boundary) Asserts that the number of elements in the given array is less than or equal to the given boundary.<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
assertIsSubsetOf
(AssertionInfo info, Object actual, Iterable<?> values) 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.(package private) void
-
Field Details
-
INSTANCE
-
arrays
-
failures
Failures failures -
conditions
Conditions conditions
-
-
Constructor Details
-
ObjectArrays
ObjectArrays() -
ObjectArrays
-
-
Method Details
-
instance
Returns the singleton instance of this class.- Returns:
- the singleton instance of this class.
-
setArrays
-
getComparator
-
getComparisonStrategy
-
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.
-
assertHasSizeGreaterThan
Asserts that the number of elements in the given array is greater than the given boundary.- Parameters:
info
- contains information about the assertion.actual
- the given array.boundary
- the given value to compare the size ofactual
to.- Throws:
AssertionError
- if the given array isnull
.AssertionError
- if the number of elements in the given array is not greater than the boundary.
-
assertHasSizeGreaterThanOrEqualTo
Asserts that the number of elements in the given array is greater than or equal to the given boundary.- Parameters:
info
- contains information about the assertion.actual
- the given array.boundary
- the given value to compare the size ofactual
to.- Throws:
AssertionError
- if the given array isnull
.AssertionError
- if the number of elements in the given array is not greater than or equal to the boundary.
-
assertHasSizeLessThan
Asserts that the number of elements in the given array is less than the given boundary.- Parameters:
info
- contains information about the assertion.actual
- the given array.boundary
- the given value to compare the size ofactual
to.- Throws:
AssertionError
- if the given array isnull
.AssertionError
- if the number of elements in the given array is not less than the boundary.
-
assertHasSizeLessThanOrEqualTo
Asserts that the number of elements in the given array is less than or equal to the given boundary.- Parameters:
info
- contains information about the assertion.actual
- the given array.boundary
- the given value to compare the size ofactual
to.- Throws:
AssertionError
- if the given array isnull
.AssertionError
- if the number of elements in the given array is not less than or equal to the boundary.
-
assertHasSizeBetween
public void assertHasSizeBetween(AssertionInfo info, Object[] actual, int lowerBoundary, int higherBoundary) Asserts that the number of elements in the given array is between the given lower and higher boundary (inclusive).- Parameters:
info
- contains information about the assertion.actual
- the given array.lowerBoundary
- the lower boundary compared to which actual size should be greater than or equal to.higherBoundary
- the higher boundary compared to which actual size should be less than or equal to.- Throws:
AssertionError
- if the given array isnull
.AssertionError
- if the number of elements in the given array is not between the boundaries.
-
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.
-
assertContainsExactly
-
assertContainsExactlyInAnyOrder
-
assertContainsOnlyOnce
Asserts that the given array contains only once the given values.- 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.
-
assertContainsOnlyNulls
Asserts that the given array contains only null elements.- Parameters:
info
- contains information about the assertionactual
- the given array- Throws:
AssertionError
- if the given array isnull
.AssertionError
- if the given array does not contain at least a null element or contains values that are not null elements.
-
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.
-
assertDoesNotContainSequence
Verifies that the given array does not contain the given sequence of objects in order.- 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 contain the given sequence of objects in order.
-
assertContainsSubsequence
Verifies that the given array contains the given subsequence of objects (possibly with other values between them).- Parameters:
info
- contains information about the assertion.actual
- the given array.subsequence
- the subsequence of objects to look for.- Throws:
AssertionError
- if the given array isnull
.NullPointerException
- if the given subsequence isnull
.IllegalArgumentException
- if the given subsequence is empty.AssertionError
- if the given array does not contain the given subsequence of objects.
-
assertDoesNotContainSubsequence
public void assertDoesNotContainSubsequence(AssertionInfo info, Object[] actual, Object[] subsequence) Verifies that the given array does not contain the given subsequence of objects (possibly with other values between them).- Parameters:
info
- contains information about the assertion.actual
- the given array.subsequence
- the subsequence of objects to look for.- Throws:
AssertionError
- if the given array isnull
.NullPointerException
- if the given subsequence isnull
.IllegalArgumentException
- if the given subsequence is empty.AssertionError
- if the given array contains the given subsequence 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.
-
assertDoesNotContainAnyElementsOf
public <T> void assertDoesNotContainAnyElementsOf(AssertionInfo info, Object[] actual, Iterable<? extends T> iterable) -
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.first
- the first element of the end sequence of objects to look for.rest
- the rest of the end sequence of objects to look for.- Throws:
NullPointerException
- if the given argument isnull
.AssertionError
- if the given array isnull
.AssertionError
- if the given array does not end 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
.AssertionError
- if the given array isnull
.AssertionError
- if the given array does not end with the given sequence of objects.
-
assertIsSubsetOf
-
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.- Type Parameters:
E
- element type- 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 elements do not satisfy the given condition.
-
assertAreNot
Assert that each element of given array not satisfies the given condition.- Type Parameters:
E
- element type- 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 elements satisfy the given condition.
-
assertHave
Assert that each element of given array satisfies the given condition.- Type Parameters:
E
- element type- 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 elements do not satisfy the given condition.
-
assertDoNotHave
Assert that each element of given array not satisfies the given condition.- Type Parameters:
E
- element type- 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 elements satisfy the given condition.
-
assertAreAtLeast
public <E> void assertAreAtLeast(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Assert that there are at least n array elements satisfying the given condition.- Type Parameters:
E
- element type- 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.
-
assertAreAtMost
public <E> void assertAreAtMost(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Assert that there are at most n array elements satisfying the given condition.- Type Parameters:
E
- element type- 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.
-
assertAreExactly
public <E> void assertAreExactly(AssertionInfo info, E[] actual, int n, Condition<? super E> condition) Verifies that there are exactly n array elements satisfying the given condition.- Type Parameters:
E
- element type- 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.
-
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).- Type Parameters:
E
- element type- Parameters:
info
- contains information about the assertion.actual
- the given array.times
- 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.
-
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).- Type Parameters:
E
- element type- Parameters:
info
- contains information about the assertion.actual
- the given array.times
- 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.
-
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).- Type Parameters:
E
- element type- Parameters:
info
- contains information about the assertion.actual
- the given array.times
- 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.
-
assertHasAtLeastOneElementOfType
-
assertHasOnlyElementsOfType
-
assertHasOnlyElementsOfTypes
-
assertHasExactlyElementsOfTypes
public <E> void assertHasExactlyElementsOfTypes(AssertionInfo info, E[] actual, Class<?>... expectedTypes) -
assertDoesNotHaveAnyElementsOfTypes
public <E> void assertDoesNotHaveAnyElementsOfTypes(AssertionInfo info, E[] actual, Class<?>... unexpectedTypes) -
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)
.- Type Parameters:
E
- element type- 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.- Type Parameters:
E
- element type- 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.
-
assertContainsAnyOf
-