クラスReference

java.lang.Object
javax.naming.Reference
すべての実装されたインタフェース:
Serializable, Cloneable
直系の既知のサブクラス:
LinkRef
public class Reference extends Object implements Cloneable, Serializable
このクラスは、ネーミングおよびディレクトリ・システ の外部で検出されるオブジェクトに対する参照を表します。

Referenceは、ネーミングおよびディレクトリ・システ に直接バインドされていないオブジェクトに関するアドレス情 の記録方法を提供します。

Referenceは、参照対象のオブジェクトに関するアドレスの 序付けられたリストとクラス情 で構成されます。 リスト内の各アドレスは、同じ概念上のオブジェクトの通信端点を識別します。 「通信端点」とは、オブジェクトへの接続方法を示す情 です。 これは、ネットワーク・アドレス、ローカル・マシン上のメモリー内の位置、同じマシン上の別のプロセスなどになります。リスト内のアドレスの 序は、参照を解釈するオブジェクト・ファクトリでは重要になる 合があります。

複製、オブジェクトが複数の通信メカニズ に対してインタフェースを提供するなどのさまざまな理由から、複数のアドレスが発生する 合があります。 アドレスはインデックス化されてゼロから始まります。

Referenceには、このReferenceの参照先オブジェクトのインスタンスを作成する 合に役に立つ情 も 納されます。 この情 には、そのオブジェクトのクラス名、およびオブジェクトを作成するときに使用されるファクトリのクラス名と位置が示されます。 クラス・ファクトリ位置は、ファクトリをロードするのに使用されるクラス・パスを表す、空白で区切られたURLのリストです。 ファクトリ・クラス(またはファクトリ・クラスが依存するクラスやリソース)をロードする必要があるときは、クラスのロードを試みるために各URLが使用されます。

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

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

  • フィールドのサマリー

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

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

    コンストラクタ
    コンストラクタ
    説明
    Reference(String className)
    クラス名が「className」のオブジェクトに対する新しい参照を構築します。
    Reference(String className, String factory, String factoryLocation)
    クラス名が「className」のオブジェクト、およびオブジェクトのファクトリのクラス名と位置に対して新しい参照を構築します。
    Reference(String className, RefAddr addr)
    クラス名が「className」のオブジェクトに対して新しい参照を構築します。
    Reference(String className, RefAddr addr, String factory, String factoryLocation)
    クラス名が「className」のオブジェクト、オブジェクトのファクトリのクラス名と位置、およびオブジェクトのアドレスに対する新しい参照を構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    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()
    この参照の文字列表記を生成します。

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

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

  • フィールド詳細

    • className

      protected String className
      このReferenceの参照先オブジェクトのクラスの完全指定された名前を含みます。
      関連 目:

    • addrs

      protected Vector<RefAddr> addrs
      このReferenceに含まれるアドレスを含みます。 コンストラクタで初期化されます。

    • classFactory

      protected String classFactory
      ファクトリ・クラスの名前を含みます。このファクトリ・クラスがReferenceの参照先オブジェクトのインスタンスを作成します。 nullに初期化されます。

    • classFactoryLocation

      protected String classFactoryLocation
      ファクトリ・クラスの位置を含みます。 nullに初期化されます。

  • コンストラクタの詳細

    • Reference

      public Reference(String className)
      クラス名が「className」のオブジェクトに対する新しい参照を構築します。 クラス・ファクトリおよびクラス・ファクトリ位置はnullに設定されます。 新しく作成された参照には、ゼロ・アドレスが含まれます。
      パラメータ:
      className - この参照が表すオブジェクトのnull以外のクラス名。

    • Reference

      public Reference(String className, RefAddr addr)
      クラス名が「className」のオブジェクトに対して新しい参照を構築します。 クラス・ファクトリおよびクラス・ファクトリ位置はnullに設定されます。
      パラメータ:
      className - この参照が表すオブジェクトのnull以外のクラス名。
      addr - オブジェクトのnull以外のアドレス。

    • Reference

      public Reference(String className, String factory, String factoryLocation)
      クラス名が「className」のオブジェクト、およびオブジェクトのファクトリのクラス名と位置に対して新しい参照を構築します。
      パラメータ:
      className - この参照が表すオブジェクトのnull以外のクラス名。
      factory - オブジェクトのファクトリのnullの可能性があるクラス名。
      factoryLocation - ファクトリのロード元のnullの可能性がある位置(URLなど)。
      関連 目:

    • Reference

      public Reference(String className, RefAddr addr, String factory, String factoryLocation)
      クラス名が「className」のオブジェクト、オブジェクトのファクトリのクラス名と位置、およびオブジェクトのアドレスに対する新しい参照を構築します。
      パラメータ:
      className - この参照が表すオブジェクトのnull以外のクラス名。
      addr - オブジェクトのnull以外のアドレス。
      factory - オブジェクトのファクトリのnullの可能性があるクラス名。
      factoryLocation - ファクトリのロード元のnullの可能性がある位置(URLなど)。
      関連 目:

  • メソッドの詳細

    • getClassName

      public String getClassName()
      この参照の参照先オブジェクトのクラス名を取り出します。
      戻り値:
      オブジェクトのnull以外の完全指定されたクラス名。(「java.lang.String」など)

    • getFactoryClassName

      public String getFactoryClassName()
      この参照の参照先オブジェクトのファクトリのクラス名を取り出します。
      戻り値:
      nullの可能性がある、ファクトリの完全指定されたクラス名。(「java.lang.String」など)

    • getFactoryClassLocation

      public String getFactoryClassLocation()
      この参照の参照先オブジェクトのファクトリの位置を取り出します。 ファクトリの位置がコード・ベースの 合は、空白で区切られ、 序付けられたURLのリストになり、ファクトリ・クラス定義がロードされる位置が示されます。
      戻り値:
      nullの可能性がある、ファクトリのクラスにロードするための位置を含ん 文字列。

    • get

      public RefAddr get(String addrType)
      アドレス型「addrType」をもつ最初のアドレスを取り出します。 String.compareTo()を使用して、アドレス型が等しいかどうかをテストします。
      パラメータ:
      addrType - アドレスの検索対象となるnull以外のアドレス型。
      戻り値:
      この参照のアドレスは、アドレス・タイプ'addrType'です。そのようなアドレスが存在しない 合はnullです。

    • get

      public RefAddr get(int posn)
      インデックスにあるアドレスを取り出します。
      パラメータ:
      posn - 取り出すアドレスのインデックス。
      戻り値:
      0から始まるインデックスのアドレス。 このインデックスの範囲は[0,getAddressCount())でなければならない。
      スロー:
      ArrayIndexOutOfBoundsException - posnが指定された範囲にない 合。

    • getAll

      public Enumeration<RefAddr> getAll()
      この参照内のアドレスの列挙を取り出します。 アドレスを追 、変更またはこの参照から削除しても、この列挙に対する効果は保証されません。
      戻り値:
      この参照内のアドレス(RefAddr)のnull以外の列挙。 この参照にゼロ・アドレスが含まれる 合は、ゼロ要 のある列挙が返される。

    • size

      public int size()
      この参照内のアドレス数を取り出します。
      戻り値:
      この参照内の でないアドレス数。

    • add

      public void add(RefAddr addr)
      アドレス・リストの末尾にアドレスを追 します。
      パラメータ:
      addr - 追 するnull以外のアドレス。

    • add

      public void add(int posn, RefAddr addr)
      アドレス・リストのインデックス位置にアドレスを追 します。 インデックス以降のすべてのアドレスは、リストの上へ(インデックス0とは逆の方向に) 1つずつシフトされます。
      パラメータ:
      posn - addrを挿入するリストの0から始まるインデックス。
      addr - 追 するnull以外のアドレス。
      スロー:
      ArrayIndexOutOfBoundsException - posnが指定された範囲にない 合。

    • remove

      public Object remove(int posn)
      アドレスのリストからインデックスにあるアドレスを削除します。 位置を超えたインデックスにあるすべてのアドレスは、リストの下(インデックス0方向へ)へ1つずつシフトされます。
      パラメータ:
      posn - 削除するアドレス内の0から始まるインデックス。
      戻り値:
      削除されるアドレス。
      スロー:
      ArrayIndexOutOfBoundsException - posnが指定された範囲にない 合。

    • clear

      public void clear()
      この参照からすべてのアドレスを削除します。

    • equals

      public boolean equals(Object obj)
      objがこの参照と(同じ 序の)同じアドレスをもつ参照であるかどうかを判別します。 アドレスはRefAddr.equals()を使用してチェックされます。 同じアドレス以外に、Referenceではこの参照と同じクラス名をもつことが必要です。 クラス・ファクトリおよびクラス・ファクトリ位置はチェックされません。 objがnullまたはReferenceのインスタンス以外の 合は、nullが返されます。
      オーバーライド:
      equals、クラスObject
      パラメータ:
      obj - チェックするnullの可能性があるオブジェクト。
      戻り値:
      objがこの参照と等しい 合はtrue、そうでない 合はfalse。
      関連 目:

    • hashCode

      public int hashCode()
      この参照のハッシュ・コードを計算します。 ハッシュ・コードとは、そのアドレスのハッシュ・コードの合計です。
      オーバーライド:
      hashCode、クラスObject
      戻り値:
      intとしてのこの参照のハッシュ・コード。
      関連 目:

    • toString

      public String toString()
      この参照の文字列表記を生成します。 文字列はこの参照の参照先クラス名、およびその各アドレスの文字列表記で構成されます。 この表記は、表示される けで、構文解析には使用されません。
      オーバーライド:
      toString、クラスObject
      戻り値:
      この参照のnull以外の文字列表現。

    • clone

      public Object clone()
      アドレスのクラス名リスト、クラス・ファクトリ名およびクラス・ファクトリ位置を使用して、この参照のコピーを作成します。 新しく作成したコピーに変更を えてもこのReferenceには影響ありません。また逆の 合も同じです。
      オーバーライド:
      clone、クラスObject
      戻り値:
      このインスタンスの複製。
      関連 目: