クラスLinkRef

java.lang.Object
javax.naming.Reference
javax.naming.LinkRef
すべての実装されたインタフェース:
Serializable, Cloneable
public class LinkRef extends Reference
このクラスは参照を表します。参照の内容はリンク名と呼ばれる名前で、コンテキストの基本名にバインドされます。

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

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

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

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

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

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

導入されたバージョン:
1.3
関連項目:

  • フィールドのサマリー

    参照クラスで宣言されたフィールド

    addrs, classFactory, classFactoryLocation, className
    修飾子と型
    フィールド
    説明
    protected Vector<RefAddr>
    addrs
    このReferenceに含まれるアドレスを含みます。
    protected String
    classFactory
    ファクトリ・クラスの名前を含みます。このファクトリ・クラスがReferenceの参照先オブジェクトのインスタンスを作成します。
    protected String
    classFactoryLocation
    ファクトリ・クラスの位置を含みます。
    protected String
    className
    このReferenceの参照先オブジェクトのクラスの完全指定された名前を含みます。

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

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

  • メソッドのサマリー

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

    クラスリファレンスで宣言されたメソッド

    add, add, clear, clone, equals, get, get, getAll, getClassName, getFactoryClassLocation, getFactoryClassName, hashCode, remove, size, toString
    修飾子と型
    メソッド
    説明
    void
    add(int posn, RefAddr addr)
    アドレス・リストのインデックス位置にアドレスを追加します。
    void
    add(RefAddr addr)
    アドレス・リストの末尾にアドレスを追加します。
    void
    clear()
    この参照からすべてのアドレスを削除します。
    Object
    clone()
    アドレスのクラス名リスト、クラス・ファクトリ名およびクラス・ファクトリ位置を使用して、この参照のコピーを作成します。
    boolean
    equals(Object obj)
    objがこの参照と(同じ順序の)同じアドレスをもつ参照であるかどうかを判別します。
    RefAddr
    get(int posn)
    インデックスにあるアドレスを取り出します。
    RefAddr
    get(String addrType)
    アドレス型「addrType」をもつ最初のアドレスを取り出します。
    Enumeration<RefAddr>
    getAll()
    この参照内のアドレスの列挙を取り出します。
    String
    getClassName()
    この参照の参照先オブジェクトのクラス名を取り出します。
    String
    getFactoryClassLocation()
    この参照の参照先オブジェクトのファクトリの位置を取り出します。
    String
    getFactoryClassName()
    この参照の参照先オブジェクトのファクトリのクラス名を取り出します。
    int
    hashCode()
    この参照のハッシュ・コードを計算します。
    Object
    remove(int posn)
    アドレスのリストからインデックスにあるアドレスを削除します。
    int
    size()
    この参照内のアドレス数を取り出します。
    String
    toString()
    この参照の文字列表記を生成します。

    クラスオブジェクトで宣言されたメソッド

    finalize, getClass, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • 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 - ネーミング例外が検出された場合。