パッケージ 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