compact3

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

戻り値:

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