JavaTM 2
Platform
Std. Ed. v1.4.0

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

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

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

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

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

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

検索

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

パッケージの仕様

Java technology web サイトでは次のドキュメントを参照できます。

関連項目

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

導入されたバージョン:
1.3

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.