Package org.assertj.core.internal
Class Objects
- java.lang.Object
-
- org.assertj.core.internal.Objects
-
public class Objects extends Object
Reusable assertions forObject
s.- Author:
- Yvonne Wang, Alex Ruiz, Nicolas François, Mikhail Mazursky
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Objects.ByFieldsComparison
-
Constructor Summary
Constructors Constructor Description Objects(ComparisonStrategy comparisonStrategy)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
areEqualToComparingOnlyGivenFields(Object actual, Object other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType, String... fields)
boolean
areEqualToIgnoringGivenFields(Object actual, Object other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType, String... fields)
void
assertDoesNotHaveSameClassAs(AssertionInfo info, Object actual, Object other)
Verifies that the actual value does not have the same class as the given object.void
assertEqual(AssertionInfo info, Object actual, Object expected)
Asserts that two objects are equal.<A> void
assertHasFieldOrProperty(AssertionInfo info, A actual, String name)
<A> void
assertHasFieldOrPropertyWithValue(AssertionInfo info, A actual, String name, Object expectedValue)
<A> void
assertHasNoNullFieldsOrPropertiesExcept(AssertionInfo info, A actual, String... propertiesOrFieldsToIgnore)
Assert that the given object has no null fields except the given ones.void
assertHasSameClassAs(AssertionInfo info, Object actual, Object other)
Verifies that the actual value has the same class as the given object.void
assertHasToString(AssertionInfo info, Object actual, String expectedToString)
<A> void
assertIsEqualToComparingFieldByFieldRecursively(AssertionInfo info, Object actual, Object other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType)
Assert that the given object is "deeply" equals to other by comparing all fields recursively.<A> void
assertIsEqualToComparingOnlyGivenFields(AssertionInfo info, A actual, A other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType, String... fields)
Assert that the given object is lenient equals to other object by comparing given fields value only.<A> void
assertIsEqualToIgnoringGivenFields(AssertionInfo info, A actual, A other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType, String... fields)
Assert that the given object is lenient equals to the other by comparing all fields (including inherited fields) unless given ignored ones.<A> void
assertIsEqualToIgnoringNullFields(AssertionInfo info, A actual, A other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType)
Assert that the given object is lenient equals by ignoring null fields value on other object (including inherited fields).void
assertIsExactlyInstanceOf(AssertionInfo info, Object actual, Class<?> type)
Verifies that the actual value is exactly an instance of given type.void
assertIsIn(AssertionInfo info, Object actual, Iterable<?> values)
Asserts that the given object is present in the given collection.void
assertIsIn(AssertionInfo info, Object actual, Object[] values)
Asserts that the given object is present in the given array.void
assertIsInstanceOf(AssertionInfo info, Object actual, Class<?> type)
Verifies that the given object is an instance of the given type.void
assertIsInstanceOfAny(AssertionInfo info, Object actual, Class<?>[] types)
Verifies that the given object is an instance of any of the given types.void
assertIsNotExactlyInstanceOf(AssertionInfo info, Object actual, Class<?> type)
Verifies that the actual value is not exactly an instance of given type.void
assertIsNotIn(AssertionInfo info, Object actual, Iterable<?> values)
Asserts that the given object is not present in the given collection.void
assertIsNotIn(AssertionInfo info, Object actual, Object[] values)
Asserts that the given object is not present in the given array.void
assertIsNotInstanceOf(AssertionInfo info, Object actual, Class<?> type)
Verifies that the given object is not an instance of the given type.void
assertIsNotInstanceOfAny(AssertionInfo info, Object actual, Class<?>[] types)
Verifies that the given object is not an instance of any of the given types.void
assertIsNotOfAnyClassIn(AssertionInfo info, Object actual, Class<?>[] types)
Verifies that the actual value type is not in given types.void
assertIsOfAnyClassIn(AssertionInfo info, Object actual, Class<?>[] types)
Verifies that the actual value type is in given types.void
assertNotEqual(AssertionInfo info, Object actual, Object other)
Asserts that two objects are not equal.void
assertNotNull(AssertionInfo info, Object actual)
Asserts that the given object is notnull
.void
assertNotSame(AssertionInfo info, Object actual, Object other)
Asserts that two objects do not refer to the same object.void
assertNull(AssertionInfo info, Object actual)
Asserts that the given object isnull
.void
assertSame(AssertionInfo info, Object actual, Object expected)
Asserts that two objects refer to the same object.Comparator<?>
getComparator()
ComparisonStrategy
getComparisonStrategy()
static Set<Field>
getDeclaredFieldsIncludingInherited(Class<?> clazz)
Returns the declared fields of given class and its superclasses stopping at superclass injava.lang
package whose fields are not included.static Objects
instance()
Returns the singleton instance of this class based onStandardComparisonStrategy
.
-
-
-
Constructor Detail
-
Objects
public Objects(ComparisonStrategy comparisonStrategy)
-
-
Method Detail
-
instance
public static Objects instance()
Returns the singleton instance of this class based onStandardComparisonStrategy
.- Returns:
- the singleton instance of this class based on
StandardComparisonStrategy
.
-
getComparator
public Comparator<?> getComparator()
-
getComparisonStrategy
public ComparisonStrategy getComparisonStrategy()
-
assertIsInstanceOf
public void assertIsInstanceOf(AssertionInfo info, Object actual, Class<?> type)
Verifies that the given object is an instance of the given type.- Parameters:
info
- contains information about the assertion.actual
- the given object.type
- the type to check the given object against.- Throws:
NullPointerException
- if the given type isnull
.AssertionError
- if the given object isnull
.AssertionError
- if the given object is not an instance of the given type.
-
assertIsInstanceOfAny
public void assertIsInstanceOfAny(AssertionInfo info, Object actual, Class<?>[] types)
Verifies that the given object is an instance of any of the given types.- Parameters:
info
- contains information about the assertion.actual
- the given object.types
- the types to check the given object against.- Throws:
NullPointerException
- if the given array isnull
.IllegalArgumentException
- if the given array is empty.NullPointerException
- if the given array hasnull
elements.AssertionError
- if the given object isnull
.AssertionError
- if the given object is not an instance of any of the given types.
-
assertIsNotInstanceOf
public void assertIsNotInstanceOf(AssertionInfo info, Object actual, Class<?> type)
Verifies that the given object is not an instance of the given type.- Parameters:
info
- contains information about the assertion.actual
- the given object.type
- the type to check the given object against.- Throws:
NullPointerException
- if the given type isnull
.AssertionError
- if the given object isnull
.AssertionError
- if the given object is an instance of the given type.
-
assertIsNotInstanceOfAny
public void assertIsNotInstanceOfAny(AssertionInfo info, Object actual, Class<?>[] types)
Verifies that the given object is not an instance of any of the given types.- Parameters:
info
- contains information about the assertion.actual
- the given object.types
- the types to check the given object against.- Throws:
NullPointerException
- if the given array isnull
.IllegalArgumentException
- if the given array is empty.NullPointerException
- if the given array hasnull
elements.AssertionError
- if the given object isnull
.AssertionError
- if the given object is an instance of any of the given types.
-
assertHasSameClassAs
public void assertHasSameClassAs(AssertionInfo info, Object actual, Object other)
Verifies that the actual value has the same class as the given object.- Parameters:
info
- contains information about the assertion.actual
- the given object.- Throws:
AssertionError
- if the actual has not the same type has the given object.NullPointerException
- if the actual value is null.NullPointerException
- if the given object is null.
-
assertDoesNotHaveSameClassAs
public void assertDoesNotHaveSameClassAs(AssertionInfo info, Object actual, Object other)
Verifies that the actual value does not have the same class as the given object.- Parameters:
info
- contains information about the assertion.actual
- the given object.other
- the object to check type against.- Throws:
AssertionError
- if the actual has the same type has the given object.NullPointerException
- if the actual value is null.NullPointerException
- if the given object is null.
-
assertIsExactlyInstanceOf
public void assertIsExactlyInstanceOf(AssertionInfo info, Object actual, Class<?> type)
Verifies that the actual value is exactly an instance of given type.- Parameters:
info
- contains information about the assertion.actual
- the given object.type
- the type to check the actual value against.- Throws:
AssertionError
- if the actual is not exactly an instance of given type.NullPointerException
- if the actual value is null.NullPointerException
- if the given object is null.
-
assertIsNotExactlyInstanceOf
public void assertIsNotExactlyInstanceOf(AssertionInfo info, Object actual, Class<?> type)
Verifies that the actual value is not exactly an instance of given type.- Parameters:
info
- contains information about the assertion.actual
- the given object.type
- the type to check the actual value against.- Throws:
AssertionError
- if the actual is exactly an instance of given type.NullPointerException
- if the actual value is null.NullPointerException
- if the given object is null.
-
assertIsOfAnyClassIn
public void assertIsOfAnyClassIn(AssertionInfo info, Object actual, Class<?>[] types)
Verifies that the actual value type is in given types.- Parameters:
info
- contains information about the assertion.actual
- the given object.types
- the types to check the actual value against.- Throws:
AssertionError
- if the actual value type is in given type.NullPointerException
- if the actual value is null.NullPointerException
- if the given types is null.
-
assertIsNotOfAnyClassIn
public void assertIsNotOfAnyClassIn(AssertionInfo info, Object actual, Class<?>[] types)
Verifies that the actual value type is not in given types.- Parameters:
info
- contains information about the assertion.actual
- the given object.types
- the types to check the actual value against.- Throws:
AssertionError
- if the actual value type is in given type.NullPointerException
- if the actual value is null.NullPointerException
- if the given types is null.
-
assertEqual
public void assertEqual(AssertionInfo info, Object actual, Object expected)
Asserts that two objects are equal.- Parameters:
info
- contains information about the assertion.actual
- the "actual" object.expected
- the "expected" object.- Throws:
AssertionError
- ifactual
is not equal toexpected
. This method will throw aorg.junit.ComparisonFailure
instead if JUnit is in the classpath and the given objects are not equal.
-
assertNotEqual
public void assertNotEqual(AssertionInfo info, Object actual, Object other)
Asserts that two objects are not equal.- Parameters:
info
- contains information about the assertion.actual
- the given object.other
- the object to compareactual
to.- Throws:
AssertionError
- ifactual
is equal toother
.
-
assertNull
public void assertNull(AssertionInfo info, Object actual)
Asserts that the given object isnull
.- Parameters:
info
- contains information about the assertion.actual
- the given object.- Throws:
AssertionError
- if the given object is notnull
.
-
assertNotNull
public void assertNotNull(AssertionInfo info, Object actual)
Asserts that the given object is notnull
.- Parameters:
info
- contains information about the assertion.actual
- the given object.- Throws:
AssertionError
- if the given object isnull
.
-
assertSame
public void assertSame(AssertionInfo info, Object actual, Object expected)
Asserts that two objects refer to the same object.- Parameters:
info
- contains information about the assertion.actual
- the given object.expected
- the expected object.- Throws:
AssertionError
- if the given objects do not refer to the same object.
-
assertNotSame
public void assertNotSame(AssertionInfo info, Object actual, Object other)
Asserts that two objects do not refer to the same object.- Parameters:
info
- contains information about the assertion.actual
- the given object.other
- the object to compareactual
to.- Throws:
AssertionError
- if the given objects refer to the same object.
-
assertHasToString
public void assertHasToString(AssertionInfo info, Object actual, String expectedToString)
-
assertIsIn
public void assertIsIn(AssertionInfo info, Object actual, Object[] values)
Asserts that the given object is present in the given array.- Parameters:
info
- contains information about the assertion.actual
- the given object.values
- the given array.- Throws:
NullPointerException
- if the given array isnull
.IllegalArgumentException
- if the given array is empty.AssertionError
- if the given object is not present in the given array.
-
assertIsNotIn
public void assertIsNotIn(AssertionInfo info, Object actual, Object[] values)
Asserts that the given object is not present in the given array.- Parameters:
info
- contains information about the assertion.actual
- the given object.values
- the given array.- Throws:
NullPointerException
- if the given array isnull
.IllegalArgumentException
- if the given array is empty.AssertionError
- if the given object is present in the given array.
-
assertIsIn
public void assertIsIn(AssertionInfo info, Object actual, Iterable<?> values)
Asserts that the given object is present in the given collection.- Parameters:
info
- contains information about the assertion.actual
- the given object.values
- the given iterable.- Throws:
NullPointerException
- if the given collection isnull
.IllegalArgumentException
- if the given collection is empty.AssertionError
- if the given object is not present in the given collection.
-
assertIsNotIn
public void assertIsNotIn(AssertionInfo info, Object actual, Iterable<?> values)
Asserts that the given object is not present in the given collection.- Parameters:
info
- contains information about the assertion.actual
- the given object.values
- the given collection.- Throws:
NullPointerException
- if the given iterable isnull
.IllegalArgumentException
- if the given collection is empty.AssertionError
- if the given object is present in the given collection.
-
assertIsEqualToIgnoringNullFields
public <A> void assertIsEqualToIgnoringNullFields(AssertionInfo info, A actual, A other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType)
Assert that the given object is lenient equals by ignoring null fields value on other object (including inherited fields).- Parameters:
info
- contains information about the assertion.actual
- the given object.other
- the object to compareactual
to.- Throws:
NullPointerException
- if the actual type isnull
.NullPointerException
- if the other type isnull
.AssertionError
- if the actual and the given object are not lenient equals.AssertionError
- if the other object is not an instance of the actual type.
-
assertIsEqualToComparingOnlyGivenFields
public <A> void assertIsEqualToComparingOnlyGivenFields(AssertionInfo info, A actual, A other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType, String... fields)
Assert that the given object is lenient equals to other object by comparing given fields value only.- Parameters:
info
- contains information about the assertion.actual
- the given object.other
- the object to compareactual
to.fields
- accepted fields- Throws:
NullPointerException
- if the other type isnull
.AssertionError
- if actual isnull
.AssertionError
- if the actual and the given object are not lenient equals.AssertionError
- if the other object is not an instance of the actual type.IntrospectionError
- if a field does not exist in actual.
-
assertIsEqualToIgnoringGivenFields
public <A> void assertIsEqualToIgnoringGivenFields(AssertionInfo info, A actual, A other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType, String... fields)
Assert that the given object is lenient equals to the other by comparing all fields (including inherited fields) unless given ignored ones.- Parameters:
info
- contains information about the assertion.actual
- the given object.other
- the object to compareactual
to.fields
- the fields to ignore in comparison- Throws:
NullPointerException
- if the other type isnull
.AssertionError
- if actual isnull
.AssertionError
- if the actual and the given object are not lenient equals.AssertionError
- if the other object is not an instance of the actual type.
-
assertHasNoNullFieldsOrPropertiesExcept
public <A> void assertHasNoNullFieldsOrPropertiesExcept(AssertionInfo info, A actual, String... propertiesOrFieldsToIgnore)
Assert that the given object has no null fields except the given ones.- Parameters:
info
- contains information about the assertion.actual
- the given object.propertiesOrFieldsToIgnore
- the fields to ignore in comparison- Throws:
AssertionError
- if actual isnull
.AssertionError
- if some of the fields of the actual object are null.
-
assertIsEqualToComparingFieldByFieldRecursively
public <A> void assertIsEqualToComparingFieldByFieldRecursively(AssertionInfo info, Object actual, Object other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType)
Assert that the given object is "deeply" equals to other by comparing all fields recursively.- Parameters:
info
- contains information about the assertion.actual
- the given object.other
- the object to compareactual
to.- Throws:
AssertionError
- if actual isnull
.AssertionError
- if the actual and the given object are not "deeply" equal.
-
getDeclaredFieldsIncludingInherited
public static Set<Field> getDeclaredFieldsIncludingInherited(Class<?> clazz)
Returns the declared fields of given class and its superclasses stopping at superclass injava.lang
package whose fields are not included.- Parameters:
clazz
- the class we want the declared fields.- Returns:
- the declared fields of given class and its superclasses.
-
areEqualToIgnoringGivenFields
public boolean areEqualToIgnoringGivenFields(Object actual, Object other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType, String... fields)
-
areEqualToComparingOnlyGivenFields
public boolean areEqualToComparingOnlyGivenFields(Object actual, Object other, Map<String,Comparator<?>> comparatorByPropertyOrField, TypeComparators comparatorByType, String... fields)
-
assertHasFieldOrProperty
public <A> void assertHasFieldOrProperty(AssertionInfo info, A actual, String name)
-
assertHasFieldOrPropertyWithValue
public <A> void assertHasFieldOrPropertyWithValue(AssertionInfo info, A actual, String name, Object expectedValue)
-
-