Класс Objects

Методы

equals

public static boolean equals(Object a,
                             Object b)

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

Параметры:

a - объект

b - объект для сравнения с a на предмет равенства

Возвращает:

true если аргументы равны друг другу и false в противном случае

См. также:

Object.equals(Object)

deepEquals

public static boolean deepEquals(Object a,
                                 Object b)

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

Параметры:

a - объект

b - объект для сравнения с a на предмет глубокого равенства

Возвращает:

true если аргументы глубоко равны друг другу и false в противном случае

См. также:

Arrays.deepEquals(Object[], Object[]), equals(Object, Object)

hashCode

public static int hashCode(Object o)

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

Параметры:

o - объект

Возвращает:

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

См. также:

Object.hashCode()

hash

public static int hash(Object... values)

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

Параметры:

values - значения, которые нужно хешировать

Возвращает:

значение хэша последовательности входных значений

См. также:

Arrays.hashCode(Object[]), List.hashCode()

toString

public static String toString(Object o)

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

Параметры:

o - объект

Возвращает:

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

См. также:

Object.toString(), String.valueOf(Object)

toString

public static String toString(Object o,
                              String nullDefault)

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

Параметры:

o - объект

nullDefault - строка, возвращаемая, если первый аргумент null

Возвращает:

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

См. также:

toString(Object)

compare

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

Параметры типа:

T - тип сравниваемых объектов

Параметры:

a - объект

b - объект для сравнения с a

c - Comparator для сравнения первых двух аргументов

Возвращает:

0, если аргументы идентичны, и c.compare(a, b) в противном случае.

См. также:

Comparable, Comparator

requireNonNull

public static <T> T requireNonNull(T obj)

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

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

Параметры типа:

T - тип ссылки

Параметры:

obj - ссылка на объект для проверки на пустоту

Возвращает:

obj если не null

Исключения:

NullPointerException - если obj является null

requireNonNull

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");
}

Параметры типа:

T - тип ссылки

Параметры:

obj - ссылка на объект для проверки на пустоту

message - сообщение об ошибке, используемое в случае выброса исключения NullPointerException

Возвращает:

obj если не null

Исключения:

NullPointerException - если obj является null

isNull

public static boolean isNull(Object obj)

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

Примечание API:

Этот метод предназначен для использования в качестве Predicate, filter(Objects::isNull)

Параметры:

obj - ссылка, проверяемая на null

Возвращает:

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

С:

1.8

См. также:

Predicate

nonNull

public static boolean nonNull(Object obj)

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

Примечание API:

Этот метод предназначен для использования в качестве Predicate, filter(Objects::nonNull)

Параметры:

obj - ссылка для проверки на null

Возвращает:

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

С:

1.8

См. также:

Predicate

requireNonNull

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

Параметры типа:

T - тип ссылки

Параметры:

obj - ссылка на объект для проверки на пустоту

messageSupplier - поставщик сообщения об ошибке, используемого в случае выброса исключения NullPointerException

Возвращает:

obj если не null

Исключения:

NullPointerException - если obj является null

С:

1.8