BasicAttributes (Java Platform SE 8)

java.lang.Object
- javax.naming.directory.BasicAttributes

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

Serializable, Cloneable, Attributes
```
public class BasicAttributes
extends Object
implements Attributes
```
このクラスは、Attributesインタフェースの基本的な実装を提供します。
BasicAttributesは、大文字と小文字の区別ありと、大文字と小文字の区別なしのどちらかになります。このプロパティは、BasicAttributesコンストラクタが呼び出された時点で決定されます。大文字と小文字の区別をしないBasicAttributesの場合は、属性の検索または属性の追加の際に、属性識別子の大文字と小文字は区別されません。大文字と小文字の区別をするBasicAttributesの場合は、大文字と小文字は区別されます。
BasicAttributesクラスがAttributeを作成する必要がある場合、BasicAttributeを使用します。BasicAttributeに依存しているものはほかにありません。
BasicAttributesの変更(属性の追加、削除など)は、該当するディレクトリの属性の表示には影響しません。ディレクトリの変更は、DirContextインタフェースの操作を使用した場合に限り、有効になります。
BasicAttributesインスタンスは、並行マルチスレッド・アクセスに対して同期化されません。単一のBasicAttributesインスタンスをアクセスおよび変更しようとする複数のスレッドによって、オブジェクトはロックされます。

導入されたバージョン:

1.3

関連項目:

DirContext.getAttributes(javax.naming.Name), DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes), DirContext.bind(javax.naming.Name, java.lang.Object, javax.naming.directory.Attributes), DirContext.rebind(javax.naming.Name, java.lang.Object, javax.naming.directory.Attributes), DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes), DirContext.search(javax.naming.Name, javax.naming.directory.Attributes, java.lang.String[]), 直列化された形式

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

コンストラクタ
コンストラクタと説明
`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(Attribute attr)` 属性セットに新しい属性を追加します。
`Attribute`	`put(String attrID, Object val)` 属性セットに新しい属性を追加します。
`Attribute`	`remove(String attrID)` 属性セットから属性ID「attrID」を持つ属性を削除します。
`int`	`size()` 属性セットの属性数を取り込みます。
`String`	`toString()` この属性セットの文字列表記を生成します。

クラス java.lang.Objectから継承されたメソッド
finalize, getClass, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - 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の大文字と小文字は無視される。
    
    戻り値:
    
    この属性セットに以前存在していた同じattrIDを持つ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)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスBasicAttributes

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

メソッドのサマリー

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

コンストラクタの詳細

BasicAttributes

BasicAttributes

BasicAttributes

BasicAttributes

メソッドの詳細

clone

isCaseIgnored

size

get

getAll

getIDs

put

put

remove

toString

equals

hashCode