モジュール java.naming
パッケージ 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 ディレクトリ・サービス・インタフェースで、オブジェクトに関連付けられている属性のチェックおよび変更のメソッド、およびディレクトリ検索のメソッドを含みます。 -
クラスのサマリー クラス 説明 BasicAttribute このクラスは、Attribute
インタフェースの基本的な実装を提供します。BasicAttributes このクラスは、Attributesインタフェースの基本的な実装を提供します。InitialDirContext このクラスは、ディレクトリ操作を実行するための開始コンテキストです。ModificationItem このクラスは変更項目を表します。SearchControls このクラスは、検索の範囲を決定する要因、および検索の結果として返されたものをカプセル化します。SearchResult このクラスは、DirContext.search()メソッドの結果として返されたNamingEnumerationの項目を表します。 -
例外のサマリー Exception 説明 AttributeInUseException この例外は、すでに存在する属性を追加しようとするとスローされます。AttributeModificationException この例外は、属性の(スキーマ)定義や属性の状態と矛盾する、属性、その識別子、またはその値の追加、削除、または変更を実行しようとするとスローされます。InvalidAttributeIdentifierException この例外は、無効な属性識別子を使って属性を追加または作成しようとした場合にスローされます。InvalidAttributesException この例外は、不完全にまたは不正に指定された属性セットを追加または変更しようとした場合にスローされます。InvalidAttributeValueException このクラスは、属性のスキーマの定義と矛盾する値を属性に追加しようとした場合にスローされます。InvalidSearchControlsException この例外は、検索操作のためのSearchControlsの指定が無効な場合にスローされます。InvalidSearchFilterException この例外は、検索フィルタの指定が無効である場合にスローされます。NoSuchAttributeException この例外は、存在しない属性にアクセスしようとした場合にスローされます。SchemaViolationException この例外は、メソッドがなんらかの形でスキーマに違反した場合にスローされます。