java.util

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

java.lang. Объект

java.util. Объекты

public final class Objects
extends Object

Этот класс состоит из 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 <T> T	requireNonNull(T obj) Проверки, которые не указанная ссылка на объект null.
static <T> T	requireNonNull(T obj, String message) Проверки, которые не указанная ссылка на объект null и бросает специализированное NullPointerException если это.
static String	toString(Object o) Возвращает результат вызова toString для не -null параметр и "null" для a null параметр.
static String	toString(Object o, String nullDefault) Возвращает результат вызова toString на первом параметре, если первый параметр не null и возвращает второй параметр иначе.

Методы 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