JavaTM 2 Platform
Standard Ed. 5.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() をオーバーロードする形式として他に、より高度な「検索フィルタ」をサポートするものがあります。

パッケージの仕様

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

関連ドキュメント

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

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

JavaTM 2 Platform
Standard Ed. 5.0

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

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。