compact1, compact2, compact3

java.util

Объекты класса

java.lang. Объект

java.util. Объекты

public final class Objects
extends Object

Этот class состоит из static служебные методы для того, чтобы работать на объектах. Эти утилиты включают null- безопасный или null- терпимые методы для того, чтобы вычислить хэш-код объекта, возвращая строку для объекта, и сравнивая два объекта.

С тех пор:

1.7

Сводка метода

Модификатор и Тип	Метод и Описание
static <T> int	compare(T a, T b, Comparator<? super T> c) Возвраты 0, если параметры идентичны и c.compare(a, b) иначе.
static boolean	deepEquals(Object a, Object b) Возвраты true если параметры очень равны друг другу и false иначе.
static boolean	equals(Object a, Object b) Возвраты true если параметры равны друг другу и false иначе.
static int	hash(Object... values) Генерирует хэш-код для последовательности входных значений.
static int	hashCode(Object o) Возвращает хэш-код не -null параметр и 0 для a null параметр.
static boolean	isNull(Object obj) Возвраты true если обеспеченная ссылка null иначе возвраты false.
static boolean	nonNull(Object obj) Возвраты true если обеспеченная ссылка не -null иначе возвраты false.
static <T> T	requireNonNull(T obj) Проверки, которые не указанная ссылка на объект null.
static <T> T	requireNonNull(T obj, String message) Проверки, которые не указанная ссылка на объект null и бросает специализированное NullPointerException если это.
static <T> T	requireNonNull(T obj, Supplier<String> messageSupplier) Проверки, которые не указанная ссылка на объект null и бросает специализированное NullPointerException если это.
static String	toString(Object o) Возвращает результат вызова toString для не -null параметр и "null" для a null параметр.
static String	toString(Object o, String nullDefault) Возвращает результат вызова toString на первом параметре, если первый параметр не null и возвращает второй параметр иначе.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь метода

равняется

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)

хэш-код

public static int hashCode(Object o)

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

Параметры:

o - объект

Возвраты:

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

См. Также:

Object.hashCode()

хеш

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).

Параметры:

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

Возвраты:

значение хэш-функции последовательности входных значений

См. Также:

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

toString

public static String toString(Object o)

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

Параметры:

o - объект

Возвраты:

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

См. Также:

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

toString

public static String toString(Object o,
                              String nullDefault)

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

Параметры:

o - объект

nullDefault - представьте в виде строки, чтобы возвратиться, если первый параметр null

Возвраты:

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

См. Также:

toString(Object)

сравниться

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

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

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

Введите Параметры:

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 - детализируйте сообщение, которое будет использоваться когда a NullPointerException бросается

Возвраты:

obj если нет null

Броски:

NullPointerException - если obj null

isNull

public static boolean isNull(Object obj)

Возвраты true если обеспеченная ссылка null иначе возвраты false.

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

Этот метод существует, чтобы использоваться в качестве a Predicate, filter(Objects::isNull)

Параметры:

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

Возвраты:

true если обеспеченная ссылка null иначе false

С тех пор:

1.8

См. Также:

Predicate

ненуль

public static boolean nonNull(Object obj)

Возвраты true если обеспеченная ссылка не -null иначе возвраты false.

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

Этот метод существует, чтобы использоваться в качестве a Predicate, filter(Objects::nonNull)

Параметры:

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

Возвраты:

true если обеспеченная ссылка не -null иначе false

С тех пор:

1.8

См. Также:

Predicate

requireNonNull

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

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

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

Введите Параметры:

T - тип ссылки

Параметры:

obj - ссылка на объект, чтобы проверить на ничтожность

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

Возвраты:

obj если нет null

Броски:

NullPointerException - если obj null

С тех пор:

1.8