Class Objects

java.lang.Object
org.fest.assertions.internal.Objects

public class Objects extends Object
Reusable assertions for Objects.
Author:
Yvonne Wang, Alex Ruiz, Nicolas François, Mikhail Mazursky
  • Constructor Details

  • Method Details

    • instance

      public static Objects instance()
      Returns the singleton instance of this class based on StandardComparisonStrategy.
      Returns:
      the singleton instance of this class based on StandardComparisonStrategy.
    • getComparator

      public Comparator<?> getComparator()
    • 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 is null.
      AssertionError - if the given object is null.
      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 is null.
      IllegalArgumentException - if the given array is empty.
      NullPointerException - if the given array has null elements.
      AssertionError - if the given object is null.
      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 is null.
      AssertionError - if the given object is null.
      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 is null.
      IllegalArgumentException - if the given array is empty.
      NullPointerException - if the given array has null elements.
      AssertionError - if the given object is null.
      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 a 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 a 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 a 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 a 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 - if actual is not equal to expected. This method will throw a org.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 compare actual to.
      Throws:
      AssertionError - if actual is equal to other.
    • assertNull

      public void assertNull(AssertionInfo info, Object actual)
      Asserts that the given object is null.
      Parameters:
      info - contains information about the assertion.
      actual - the given object.
      Throws:
      AssertionError - if the given object is not null.
    • assertNotNull

      public void assertNotNull(AssertionInfo info, Object actual)
      Asserts that the given object is not null.
      Parameters:
      info - contains information about the assertion.
      actual - the given object.
      Throws:
      AssertionError - if the given object is null.
    • 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 compare actual to.
      Throws:
      AssertionError - if the given objects refer to the same object.
    • 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 is null.
      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 is null.
      IllegalArgumentException - if the given array is empty.
      AssertionError - if the given object is present in the given array.
    • assertIsIn

      public <A> void assertIsIn(AssertionInfo info, A actual, Iterable<? extends A> 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 is null.
      IllegalArgumentException - if the given collection is empty.
      AssertionError - if the given object is not present in the given collection.
    • assertIsNotIn

      public <A> void assertIsNotIn(AssertionInfo info, A actual, Iterable<? extends A> 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 is null.
      IllegalArgumentException - if the given collection is empty.
      AssertionError - if the given object is present in the given collection.
    • assertIsLenientEqualsToByIgnoringNullFields

      public <A> void assertIsLenientEqualsToByIgnoringNullFields(AssertionInfo info, A actual, A other)
      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 compare actual to.
      Throws:
      NullPointerException - if the actual type is null.
      NullPointerException - if the other type is null.
      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.
    • assertIsLenientEqualsToByAcceptingFields

      public <A> void assertIsLenientEqualsToByAcceptingFields(AssertionInfo info, A actual, A other, 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 compare actual to.
      fields - accepted fields
      Throws:
      NullPointerException - if the other type is null.
      AssertionError - if actual is null.
      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.
      org.fest.util.IntrospectionError - if a field does not exist in actual.
    • assertIsLenientEqualsToByIgnoringFields

      public <A> void assertIsLenientEqualsToByIgnoringFields(AssertionInfo info, A actual, A other, 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 compare actual to.
      fields - the fields to ignore in comparison
      Throws:
      NullPointerException - if the other type is null.
      AssertionError - if actual is null.
      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.