- すべての実装されたインタフェース:
Serializable
,Cloneable
,Attribute
Attribute
インタフェースの基本的な実装を提供します。
この実装では、スキーマ・メソッドgetAttributeDefinition()
およびgetAttributeSyntaxDefinition()
はサポートされていません。 単にOperationNotSupportedException
をスローします。 BasicAttribute
のサブクラスは、これらのメソッドがサポートされている場合はオーバーライドする必要があります。
BasicAttribute
クラスは、デフォルトでObject.equals()
を使用して、等価のテスト時または値の検索時に、値が配列の場合は「除く」の属性値の等価性を判断します。 配列の場合、配列の各要素がObject.equals()
を使用してチェックされます。 BasicAttribute
のサブクラスは、同様の等価性チェックを行うときに、スキーマの使用が意味のあるメソッドをオーバーライドすることで、スキーマ情報を使用できます。 同様に、BasicAttribute
クラスは、デフォルトでそのコンストラクタに渡された値、またはadd/removeメソッドを使用して操作された値(あるいはその両方)を返します。 BasicAttribute
のサブクラスは、get()
およびgetAll()
をオーバーライドして、ディレクトリ(または、BasicAttribute
をサブクラス化するのではなく、Attribute
インタフェースを直接実装)から動的に値を取得できます。
BasicAttribute
(値の追加や削除など)の更新は、ディレクトリ内の属性の対応する表現には影響しないことに注意してください。 ディレクトリの更新は、DirContext
インタフェースの操作を使用してのみ変更できます。
BasicAttribute
インスタンスは、同時マルチスレッド・アクセスに対して同期されません。 複数のスレッドがBasicAttribute
にアクセスして変更しようとすると、オブジェクトがロックされます。
- 導入されたバージョン:
- 1.3
- 関連項目:
-
フィールドのサマリー
フィールド -
コンストラクタのサマリー
コンストラクタコンストラクタ説明BasicAttribute
(String id) 順序付けされていない属性のインスタンスを値なしで新しく構築します。BasicAttribute
(String id, boolean ordered) 順序付けされる可能性のある属性のインスタンスを値なしで新しく構築します。BasicAttribute
(String id, Object value) 順序付けされていない属性のインスタンスを単一の値で新しく構築します。BasicAttribute
(String id, Object value, boolean ordered) 順序付けされる可能性のある属性のインスタンスを単一の値で新しく構築します。 -
メソッドのサマリー
修飾子と型メソッド説明void
属性値を属性値の順序付けられたリストに追加します。boolean
この属性に新しい値を追加します。void
clear()
この属性からすべての値を削除します。clone()
属性のコピーを作成します。boolean
値がこの属性にあるかどうかを判定します。boolean
objがこの属性と同一かどうかを判別します。get()
この属性の値の1つを検出します。get
(int ix) 属性値の順序付けられたリストから属性値を取り出します。getAll()
この属性の値の列挙を取り出します。この属性のスキーマ定義を取り出します。この属性に関連付けられている構文の定義を検索します。getID()
この属性のIDを取り出します。int
hashCode()
この属性のハッシュ・コードを計算します。boolean
属性値が順序付けられているかどうかを判別します。remove
(int ix) 属性値の順序付けられたリストから属性値を削除します。boolean
指定された値をこの属性から削除します。属性値の順序付けられたリストの属性値を設定します。int
size()
この属性の値数を取り出します。toString()
この属性の文字列表記を生成します。
-
フィールド詳細
-
attrID
protected String attrID属性のIDを保持します。 IDはpublicコンストラクタによって初期化され、attrIDを使用しているBasicAttributeのメソッドがオーバーライドされていない限り、nullにできません。 -
values
-
ordered
protected boolean orderedこの属性の値が順序付けされるかどうかを記録するフラグです。
-
-
コンストラクタの詳細
-
BasicAttribute
-
BasicAttribute
-
BasicAttribute
public BasicAttribute(String id, boolean ordered) 順序付けされる可能性のある属性のインスタンスを値なしで新しく構築します。- パラメータ:
id
- 属性のID。 nullは不可。ordered
- trueは、属性の値が順序付けされることを示す。それ以外の場合はfalse。
-
BasicAttribute
-
-
メソッドの詳細
-
clone
-
equals
public boolean equals(Object obj) objがこの属性と同一かどうかを判別します。 2つの属性の属性ID、構文、および値が等しい場合、2つの属性は同一です。 2つの属性の値が順序付けされていない場合、値が追加された順序は関係ありません。 属性値が順序付けされている場合、値の順序は一致する必要があります。 objがnullであるか、またはAttributeではない場合、falseが返されます。デフォルトでは、値が配列の場合を除き、属性IDとその値を比較するときに
Object.equals()
が使用されます。 配列の場合、配列の各要素がObject.equals()
を使用してチェックされます。 サブクラスはこれをオーバーライドして、スキーマ構文情報、および2つの属性にとって同一が何を意味するかを定義する一致規則を使用できます。 サブクラスがスキーマ情報を使用するかどうか、またどのように使用するかは、サブクラスが決定します。 サブクラスがequals()
をオーバーライドする場合、同じ2つの属性が同じハッシュ・コードを持つように、hashCode()
もオーバーライドする必要があります。 -
hashCode
-
toString
-
getAll
public NamingEnumeration<?> getAll() throws NamingExceptionこの属性の値の列挙を取り出します。デフォルトでは、戻り値は、コンストラクタに渡された値、または追加置換削除メソッドを使用して処理された値、あるいはその両方です。 サブクラスはこの値をオーバーライドして、ディレクトリから直接値を検出できます。
- 定義:
getAll
、インタフェースAttribute
- 戻り値:
- 属性値のnull以外の列挙。 列挙の各要素はnullオブジェクトの可能性がある。 オブジェクトのクラスは属性値のクラスである。 属性値がnullの場合は要素はnullになる。 属性にゼロ値が含まれる場合は空の列挙が返される。
- 例外:
NamingException
- 値の取得中にネーミング例外が検出された場合。- 関連項目:
-
get
public Object get() throws NamingExceptionこの属性の値の1つを検出します。デフォルトでは、戻り値は、コンストラクタに渡された値、または追加置換削除メソッドを使用して処理された値、あるいはその両方のうちの1つです。 サブクラスはこの値をオーバーライドして、ディレクトリから直接値を検出できます。
- 定義:
get
、インタフェースAttribute
- 戻り値:
- nullの可能性がある、属性値の1つを表すオブジェクト。 属性値がnullの場合はnull。
- 例外:
NamingException
- 値の取得中にネーミング例外が検出された場合。
-
size
-
getID
-
contains
public boolean contains(Object attrVal) 値がこの属性にあるかどうかを判定します。デフォルトでは、
Object.equals()
は、attrVal
が配列の場合を除き、attrVal
をこの属性の値と比較するときに使用されます。 配列の場合、配列の各要素がObject.equals()
を使用してチェックされます。 サブクラスがスキーマ情報を使用して同一性を判定する場合があります。 -
add
public boolean add(Object attrVal) この属性に新しい値を追加します。デフォルトでは、
Object.equals()
は、attrVal
が配列の場合を除き、attrVal
をこの属性の値と比較するときに使用されます。 配列の場合、配列の各要素がObject.equals()
を使用してチェックされます。 サブクラスがスキーマ情報を使用して同一性を判定する場合があります。 -
remove
public boolean remove(Object attrval) 指定された値をこの属性から削除します。デフォルトでは、
Object.equals()
は、attrVal
が配列の場合を除き、attrVal
をこの属性の値と比較するときに使用されます。 配列の場合、配列の各要素がObject.equals()
を使用してチェックされます。 サブクラスがスキーマ情報を使用して同一性を判定する場合があります。 -
clear
-
isOrdered
-
get
public Object get(int ix) throws NamingException インタフェースからコピーされた説明:Attribute
属性値の順序付けられたリストから属性値を取り出します。 このメソッドは、属性値のリストのix
索引の値を返します。 属性値が順序付けられていない場合、このメソッドはそのインデックスの位置にある値を返します。- 定義:
get
、インタフェースAttribute
- パラメータ:
ix
- 属性値の順序付けられたリスト内の値のインデックス。0 <= ix < size()
。- 戻り値:
- 索引
ix
でNULLの可能性がある属性値。属性値がnullの場合はnull。 - 例外:
NamingException
- 値の取得中にネーミング例外が検出された場合。
-
remove
-
add
-
set
インタフェースからコピーされた説明:Attribute
属性値の順序付けられたリストの属性値を設定します。 このメソッドは、属性値のリストのix
索引の値をattrVal
に設定します。 古い値は削除されます。 属性値が順序付けされていない場合、このメソッドは、attrVal
がすでにいずれかの値でないかぎり、その索引にある値にattrVal
を設定します。 その場合は、IllegalStateException
がスローされます。 -
getAttributeSyntaxDefinition
public DirContext getAttributeSyntaxDefinition() throws NamingExceptionこの属性に関連付けられている構文の定義を検索します。このメソッドはデフォルトではOperationNotSupportedExceptionをスローします。 サブクラスがスキーマをサポートする場合、サブクラスがこのメソッドをオーバーライドします。
- 定義:
getAttributeSyntaxDefinition
、インタフェースAttribute
- 戻り値:
- 属性の構文定義。 実装がスキーマをサポートしても、この特定の属性にスキーマ情報が含まれていない場合はnull。
- 例外:
OperationNotSupportedException
- スキーマの取得がサポートされていない場合。NamingException
- スキーマの取得中にネーミング例外が発生した場合。
-
getAttributeDefinition
public DirContext getAttributeDefinition() throws NamingExceptionこの属性のスキーマ定義を取り出します。このメソッドはデフォルトではOperationNotSupportedExceptionをスローします。 サブクラスがスキーマをサポートする場合、サブクラスがこのメソッドをオーバーライドします。
- 定義:
getAttributeDefinition
、インタフェースAttribute
- 戻り値:
- この属性のスキーマ定義。 実装がスキーマをサポートしても、この特定の属性にスキーマ情報が含まれていない場合はnull。
- 例外:
OperationNotSupportedException
- スキーマの取得がサポートされていない場合。NamingException
- スキーマの取得中にネーミング例外が発生した場合。
-