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.

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

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


このドキュメントは、Ja-Jakartaにより訳されました。 コメントがある場合は report@jajakarta.orgまでお願いします。
Translated into Japanese by jajakarta.org. The original page is here.
Copyright (c) 2002-2003 - Apache Software Foundation