Класс Objects

public static boolean equals(Object a, Object b)

Возвращает значение true, если аргументы равны друг другу, и false в противном случае. Следовательно, если оба аргумента являются null, возвращается true. В противном случае, если первый аргумент не является null, равенство определяется путем вызова метода equals первого аргумента со вторым аргументом этого метода. В противном случае возвращается false.

public static boolean deepEquals(Object a, Object b)

Возвращает true, если аргументы глубоко равны друг другу, и false в противном случае. Два null значения глубоко равны. Если оба аргумента являются массивами, используется алгоритм из Arrays.deepEquals для определения равенства. В противном случае равенство определяется с помощью метода equals первого аргумента.

public static int hashCode(Object o)

Возвращает хэш-код не-null аргумента и 0 для null аргумента.

public static int hash(Object... values)

Генерирует хэш-код для последовательности входных значений. Хэш-код генерируется так, как если бы все входные значения были помещены в массив, а этот массив был бы хеширован с помощью вызова Arrays.hashCode(Object[]).

Этот метод полезен для реализации Object.hashCode() на объектах, содержащих несколько полей. Например, если у объекта есть три поля, x, y, и z, можно написать:

 @Override public int hashCode() {
     return Objects.hash(x, y, z);
 }
 

Предупреждение: Когда предоставляется единственная ссылка на объект, возвращаемое значение не равно хэш-коду этой ссылки на объект. Это значение можно вычислить, вызвав hashCode(Object).

public static String toString(Object o)

Возвращает результат вызова toString для не- null аргумента и "null" для null аргумента.

public static String toString(Object o, String nullDefault)

Возвращает результат вызова toString для первого аргумента, если первый аргумент не null, и возвращает второй аргумент в противном случае.

public static <T> int compare(T a, T b, Comparator<? super T> c)

Возвращает 0, если аргументы идентичны, и c.compare(a, b) в противном случае. Следовательно, если оба аргумента null, возвращается 0.

Обратите внимание, что если один из аргументов null, может быть или не быть выброшено исключение NullPointerException, в зависимости от политики упорядочения, если таковая имеется, которую Comparator выбирает для null значений.

public static <T> T requireNonNull(T obj)

Проверяет, что указанная ссылка на объект не null. Этот метод предназначен в первую очередь для проверки параметров в методах и конструкторах, как показано ниже:

 public Foo(Bar bar) {
     this.bar = Objects.requireNonNull(bar);
 }
 

public static <T> T requireNonNull(T obj, String message)

Проверяет, что указанная ссылка на объект не null и выводит настраиваемое исключение NullPointerException, если это так. Этот метод предназначен в первую очередь для проверки параметров в методах и конструкторах с несколькими параметрами, как показано ниже:

 public Foo(Bar bar, Baz baz) {
     this.bar = Objects.requireNonNull(bar, "bar must not be null");
     this.baz = Objects.requireNonNull(baz, "baz must not be null");
 }
 

public static boolean isNull(Object obj)

Возвращает true если предоставленная ссылка равна null, в противном случае возвращает false.

public static boolean nonNull(Object obj)

Возвращает true если предоставленная ссылка не равна null, в противном случае возвращает false.

public static <T> T requireNonNullElse(T obj, T defaultObj)

Возвращает первый аргумент, если он не null, и в противном случае возвращает не-null второй аргумент.

public static <T> T requireNonNullElseGet(T obj, Supplier<? extends T> supplier)

Возвращает первый аргумент, если он не-null, и в противном случае возвращает не-null значение supplier.get().

public static <T> T requireNonNull(T obj, Supplier<String> messageSupplier)

Проверяет, что указанная ссылка на объект не null и выбрасывает настроенное исключение NullPointerException, если это так.

В отличие от метода requireNonNull(Object, String), этот метод позволяет отложить создание сообщения до проверки на null. Хотя это может обеспечить преимущество производительности в случае не-null, при решении вызвать этот метод следует учитывать, что затраты на создание поставщика сообщений меньше, чем затраты на непосредственное создание строкового сообщения.

public static int checkIndex(int index, int length)

Проверяет, находится ли index в пределах диапазона от 0 (включительно) до length (исключительно).

index считается вне границ, если выполняется любое из следующих неравенств:

• index < 0
• index >= length
• length < 0, что подразумевается из предыдущих неравенств

public static int checkFromToIndex(int fromIndex, int toIndex, int length)

Проверяет, находится ли поддиапазон от fromIndex (включительно) до toIndex (исключительно) в пределах границ диапазона от 0 (включительно) до length (исключительно).

Поддиапазон считается вне границ, если выполняется любое из следующих неравенств:

• fromIndex < 0
• fromIndex > toIndex
• toIndex > length
• length < 0, что подразумевается из предыдущих неравенств

public static int checkFromIndexSize(int fromIndex, int size, int length)

Проверяет, находится ли поддиапазон от fromIndex (включительно) до fromIndex + size (исключительно) в пределах границ диапазона от 0 (включительно) до length (исключительно).

Поддиапазон считается вне границ, если выполняется любое из следующих неравенств:

• fromIndex < 0
• size < 0
• fromIndex + size > length, с учетом переполнения целых чисел
• length < 0, что подразумевается из предыдущих неравенств

public static long checkIndex(long index, long length)

Проверяет, находится ли index в пределах диапазона от 0 (включительно) до length (исключительно).

index считается вне границ, если выполняется любое из следующих неравенств:

• index < 0
• index >= length
• length < 0, что подразумевается из предыдущих неравенств

public static long checkFromToIndex(long fromIndex, long toIndex, long length)

Проверяет, находится ли поддиапазон от fromIndex (включительно) до toIndex (исключительно) в пределах границ диапазона от 0 (включительно) до length (исключительно).

Поддиапазон считается вне границ, если выполняется любое из следующих неравенств:

• fromIndex < 0
• fromIndex > toIndex
• toIndex > length
• length < 0, что подразумевается из предыдущих неравенств

public static long checkFromIndexSize(long fromIndex, long size, long length)

Проверяет, находится ли поддиапазон от fromIndex (включительно) до fromIndex + size (исключительно) в пределах границ диапазона от 0 (включительно) до length (исключительно).

Поддиапазон считается вне границ, если выполняется любое из следующих неравенств:

• fromIndex < 0
• size < 0
• fromIndex + size > length, с учетом переполнения целых чисел
• length < 0, что подразумевается из предыдущих неравенств