モジュール java.naming

パッケージ javax.naming

クラスNameClassPair

java.lang.Object

javax.naming.NameClassPair

すべての実装されたインタフェース:

Serializable

直系の既知のサブクラス:

Binding

public class NameClassPair extends Object implements Serializable

このクラスは、コンテキストのバインディングのオブジェクト名とクラス名のペアを表します。

コンテキストは、名前からオブジェクトへのバインディングで構成されます。 NameClassPairクラスは、バインドされたオブジェクトの名前とクラスを表します。 それは、パッケージ名が完全指定されたクラス名を表す名前と文字列で構成されます。

名前とクラスのペアの内容を動的に生成するネーミング・システムの場合は、サブクラスを使用してください。

NameClassPairインスタンスは、並行アクセスに対して複数のスレッドでは同期化されません。 NameClassPairに並行してアクセスする必要のあるスレッドは、それ自体で同期化され、必要なロックを提供する必要があります。

導入されたバージョン:

1.3

関連項目:

• Context.list(javax.naming.Name)
• 直列化された形式

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
NameClassPair(String name, String className)	指定した名前およびクラス名のNameClassPairのインスタンスを構築します。
NameClassPair(String name, String className, boolean isRelative)	指定した名前、クラス名、およびリスト・コンテキストを基準にしているかを示すNameClassPairのインスタンスを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
String	getClassName()	このバインディングの名前にバインドされたオブジェクトのクラス名を取得します。
String	getName()	このバインディングの名前を取得します。
String	getNameInNamespace()	このバインディングの完全な名前を取得します。
boolean	isRelative()	このバインディングの名前が(list()メソッドの最初のパラメータで指定された)ターゲット・コンテキストを基準にしているかどうかを判定します。
void	setClassName(String name)	このバインディングのクラス名を設定します。
void	setName(String name)	このバインディングの名前を設定します。
void	setNameInNamespace(String fullName)	このバインディングの完全な名前を設定します。
void	setRelative(boolean r)	このバインディングの名前が(list()メソッドの最初のパラメータで指定された)ターゲット・コンテキストを基準にしているかどうかを設定します。
String	toString()	この名前とクラスのペアの文字列表現を生成します。

クラスjava.lang.Objectで宣言されたメソッド

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

コンストラクタの詳細

NameClassPair

public NameClassPair(String name, String className)

指定した名前およびクラス名のNameClassPairのインスタンスを構築します。

パラメータ:

name - オブジェクトのnull以外の名前。 これは(list()メソッドの最初のパラメータで指定された) ターゲット・コンテキストを基準にしています。

className - 名前にバインドされたオブジェクトのnullの可能性があるクラス名。 バインドされたオブジェクトがnullの場合はnull。

関連項目:

• getClassName()
• setClassName(java.lang.String)
• getName()
• setName(java.lang.String)

NameClassPair

public NameClassPair(String name, String className, boolean isRelative)

指定した名前、クラス名、およびリスト・コンテキストを基準にしているかを示すNameClassPairのインスタンスを構築します。

パラメータ:

name - オブジェクトのnull以外の名前。

className - 名前にバインドされたオブジェクトのnullの可能性があるクラス名。 バインドされたオブジェクトがnullの場合はnull。

isRelative - nameが(list()メソッドの最初のパラメータで指定された)ターゲット・コンテキストを基準にした名前の場合はtrue。nameがURL文字列の場合はfalse。

関連項目:

• getClassName()
• setClassName(java.lang.String)
• getName()
• setName(java.lang.String)
• isRelative()
• setRelative(boolean)

メソッドの詳細

getClassName

public String getClassName()

このバインディングの名前にバインドされたオブジェクトのクラス名を取得します。 参照またはその他の間接情報がバインドされている場合は、Binding.getObject()によって返される最終オブジェクトのクラス名を取得します。

戻り値:

nullの可能性がある、バインドされたオブジェクトのクラス名。 バインドされたオブジェクトがnullの場合はnull。

関連項目:

• Binding.getObject()
• Binding.getClassName()
• setClassName(java.lang.String)

getName

public String getName()

このバインディングの名前を取得します。 isRelative()がtrueの場合、この名前はターゲット・コンテキスト(list()の最初のパラメータで指定されます)を基準にしています。 isRelative()がfalseの場合、この名前はURL文字列です。

戻り値:

このバインディングのnull以外の名前。

関連項目:

• isRelative()
• setName(java.lang.String)

setName

public void setName(String name)

このバインディングの名前を設定します。

パラメータ:

name - 名前として使用するnull以外の文字列。

関連項目:

• getName()
• setRelative(boolean)

setClassName

public void setClassName(String name)

このバインディングのクラス名を設定します。

パラメータ:

name - nullの可能性がある、クラス名として使用する文字列。 nullの場合、Binding.getClassName()はバインディング内のオブジェクトの実際のクラス名を返します。 バインドされたオブジェクトがnullの場合、クラス名はnullになる。

関連項目:

• getClassName()
• Binding.getClassName()

isRelative

public boolean isRelative()

このバインディングの名前が(list()メソッドの最初のパラメータで指定された)ターゲット・コンテキストを基準にしているかどうかを判定します。

戻り値:

このバインディングの名前がターゲット・コンテキストに対する相対名の場合はtrueこのバインディングの名前がURL文字列の場合はfalse。

関連項目:

• setRelative(boolean)
• getName()

setRelative

public void setRelative(boolean r)

このバインディングの名前が(list()メソッドの最初のパラメータで指定された)ターゲット・コンテキストを基準にしているかどうかを設定します。

パラメータ:

r - trueの場合、バインディングの名前はターゲット・コンテキストに対する相対名。falseの場合、バインディングの名前はURL文字列。

関連項目:

• isRelative()
• setName(java.lang.String)

getNameInNamespace

public String getNameInNamespace()

このバインディングの完全な名前を取得します。 完全な名前とは、このバインディング自体の名前空間におけるバインディングの絶対名です。 Context.getNameInNamespace()を参照してください。

このバインディングにフルネームの概念が適用されないネーミング・システムでは、UnsupportedOperationExceptionがスローされます。 このメソッドの導入前に作成されたサービス・プロバイダが使用されている場合にも、この例外がスローされます。

このメソッドで返される文字列は、JNDI合成名ではなく、コンテキスト・メソッドに直接渡すことはできません。

戻り値:

このバインディングの完全な名前。

例外:

UnsupportedOperationException - ネーミング・システムで、完全な名前の概念がこのバインディングについて成立しない場合。

導入されたバージョン:

1.5

関連項目:

• setNameInNamespace(java.lang.String)
• getName()

setNameInNamespace

public void setNameInNamespace(String fullName)

このバインディングの完全な名前を設定します。 NameClassPairが作成され、このバインディングにフル・ネームが適用可能な場合は、このメソッドをコールしてフル・ネームを設定する必要があります。

フルネームをnullに設定するか、まったく設定しないと、getNameInNamespace()によって例外がスローされます。

パラメータ:

fullName - 使用する完全な名前。

導入されたバージョン:

1.5

関連項目:

• getNameInNamespace()
• setName(java.lang.String)

toString

public String toString()

この名前とクラスのペアの文字列表現を生成します。 文字列表現は、コロン(「:」)で区切られる名前とクラス名で構成されます。 この文字列の内容はデバッグに有効で、プログラムでは解釈されません。

オーバーライド:

toString、クラスObject

戻り値:

この名前とクラスのペアの文字列表現。