Class Objects


  • public final class Objects
    extends java.lang.Object
    Utility methods related to objects.
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static int HASH_CODE_PRIME
      Prime number used to calculate the hash code of objects.
    • Constructor Summary

      Constructors 
      Modifier Constructor Description
      private Objects()  
    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static boolean areEqual​(java.lang.Object o1, java.lang.Object o2)
      Deprecated.
      Use Objects.deepEquals(Object, Object) instead.
      static boolean areEqualArrays​(java.lang.Object o1, java.lang.Object o2)
      Deprecated.
      Use either Objects.deepEquals(Object, Object) or Arrays.deepEquals(Object[], Object[]).
      static <T> T castIfBelongsToType​(java.lang.Object o, java.lang.Class<T> type)
      Casts the given object to the given type only if the object is of the given type.
      static int hashCodeFor​(java.lang.Object o)
      Returns the hash code for the given object.
      static java.lang.String[] namesOf​(java.lang.Class<?>... types)
      Returns an array containing the names of the given types.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • HASH_CODE_PRIME

        public static final int HASH_CODE_PRIME
        Prime number used to calculate the hash code of objects.
        See Also:
        Constant Field Values
    • Constructor Detail

      • Objects

        private Objects()
    • Method Detail

      • areEqual

        @Deprecated
        public static boolean areEqual​(java.lang.Object o1,
                                       java.lang.Object o2)
        Deprecated.
        Use Objects.deepEquals(Object, Object) instead.
        Returns true if the arguments are deeply equal to each other, false otherwise.

        Two null values are deeply equal. If both arguments are arrays, the algorithm in Arrays.deepEquals(java.lang.Object[], java.lang.Object[]) is used to determine equality. Otherwise, equality is determined by using the Object.equals(java.lang.Object) method of the first argument.

        Parameters:
        o1 - an object.
        o2 - an object to be compared with o1 for deep equality.
        Returns:
        true if the arguments are deeply equal to each other, false otherwise.
      • areEqualArrays

        @Deprecated
        public static boolean areEqualArrays​(java.lang.Object o1,
                                             java.lang.Object o2)
        Deprecated.
        Use either Objects.deepEquals(Object, Object) or Arrays.deepEquals(Object[], Object[]).
        Returns true if the arguments are arrays and deeply equal to each other, false otherwise.

        Once verified that the arguments are arrays, the algorithm in Arrays.deepEquals(java.lang.Object[], java.lang.Object[]) is used to determine equality.

        Parameters:
        o1 - an object.
        o2 - an object to be compared with o1 for deep equality.
        Returns:
        true if the arguments are arrays and deeply equal to each other, false otherwise.
      • namesOf

        public static java.lang.String[] namesOf​(java.lang.Class<?>... types)
        Returns an array containing the names of the given types.
        Parameters:
        types - the given types.
        Returns:
        the names of the given types stored in an array.
      • hashCodeFor

        public static int hashCodeFor​(java.lang.Object o)
        Returns the hash code for the given object. If the object is null, this method returns zero. Otherwise calls the method hashCode of the given object.
        Parameters:
        o - the given object.
        Returns:
        the hash code for the given object
      • castIfBelongsToType

        public static <T> T castIfBelongsToType​(java.lang.Object o,
                                                java.lang.Class<T> type)
        Casts the given object to the given type only if the object is of the given type. If the object is not of the given type, this method returns null.
        Type Parameters:
        T - the generic type to cast the given object to.
        Parameters:
        o - the object to cast.
        type - the given type.
        Returns:
        the casted object, or null if the given object is not to the given type.