Objects (Java Platform SE 8)

java.lang.Object
- java.util.Objects

```
public final class Objects
extends Object
```
このクラスは、オブジェクトで操作するためのstaticユーティリティ・メソッドで構成されます。このようなユーティリティには、オブジェクトのハッシュ・コードを計算したり、オブジェクトを表す文字列を返したり、2つのオブジェクトを比較したりするために、nullセーフまたはnullを許容するメソッドが含まれます。

導入されたバージョン:

1.7

メソッドのサマリー

すべてのメソッド staticメソッド具象メソッド
修飾子と型	メソッドと説明
`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`以外の引数のハッシュ・コードを返し、引数が`null`の場合は0を返します。
`static boolean`	`isNull(Object obj)` 指定された参照が`null`の場合は`true`を返します。それ以外の場合は`false`を返します。
`static boolean`	`nonNull(Object obj)` 指定された参照が`null`以外の場合は`true`を返します。それ以外の場合は`false`を返します。
`static <T> T`	`requireNonNull(T obj)` 指定されたオブジェクト参照が`null`でないことを確認します。
`static <T> T`	`requireNonNull(T obj, String message)` 指定されたオブジェクト参照が`null`でないことを確認し、nullの場合はカスタマイズされた`NullPointerException`をスローします。
`static <T> T`	`requireNonNull(T obj, Supplier<String> messageSupplier)` 指定されたオブジェクト参照が`null`でないことを確認し、nullの場合はカスタマイズされた`NullPointerException`をスローします。
`static String`	`toString(Object o)` 引数が`null`でない場合は`toString`の呼出し結果を返し、`null`の場合は`"null"`を返します。
`static String`	`toString(Object o, String nullDefault)` 最初の引数が`null`でない場合はそれに対する`toString`の呼出し結果を返し、それ以外の場合は2番目の引数を返します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- メソッドの詳細
  - equals
```
public static boolean equals(Object a,
                             Object b)
```
    引数が相互に等しい場合はtrueを返し、それ以外の場合はfalseを返します。したがって、両方の引数がnullの場合はtrueが返され、1つの引数だけがnullの場合はfalseが返されます。それ以外の場合は、最初の引数のequalsメソッドを使用して等しいかどうかが判定されます。
    
    パラメータ:
    
    a - オブジェクト
    
    b - aと等しいかどうかを比較するオブジェクト
    
    戻り値:
    
    引数が相互に等しい場合はtrue、それ以外の場合はfalse
    
    関連項目:
    
    Object.equals(Object)
  - deepEquals
```
public static boolean deepEquals(Object a,
                                 Object b)
```
    引数が相互に深層で等価である場合はtrueを返し、それ以外の場合はfalseを返します。2つのnull値は相互に深層で等価です。両方の引数が配列の場合は、Arrays.deepEqualsのアルゴリズムを使用して等しいかどうかが判定されます。それ以外の場合は、最初の引数のequalsメソッドを使用して等しいかどうかが判定されます。
    
    パラメータ:
    
    a - オブジェクト
    
    b - aと深層で等価であるかどうかを比較するオブジェクト
    
    戻り値:
    
    引数が相互に深層で等価である場合はtrue、それ以外の場合はfalse
    
    関連項目:
    
    Arrays.deepEquals(Object[], Object[]), equals(Object, Object)
  - hashCode
```
public static int hashCode(Object o)
```
    null以外の引数のハッシュ・コードを返し、引数がnullの場合は0を返します。
    
    パラメータ:
    
    o - オブジェクト
    
    戻り値:
    
    引数がnullでない場合はそのハッシュ・コード、引数がnullの場合は0
    
    関連項目:
    
    Object.hashCode()
  - hash
```
public static int hash(Object... values)
```
    一連の入力値に対してハッシュ・コードを生成します。ハッシュ・コードの生成は、入力値が配列に格納され、その配列がArrays.hashCode(Object[])の呼出しでハッシュ化されたかのように処理されます。
    このメソッドは、複数のフィールドを含むオブジェクトにObject.hashCode()を実装する場合に役立ちます。たとえば、オブジェクトに3つのフィールド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)
```
    引数がnullでない場合はtoStringの呼出し結果を返し、nullの場合は"null"を返します。
    
    パラメータ:
    
    o - オブジェクト
    
    戻り値:
    
    引数がnullでない場合はtoStringの呼出し結果、引数がnullの場合は"null"
    
    関連項目:
    
    Object.toString(), String.valueOf(Object)
  - toString
```
public static String toString(Object o,
                              String nullDefault)
```
    最初の引数がnullでない場合はそれに対するtoStringの呼出し結果を返し、それ以外の場合は2番目の引数を返します。
    
    パラメータ:
    
    o - オブジェクト
    
    nullDefault - 最初の引数がnullの場合に返す文字列
    
    戻り値:
    
    最初の引数がnullでない場合はそれに対するtoStringの呼出し結果、それ以外の場合は2番目の引数。
    
    関連項目:
    
    toString(Object)
  - compare
```
public static <T> int compare(T a,
                              T b,
                              Comparator<? super T> c)
```
    引数が一致する場合は0を返し、それ以外の場合はc.compare(a, b)を返します。したがって、両方の引数がnullの場合は0が返されます。
    引数の1つがnullのときは、NullPointerExceptionがスローされる場合とそうでない場合があります。これは、Comparatorでnull値の順序付けポリシーが選択されていれば、そのポリシーによって決まります。
    
    型パラメータ:
    
    T - 比較されるオブジェクトの型
    
    パラメータ:
    
    a - オブジェクト
    
    b - aと比較されるオブジェクト
    
    c - 最初の2つの引数を比較する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 - nullかどうかが判定されるオブジェクト参照
    
    戻り値:
    
    obj (nullでない場合)
    
    例外:
    
    NullPointerException - objがnullである場合
  - requireNonNull
```
public static <T> T requireNonNull(T obj,
                                   String message)
```
    指定されたオブジェクト参照がnullでないことを確認し、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 - nullかどうかが判定されるオブジェクト参照
    
    message - NullPointerExceptionがスローされた場合に使用する詳細メッセージ
    
    戻り値:
    
    obj (nullでない場合)
    
    例外:
    
    NullPointerException - objがnullである場合
  - isNull
```
public static boolean isNull(Object obj)
```
    指定された参照がnullの場合はtrueを返します。それ以外の場合はfalseを返します。
    
    APIの注:
    
    このメソッドは、Predicate(filter(Objects::isNull))として使用するために存在します。
    
    パラメータ:
    
    obj - nullがチェックされる参照
    
    戻り値:
    
    指定された参照がnullの場合はtrue、それ以外の場合はfalse
    
    導入されたバージョン:
    
    1.8
    
    関連項目:
    
    Predicate
  - nonNull
```
public static boolean nonNull(Object obj)
```
    指定された参照がnull以外の場合はtrueを返します。それ以外の場合はfalseを返します。
    
    APIの注:
    
    このメソッドは、Predicate(filter(Objects::nonNull))として使用するために存在します。
    
    パラメータ:
    
    obj - nullがチェックされる参照
    
    戻り値:
    
    指定された参照がnull以外の場合はtrue、それ以外の場合はfalse
    
    導入されたバージョン:
    
    1.8
    
    関連項目:
    
    Predicate
  - requireNonNull
```
public static <T> T requireNonNull(T obj,
                                   Supplier<String> messageSupplier)
```
    指定されたオブジェクト参照がnullでないことを確認し、nullの場合はカスタマイズされたNullPointerExceptionをスローします。
    メソッドrequireNonNull(Object, String)とは異なり、このメソッドはnullチェックが行われる後までメッセージの作成を遅延できます。これはnull以外の場合にパフォーマンスが向上する場合がありますが、このメソッドを呼び出すことを決定するときは、メッセージ・サプライヤを作成するコストが文字列メッセージを単に直接作成するコストよりも小さいことを考慮するようにしてください。
    
    型パラメータ:
    
    T - その参照の型
    
    パラメータ:
    
    obj - nullかどうかが判定されるオブジェクト参照
    
    messageSupplier - NullPointerExceptionがスローされる場合に使用される詳細メッセージのサプライヤ
    
    戻り値:
    
    obj (nullでない場合)
    
    例外:
    
    NullPointerException - objがnullである場合
    
    導入されたバージョン:
    
    1.8

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスObjects

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

メソッドの詳細

equals

deepEquals

hashCode

hash

toString

toString

compare

requireNonNull

requireNonNull

isNull

nonNull

requireNonNull