org.apache.commons.lang
クラス ObjectUtils

java.lang.Object
  org.apache.commons.lang.ObjectUtils

public class ObjectUtils

extends Object

共通的な Object に対する処理ルーチンです。

Common Object manipulation routines.

バージョン:

$Id: ObjectUtils.java,v 1.1.1.1 2004/02/13 10:02:04 hioki Exp $

作成者:

Nissim Karpenstein, Janek Bogucki, Daniel Rall, Stephen Colebourne

翻訳者:

日置 聡

翻訳状況:

初稿(校正者募集中)

翻訳更新日:

2003/08/11

入れ子クラスの概要

static class

ObjectUtils.Null null が他の意味を持ってしまう場合の代用のために使用されます。

フィールドの概要

static ObjectUtils.Null

NULL null が他の意味を持ってしまう場合の代用のために使用されるシングルトンのインスタンスです。

コンストラクタの概要

ObjectUtils()
ObjectUtils のインスタンスは一般的なプログラムからは生成すべきではありません。

メソッドの概要

static Object	defaultIfNull(Object object, Object defaultValue) 指定されたオブジェクトが null だった場合に指定されたデフォルト値(オブジェクト)を返します。
static boolean	equals(Object object1, Object object2) 2つのオブジェクトが等しいかどうかを評価します。
static String	identityToString(Object object) もしクラスが toString をオーバーライドしていなかった場合に Object が提供する toString の結果を返します。

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

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

フィールドの詳細

NULL

public static final ObjectUtils.Null NULL

null が他の意味を持ってしまう場合の代用のために使用されるシングルトンのインスタンスです。

Singleton used as a null placeholder where null has another meaning.

例えば、 HashMap の get(key) メソッドは指定されたキーに null が関連付けられていた場合にも該当するキーが存在しなかった場合にも null を返します。 Null は子の2つの場合を区別するために使用されます。

For example, in a HashMap the get(key) method returns null if the Map contains null or if there is no matching key. The Null placeholder can be used to distinguish between these two cases.

他の例としては HashTable は null を保持することができません。

Another example is HashTable, where null cannot be stored.

このインスタンスは Serializable です。

This instance is Serializable.

コンストラクタの詳細

ObjectUtils

public ObjectUtils()

ObjectUtils のインスタンスは一般的なプログラムからは生成すべきではありません。 代わりに ObjectUtils.defaultIfNull("a","b"); というように使用すべきです。 このコンストラクタは、処理に JavaBean インスタンスを必要とするツールのために public になっています。

ObjectUtils instances should NOT be constructed in standard programming. Instead, the class should be used as ObjectUtils.defaultIfNull("a","b");. This constructor is public to permit tools that require a JavaBean instance to operate.

メソッドの詳細

defaultIfNull

public static Object defaultIfNull(Object object,
                                   Object defaultValue)

指定されたオブジェクトが null だった場合に指定されたデフォルト値(オブジェクト)を返します。

Returns a default value if the object passed is null.

パラメータ:

object - チェック対象となるオブジェクト

the object to test

defaultValue - デフォルトの値(オブジェクト)

the default value to return

戻り値:

object null だった場合にはデフォルトの値、その他の場合にはチェック対象となるオブジェクト

object if it is not null, defaultValue otherwise

equals

public static boolean equals(Object object1,
                             Object object2)

2つのオブジェクトが等しいかどうかを評価します。 片方または両方のオブジェクトが null だった場合にも処理を行うことができます。

Compares two objects for equality, where either one or both objects may be null.

パラメータ:

object1 - 比較対照となる最初のオブジェクト

the first object

object2 - 比較対照となる次のオブジェクト

the second object

戻り値:

2つのオブジェクトの値が等しかった場合、true

true if the values of both objects are the same

identityToString

public static String identityToString(Object object)

もしクラスが toString をオーバーライドしていなかった場合に Object が提供する toString の結果を返します。null が指定された場合には null を返します。

Gets the toString that would be produced by Object if a class did not override toString itself. Null will return null.

パラメータ:

object - toString の結果を表示するオブジェクト、または null

the object to create a toString for, may be null

戻り値:

デフォルトの toString の結果となるテキスト、null が指定された場合には null

the default toString text, or null if null passed in