javax.naming

クラス LinkRef

java.lang.Object

javax.naming.Reference

javax.naming.LinkRef

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

Serializable, Cloneable

public class LinkRef
extends Reference

このクラスは参照を表します。参照の内容はリンク名と呼ばれる名前で、コンテキストの基本名にバインドされます。

名前は URL、または初期コンテキストを基準にして解決される名前、または名前の最初の文字が "." の場合は、リンクがバインドされるコンテキストを基準にした名前になります。

コンテキストオペレーションの名前の通常の解決は、必ずリンクに続きます。リンク名自体を解決すると、解決がほかのリンクに渡されることになります。これにより、正常に解決されなかったリンクのサイクルが発生する可能性があります。このような終了しない解決を簡単に回避するために、サービスプロバイダは、呼び出し側によって呼び出される 1 つのオペレーションに含まれるリンクの数に制限を設定できます。

LinkRef には 1 つの StringRefAddr が含まれています。型は "LinkAddress" で、内容はリンク名です。参照の [className (クラス名)] フィールドは、この (LinkRef) クラスのフィールドです。

LinkRef は、通常の Context.bind()/rebind() および DirContext.bind()/rebind() を使用して名前にバインドされます。Context.lookupLink() は、終端の不可分な名前がリンクにバインドされている場合に、リンク自体を取得するために使用されます。

多数のネーミングシステムでは、ネーミングシステム自体で使用されるリンクの本来的な概念がサポートされています。JNDI では、このような本来的なリンクと JNDI リンクの間に関係があるかは指定されていません。

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

導入されたバージョン:

1.3

関連項目:

LinkException, LinkLoopException, MalformedLinkException, Context.lookupLink(javax.naming.Name), 直列化された形式

フィールドのサマリー

クラス javax.naming.Reference から継承されたフィールド

addrs, classFactory, classFactoryLocation, className

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

コンストラクタ

コンストラクタと説明
LinkRef(Name linkName) 名前の LinkRef を構築します。
LinkRef(String linkName) 文字列名の LinkRef を構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
String	getLinkName() このリンクの名前を取得します。

クラス javax.naming.Reference から継承されたメソッド

add, add, clear, clone, equals, get, get, getAll, getClassName, getFactoryClassLocation, getFactoryClassName, hashCode, remove, size, toString

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

finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

LinkRef

public LinkRef(Name linkName)

名前の LinkRef を構築します。

パラメータ:

linkName - このリンクを作成する対象となる null 以外の名前。

LinkRef

public LinkRef(String linkName)

文字列名の LinkRef を構築します。

パラメータ:

linkName - このリンクを作成する対象となる null 以外の名前。

メソッドの詳細

getLinkName

public String getLinkName()
                   throws NamingException

このリンクの名前を取得します。

戻り値:

このリンクの null 以外の名前。

例外:

MalformedLinkException - リンク名が抽出できなかった場合。

NamingException - ネーミング例外が検出された場合。