パッケージ 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 プログラミング言語で作成されたアプリケーションにネーミング機能およびディレクトリ機能を提供します。JNDI は、特定のネーミングまたはディレクトリサービス実装から独立して設計されています。このため、新しいサービスおよびすでに配置されているさまざまなサービスに、共通の方法でアクセスできます。

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

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

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

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

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

検索

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

パッケージの仕様

Java テクノロジの Web サイトでは次のドキュメントを参照できます。

• 『JNDI API Document』 (Postscript)
• 『JNDI API Document』 (PDF)

関連ドキュメント

チュートリアル、例、および概要については、次を参照してください。

• 『The JNDI Tutorial』
• 例
• 『Executive Summary』 (Postscript)
• 『Executive Summary』 (PDF)

導入されたバージョン:

1.3