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