モジュール java.naming
パッケージjavax.naming.directory
パッケージjavax.naming.directory
javax.namingパッケージを拡張して、ディレクトリ・サービスにアクセスするための機能を提供します。
このパッケージは、Java Naming and Directory Interface (JNDI)のディレクトリ操作を定義します。 JNDIは、Javaプログラミング言語で記述されたアプリケーションにネーミングおよびディレクトリ機能を提供します。 ほかのネームおよびディレクトリ・サービスの実装と独立して動作するように設計されています。 新しいサービス、展開されつつあるサービス、すでに展開されているサービスなど、さまざまなサービスに対して共通の方法でアクセスすることができます。
このパッケージによってアプリケーションは、ディレクトリに格納されているオブジェクトに関連付けられている属性を検索および変更すること、および指定された属性を使用してオブジェクトを検索できます。
ディレクトリ・コンテキスト
DirContextインタフェースは、「ディレクトリ・コンテキスト」を表します。 このインタフェースは、directory object、あるいは場合によって呼び出されることのあるdirectory entryに関連付けられている属性のチェックおよび変更のためのメソッドを定義します。
getAttributes()を使用して、ディレクトリ・オブジェクト(名前を指定する対象)に関連付けられた属性を取得します。 属性は、modifyAttributes()を使用して変更されます。 この操作を使用して、属性またはその値、あるいはその両方を追加、置換、または削除できます。
DirContextは、javax.namingパッケージのContextインタフェースを拡張することによって、ネーミング・コンテキストとしても動作します。 つまり、任意のディレクトリ・オブジェクトからネーミング・コンテキストを提供できます。 たとえば個人のディレクトリ・オブジェクトは、その個人の属性を含み、同時に、プリンタやホーム・ディレクトリなどその個人に関連するネーミング・オブジェクトのコンテキストを提供できます。
Searches
DirContextには、ディレクトリのコンテンツ・ベースの検索を実行するためのメソッドが含まれています。 最も簡単で最も一般的な使用方法形式では、マッチする属性のセット--おそらく特定の値で--が指定され、この属性セットがsearch()メソッドに送信されます。 より高度な「検索フィルタ」をサポートする、その他のオーバーロード形式のsearch()があります。
パッケージの仕様
JNDI APIの仕様と関連ドキュメントについては、「JNDIのドキュメント」を参照してください。- 導入されたバージョン:
- 1.3
-
クラス説明このインタフェースは指定したオブジェクトに関連付けられている属性を表します。この例外は、すでに存在する属性を追加しようとするとスローされます。この例外は、属性の(スキーマ)定義や属性の状態と矛盾する、属性、その識別子、またはその値の追加、削除、または変更を実行しようとするとスローされます。このインタフェースは属性のコレクションを表します。このクラスは、
Attributeインタフェースの基本的な実装を提供します。このクラスは、Attributesインタフェースの基本的な実装を提供します。ディレクトリ・サービス・インタフェースで、オブジェクトに関連付けられている属性のチェックおよび変更のメソッド、およびディレクトリ検索のメソッドを含みます。このクラスは、ディレクトリ操作を実行するための開始コンテキストです。この例外は、無効な属性識別子を使って属性を追加または作成しようとした場合にスローされます。この例外は、不完全にまたは不正に指定された属性セットを追加または変更しようとした場合にスローされます。このクラスは、属性のスキーマの定義と矛盾する値を属性に追加しようとした場合にスローされます。この例外は、検索操作のためのSearchControlsの指定が無効な場合にスローされます。この例外は、検索フィルタの指定が無効である場合にスローされます。このクラスは変更項目を表します。この例外は、存在しない属性にアクセスしようとした場合にスローされます。この例外は、メソッドがなんらかの形でスキーマに違反した場合にスローされます。このクラスは、検索の範囲を決定する要因、および検索の結果として返されたものをカプセル化します。このクラスは、DirContext.search()メソッドの結果として返されたNamingEnumerationの項目を表します。