モジュール java.naming
パッケージ javax.naming.directory

クラスBasicAttributes

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

      コンストラクタ 
      コンストラクタ 説明
      BasicAttributes​()
      Attributesのインスタンスを新しく構築します。
      BasicAttributes​(boolean ignoreCase)
      Attributesのインスタンスを新しく構築します。
      BasicAttributes​(String attrID, Object val)
      Attributesのインスタンスを1つの属性で新しく構築します。
      BasicAttributes​(String attrID, Object val, boolean ignoreCase)
      Attributesのインスタンスを1つの属性で新しく構築します。
    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 具象メソッド 
      修飾子と型 メソッド 説明
      Object clone​()
      このオブジェクトのコピーを作成して、返します。
      boolean equals​(Object obj)
      このBasicAttributesが別のAttributesに等しいかどうかを判定します。2つのAttributesが等しいのは、その両方がAttributesのインスタンスであり、属性IDの大文字と小文字を同じ方法で扱い、さらに同じ属性を含んでいる場合です。
      Attribute get​(String attrID)
      属性セットから、指定された属性IDを持つ属性を取り込みます。
      NamingEnumeration<Attribute> getAll​()
      属性セットの属性の列挙を取り出します。
      NamingEnumeration<String> getIDs​()
      属性セットの属性IDの列挙を取り出します。
      int hashCode​()
      このBasicAttributesのハッシュ・コードを計算します。
      boolean isCaseIgnored​()
      属性の取り込みまたは追加をしているときに、属性セットが属性識別子の大文字と小文字を無視するかどうかを判別します。
      Attribute put​(String attrID, Object val)
      属性セットに新しい属性を追加します。
      Attribute put​(Attribute attr)
      属性セットに新しい属性を追加します。
      Attribute remove​(String attrID)
      属性セットから属性ID「attrID」を持つ属性を削除します。
      int size​()
      属性セットの属性数を取り込みます。
      String toString​()
      この属性セットの文字列表記を生成します。
    • コンストラクタの詳細

      • BasicAttributes

        public BasicAttributes​()
        Attributesのインスタンスを新しく構築します。 以降属性を検索または追加する際に、属性識別子の大文字と小文字は区別されます。
      • BasicAttributes

        public BasicAttributes​(boolean ignoreCase)
        Attributesのインスタンスを新しく構築します。 ignoreCaseがtrueの場合、属性識別子の大文字と小文字は無視されます。それ以外の場合は、大文字と小文字は意味を持ちます。
        パラメータ:
        ignoreCase - trueは、属性を取得または追加するときに、この属性セットがその属性識別子の大文字と小文字を無視することを示す。falseは大文字と小文字に従うことを示す。
      • BasicAttributes

        public BasicAttributes​(String attrID,
                               Object val)
        Attributesのインスタンスを1つの属性で新しく構築します。 属性IDおよびvalによって指定された属性が、新しく作成された属性に追加されます。 以降属性を検索または追加する際に、属性識別子の大文字と小文字は区別されます。
        パラメータ:
        attrID - 追加する属性のnull以外のID。
        val - 追加する属性の値。 nullの場合は、null値が属性に追加される。
      • BasicAttributes

        public BasicAttributes​(String attrID,
                               Object val,
                               boolean ignoreCase)
        Attributesのインスタンスを1つの属性で新しく構築します。 属性IDおよびvalによって指定された属性が、新しく作成された属性に追加されます。 ignoreCaseがtrueの場合、属性識別子の大文字と小文字は無視されます。それ以外の場合は、大文字と小文字は意味を持ちます。
        パラメータ:
        attrID - 追加する属性のnull以外のID。 この属性セットがその属性IDの大文字と小文字を無視する場合、attrIDの大文字と小文字は無視される。
        val - 追加する属性の値。 nullの場合は、null値が属性に追加される。
        ignoreCase - trueは、属性を取得または追加するときに、この属性セットがその属性識別子の大文字と小文字を無視することを示す。falseは大文字と小文字に従うことを示す。
    • メソッドの詳細

      • clone

        public Object clone​()
        次のクラスからコピーされた説明: Object
        このオブジェクトのコピーを作成して、返します。 「コピー」の正確な意味合いは、オブジェクトのクラスによって異なります。 一般的な意図は、任意のオブジェクトxについて、次の式
         x.clone() != x
        がtrueであり、次の式
         x.clone().getClass() == x.getClass()
        trueになることですが、これらは絶対的な要件ではありません。 また次の式
         x.clone().equals(x)
        trueになりますが、これは絶対的な要件ではありません。

        慣例上、返されたオブジェクトは、super.cloneを呼び出すことによって取得するようにしてください。 クラスとそのすべてのスーパー・クラス(Objectを除く)がこの規則に従っている場合は、x.clone().getClass()== x.getClass()が成立します。

        通常、このメソッドにより返されるオブジェクトは、このオブジェクト(複製されている)から独立している必要があります。 この独立性を実現するには、super.cloneによって返されたオブジェクトを返す前に、その1つ以上のフィールドを変更することが必要になる場合があります。 これは、通常、複製するオブジェクトの内部「深層構造」を構成する可変オブジェクトのコピー、およびこれらのオブジェクトへの参照をコピーへの参照に置き換えることを意味します。 クラスにプリミティブ・フィールドまたは不変オブジェクトへの参照しか含まれていない場合は、通常、super.cloneによって返されたオブジェクト内のフィールドを変更する必要がありません。

        クラスObjectのメソッドcloneは、特定のクローニング操作を実行します。 まず、このオブジェクトのクラスがインタフェースCloneableを実装していない場合は、CloneNotSupportedExceptionがスローされます。 すべての配列がインタフェースCloneableを実装していると見なされること、および配列型T[]cloneメソッドの戻り値の型はT[] (ここで、Tは任意の参照またはプリミティブ型)です。 そうでない場合、このメソッドはこのオブジェクトのクラスの新しいインスタンスを生成し、そのフィールドをすべて、このオブジェクトの対応する各フィールドの内容で初期化します。これは代入と同様で、フィールドの内容自身が複製されるのではありません。 つまりこのメソッドは、オブジェクトの「シャロー・コピー」を生成しますが、「ディープ・コピー」は生成しません。

        クラスObject自体はインタフェースCloneableを実装していないため、クラスがObjectであるオブジェクトに対してcloneメソッドを呼び出すと、実行時に例外がスローされます。

        定義:
        clone、インタフェース: Attributes
        オーバーライド:
        clone、クラス: Object
        戻り値:
        このインスタンスの複製。
        関連項目:
        Cloneable
      • isCaseIgnored

        public boolean isCaseIgnored​()
        インタフェースからコピーされた説明: Attributes
        属性の取り込みまたは追加をしているときに、属性セットが属性識別子の大文字と小文字を無視するかどうかを判別します。
        定義:
        isCaseIgnored、インタフェース: Attributes
        戻り値:
        大文字と小文字が無視される場合はtrue、そうでない場合はfalse。
      • size

        public int size​()
        インタフェースからコピーされた説明: Attributes
        属性セットの属性数を取り込みます。
        定義:
        size、インタフェース: Attributes
        戻り値:
        この属性セットの負でない属性数。
      • get

        public Attribute get​(String attrID)
        インタフェースからコピーされた説明: Attributes
        属性セットから、指定された属性IDを持つ属性を取り込みます。
        定義:
        get、インタフェース: Attributes
        パラメータ:
        attrID - 取得する属性のnull以外のID。 この属性セットが属性IDの大文字と小文字を区別しない場合、attrIDの大文字と小文字は区別されない。
        戻り値:
        attrIDで識別される属性。検出されない場合はnull。
        関連項目:
        Attributes.put(java.lang.String, java.lang.Object), Attributes.remove(java.lang.String)
      • getAll

        public NamingEnumeration<Attribute> getAll​()
        インタフェースからコピーされた説明: Attributes
        属性セットの属性の列挙を取り出します。 この列挙でこの属性セットを変更した場合の効果は定義されていません。
        定義:
        getAll、インタフェース: Attributes
        戻り値:
        この属性セット内のnull以外の属性の列挙。 列挙の各要素は、クラスAttributeになる。 属性セットにゼロ属性がある場合、空の列挙が返される。
      • getIDs

        public NamingEnumeration<String> getIDs​()
        インタフェースからコピーされた説明: Attributes
        属性セットの属性IDの列挙を取り出します。 この列挙でこの属性セットを変更した場合の効果は定義されていません。
        定義:
        getIDs、インタフェース: Attributes
        戻り値:
        この属性セットの属性IDのnull以外の列挙。 列挙された各要素のクラスはString。 属性セットにゼロ属性がある場合、空の列挙が返される。
      • put

        public Attribute put​(String attrID,
                             Object val)
        インタフェースからコピーされた説明: Attributes
        属性セットに新しい属性を追加します。
        定義:
        put、インタフェース: Attributes
        パラメータ:
        attrID - 追加する属性のnull以外のID。 属性セットがその属性IDの大文字と小文字を無視する場合、attrIDの大文字と小文字は無視される。
        val - 追加する属性のnullの可能性がある値。 nullの場合、この属性には値が含まれない。
        戻り値:
        この属性セットに以前存在していたattrIDを持つAttribute。そのような属性が存在しなかった場合はnull。
        関連項目:
        Attributes.remove(java.lang.String)
      • put

        public Attribute put​(Attribute attr)
        インタフェースからコピーされた説明: Attributes
        属性セットに新しい属性を追加します。
        定義:
        put、インタフェース: Attributes
        パラメータ:
        attr - 追加するnull以外の属性。 属性セットがその属性IDの大文字と小文字を無視する場合、attrのIDの大文字と小文字は無視される。
        戻り値:
        この属性セットに以前存在していた同じIDを持つAttributeそのような属性が存在しなかった場合はnull。
        関連項目:
        Attributes.remove(java.lang.String)
      • remove

        public Attribute remove​(String attrID)
        インタフェースからコピーされた説明: Attributes
        属性セットから属性ID「attrID」を持つ属性を削除します。 この属性が存在しない場合は、無視されます。
        定義:
        remove、インタフェース: Attributes
        パラメータ:
        attrID - 削除する属性のnull以外のID。 属性セットが属性IDの大文字と小文字を区別しない場合、attrIDの大文字と小文字は区別されない。
        戻り値:
        この属性セットに以前存在していたattrIDと同じIDを持つAttributeそのような属性が存在しなかった場合はnull。
      • toString

        public String toString​()
        この属性セットの文字列表記を生成します。 文字列は、各属性識別子および各属性の内容によって構成されます。 この文字列の内容はデバッグに有効で、プログラムでは解釈されません。
        オーバーライド:
        toString、クラス: Object
        戻り値:
        この属性セットの内容を示す、null以外の文字列表記。
      • equals

        public boolean equals​(Object obj)
        このBasicAttributesが別のAttributesに等しいかどうかを判定します。2つのAttributesが等しいのは、その両方がAttributesのインスタンスであり、属性IDの大文字と小文字を同じ方法で扱い、さらに同じ属性を含んでいる場合です。 このBasicAttributesの各Attributeが同一かどうかはObject.equals()を使用して判定されます。Object.equals()はAttributeの実装によってオーバーライドされていることがあります。 サブクラスがequals()をオーバーライドした場合、サブクラスはhashCode()も同じようにオーバーライドして、等しい2つのAttributesインスタンスが同じハッシュ・コードを持つようにします。
        オーバーライド:
        equals、クラス: Object
        パラメータ:
        obj - 比較対象となるnullの可能性があるオブジェクト。
        戻り値:
        objがこのBasicAttributesと等しい場合はtrue。
        関連項目:
        hashCode()
      • hashCode

        public int hashCode​()
        このBasicAttributesのハッシュ・コードを計算します。

        ハッシュ・コードは、このオブジェクトの属性のハッシュ・コードを加算することによって計算されます。 このBasicAttributesが属性IDの大文字と小文字を区別しない場合はハッシュ・コードに1が加算されます。 サブクラスがhashCode()をオーバーライドした場合、サブクラスはequals()も同じようにオーバーライドして、等しい2つのAttributesインスタンスが同じハッシュ・コードを持つようにします。

        オーバーライド:
        hashCode、クラス: Object
        戻り値:
        このBasicAttributesインスタンスのハッシュ・コードを表すint。
        関連項目:
        equals(java.lang.Object)