パッケージ javax.naming.directory

javax.naming パッケージを拡張して、ディレクトリサービスにアクセスする機能を提供します。

参照: 説明

インタフェースのサマリー

インタフェース	説明
Attribute	このインタフェースは指定したオブジェクトに関連付けられている属性を表します。
Attributes	このインタフェースは属性のコレクションを表します。
DirContext	ディレクトリサービスインタフェースで、オブジェクトに関連付けられている属性のチェックおよび変更のメソッド、およびディレクトリ検索のメソッドを含みます。

クラスのサマリー

クラス	説明
BasicAttribute	このクラスは、Attribute インタフェースの基本的な実装を提供します。
BasicAttributes	このクラスは、Attributes インタフェースの基本的な実装を提供します。
InitialDirContext	このクラスは、ディレクトリ操作を実行するための開始コンテキストです。
ModificationItem	このクラスは変更項目を表します。
SearchControls	このクラスは、検索の範囲を決定する要因、および検索の結果として返されたものをカプセル化します。
SearchResult	このクラスは、DirContext.search() メソッドの結果として返された NamingEnumeration の項目を表します。

例外のサマリー

例外	説明
AttributeInUseException	この例外は、すでに存在する属性を追加しようとするとスローされます。
AttributeModificationException	この例外は、属性の (スキーマ) 定義や属性の状態と矛盾する、属性、その識別子、またはその値の追加、削除、または変更を実行しようとするとスローされます。
InvalidAttributeIdentifierException	この例外は、無効な属性識別子を使って属性を追加または作成しようとした場合にスローされます。
InvalidAttributesException	この例外は、不完全にまたは不正に指定された属性セットを追加または変更しようとした場合にスローされます。
InvalidAttributeValueException	このクラスは、属性のスキーマの定義と矛盾する値を属性に追加しようとした場合にスローされます。
InvalidSearchControlsException	この例外は、検索操作のための SearchControls の指定が無効な場合にスローされます。
InvalidSearchFilterException	この例外は、検索フィルタの指定が無効である場合にスローされます。
NoSuchAttributeException	この例外は、存在しない属性にアクセスしようとした場合にスローされます。
SchemaViolationException	この例外は、メソッドが何らかの形でスキーマに違反した場合にスローされます。

パッケージ javax.naming.directory の説明

javax.naming パッケージを拡張して、ディレクトリサービスにアクセスする機能を提供します。

このパッケージは、Java Naming and Directory Interface^TM (JNDI) のディレクトリ操作を定義します。 JNDI は、Java プログラミング言語で記述されたアプリケーションにネーミングおよびディレクトリ機能を提供します。ほかのネームおよびディレクトリサービスの実装と独立して動作するように設計されています。新しいサービス、展開されつつあるサービス、すでに展開されているサービスなど、さまざまなサービスに対して共通の方法でアクセスすることができます。

このパッケージによってアプリケーションは、ディレクトリに格納されているオブジェクトに関連付けられている属性を検索および変更すること、および指定された属性を使用してオブジェクトを検索できます。

ディレクトリコンテキスト

DirContext インタフェースは、directory context を表します。このインタフェースは、directory object、あるいは場合によって呼び出されることのある directory entry に関連付けられている属性のチェックおよび変更のためのメソッドを定義します。

getAttributes() を使用して、指定した名前のディレクトリオブジェクトに関連付けられている属性を検索します。属性は modifyAttributes() を使用して変更されます。この操作を使用して、属性またはその値、あるいはその両方を追加、置換、または削除できます。

javax.naming パッケージの Context インタフェースを拡張すると、DirContext はネーミングコンテキストとしての役目もします。つまり、任意のディレクトリオブジェクトからネーミングコンテキストを提供できます。たとえば個人のディレクトリオブジェクトは、その個人の属性を含み、同時に、プリンタやホームディレクトリなどその個人に関連するネーミングオブジェクトのコンテキストを提供できます。

検索

DirContext は、ディレクトリの内容ベースの検索を実行するメソッドを含んでいます。もっとも単純で一般的な使用法では、一致する属性のセット、および場合によっては特定の値をアプリケーションが指定し、その属性セットを search() メソッドに伝えます。search() をオーバーロードする形式としてほかに、より高度な検索フィルタをサポートするものがあります。

パッケージの仕様

JNDI API の仕様と関連ドキュメントについては、「JNDI のドキュメント」を参照してください。

導入されたバージョン:

1.3