インタフェースEventDirContext
- すべてのスーパー・インタフェース:
Context, DirContext, EventContext
public interface EventDirContext extends EventContext, DirContext
ディレクトリ・コンテキストに指定されたオブジェクトが変更されたときにトリガーされたイベントの通知を受け取る、リスナーの登録に関するメソッドを含みます。
このインタフェースにあるメソッドは、RFC 2254の検索フィルタによるオブジェクトの識別をサポートしています。
検索フィルタを使用すると、登録時に存在しないオブジェクトで配信対象を登録し、後でオブジェクトを作成してフィルタを満たすことが可能になります。 ただし、サービス・プロバイダや使用するプロトコル/サービスによってはサポート内容に制限がある場合があります。 この方法でサポートできないフィルタをコール元が発行した場合、addNamingListener()はInvalidSearchFilterExceptionをスローします。
イベント・ソースとイベント・ターゲットの説明、およびこのインタフェースのメソッドにも適用可能なリスナーの登録/登録解除に関する情報は、EventContextを参照してください。 スレッド問題の詳細は、パッケージの説明を参照してください。
任意のメソッドにパラメータとして渡されたSearchControlsまたは配列オブジェクトは、コール元によって所有されます。 サービス・プロバイダはオブジェクトを変更せず、そのオブジェクトに対する参照も保持しません。
- 導入されたバージョン:
- 1.3
-
フィールドのサマリー
インタフェースContextで宣言されたフィールド
AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES修飾子と型フィールド説明static final String要求されたサービスの権限を指定するための、環境プロパティの名前を保持する定数です。static final Stringサービスのプロトコルによってデータを返すときに使用するバッチ・サイズを指定するための、環境プロパティの名前を保持する定数です。static final StringJNDI URLコンテキスト(dns://somehost/wiz.comなど)に使用するDNSホスト名およびドメイン名を指定するための、環境プロパティの名前を保持する定数です。static final String使用する初期コンテキスト・ファクトリを指定するための、環境プロパティの名前を保持する定数です。static final Stringサービスに使用する優先言語を指定するための、環境プロパティの名前を保持する定数です。static final String使用するオブジェクト・ファクトリのリストを指定するための、環境プロパティの名前を保持する定数です。static final String使用するサービス・プロバイダの構成情報を指定するための、環境プロパティの名前を保持する定数です。static final Stringサービス・プロバイダによって参照が処理される方法を指定するための、環境プロパティの名前を保持する定数です。static final String使用するセキュリティ・レベルを指定するための、環境プロパティの名前を保持する定数です。static final Stringサービスに対する呼出し側を認証する主体の資格を指定するための、環境プロパティの名前を保持する定数です。static final Stringサービスに対する呼出し側を認証する主体の識別情報を指定するための、環境プロパティの名前を保持する定数です。static final String使用するセキュリティ・プロトコルを指定するための、環境プロパティの名前を保持する定数です。static final String使用する状態ファクトリのリストを指定するための、環境プロパティの名前を保持する定数です。static final StringURLコンテキスト・ファクトリをロードするときに使用するパッケージ接頭辞のリストを指定するための、環境プロパティの名前を保持する定数です。インタフェースで宣言されたフィールド DirContext
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE修飾子と型フィールド説明static final intこの定数は、指定された値で属性を追加することを指定します。static final intこの定数は、指定された属性値を属性から削除することを指定します。static final intこの定数は、指定された値で属性を置換することを指定します。インタフェースで宣言されたフィールド EventContext
OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE修飾子と型フィールド説明static final intターゲットに指定されたオブジェクトに関するイベントを通知するかどうかを指定する定数です。static final intターゲットに指定されたコンテキストのオブジェクトに関するイベントを通知するかどうかを指定する定数です。ターゲットに指定されたコンテキストは除きます。static final intターゲットに指定されたコンテキストのサブツリーにあるオブジェクトに関するイベントを、通知するかどうかを指定する定数です。ターゲットに指定されたオブジェクトも含みます。 -
メソッドのサマリー
修飾子と型メソッド説明voidaddNamingListener(String target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l) 検索フィルタfilterで識別されるオブジェクトおよび文字列ターゲット名で指定されたオブジェクトのフィルタ引数が変更された場合に起動されるネーミング・イベントを受信するリスナーを追加します。voidaddNamingListener(String target, String filter, SearchControls ctls, NamingListener l) 文字列ターゲット名で指定されたオブジェクトの検索フィルタfilterで識別されるオブジェクトが変更されたときに起動されるネーミング・イベントを受信するためのリスナーを追加します。voidaddNamingListener(Name target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l) 検索フィルタfilterで識別されるオブジェクトおよびターゲットで指定されたオブジェクトのフィルタ引数が変更された場合に起動されるネーミング・イベントを受信するリスナーを追加します。voidaddNamingListener(Name target, String filter, SearchControls ctls, NamingListener l) ターゲットで指定されたオブジェクトの検索フィルタfilterで識別されるオブジェクトが変更されたときに起動されるネーミング・イベントを受信するためのリスナーを追加します。インタフェースContextで宣言されたメソッド
addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getEnvironment, getNameInNamespace, getNameParser, getNameParser, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind修飾子と型メソッド説明addToEnvironment(String propName, Object propVal) このコンテキストの環境に、新しい環境プロパティを追加します。void名前をオブジェクトにバインドします。void名前をオブジェクトにバインドします。voidclose()このコンテキストを閉じます。composeName(String name, String prefix) このコンテキストを基準にした名前を持つこのコンテキストの名前を変換します。composeName(Name name, Name prefix) このコンテキストを基準にした名前を持つこのコンテキストの名前を変換します。createSubcontext(String name) 新しいコンテキストを作成してバインドします。createSubcontext(Name name) 新しいコンテキストを作成してバインドします。voiddestroySubcontext(String name) 名前付きコンテキストを破棄し、名前空間から削除します。voiddestroySubcontext(Name name) 名前付きコンテキストを破棄し、名前空間から削除します。Hashtable<?, ?> このコンテキストで有効な環境を取得します。独自の名前空間でこのコンテキストの完全な名前を取得します。getNameParser(String name) 名前付きコンテキストに関連したパーサーを取得します。getNameParser(Name name) 名前付きコンテキストに関連したパーサーを取得します。バインドされたオブジェクトのクラス名とともに、名前付きコンテキストでバインドされた名前を列挙します。バインドされたオブジェクトのクラス名とともに、名前付きコンテキストでバインドされた名前を列挙します。listBindings(String name) バインドされたオブジェクトとともに、名前付きコンテキストでバインドされた名前を列挙します。listBindings(Name name) バインドされたオブジェクトとともに、名前付きコンテキストでバインドされた名前を列挙します。名前付きオブジェクトを取得します。名前付きオブジェクトを取得します。lookupLink(String name) 名前の終端の基本コンポーネントを除くリンクをともなう、名前付きオブジェクトを取得します。lookupLink(Name name) 名前の終端の基本コンポーネントを除くリンクをともなう、名前付きオブジェクトを取得します。void名前をオブジェクトにバインドし、既存のバインディングを上書きします。void名前をオブジェクトにバインドし、既存のバインディングを上書きします。removeFromEnvironment(String propName) このコンテキストの環境から環境プロパティを削除します。void新しい名前を、以前の名前にバインドされたオブジェクトにバインドし、以前の名前をアンバインドします。void新しい名前を、以前の名前にバインドされたオブジェクトにバインドし、以前の名前をアンバインドします。void名前付きオブジェクトをアンバインドします。void名前付きオブジェクトをアンバインドします。インタフェースで宣言されたメソッド DirContext
bind, bind, createSubcontext, createSubcontext, getAttributes, getAttributes, getAttributes, getAttributes, getSchema, getSchema, getSchemaClassDefinition, getSchemaClassDefinition, modifyAttributes, modifyAttributes, modifyAttributes, modifyAttributes, rebind, rebind, search, search, search, search, search, search, search, search修飾子と型メソッド説明voidbind(String name, Object obj, Attributes attrs) 関連付けられている属性とともに、名前をオブジェクトにバインドします。voidbind(Name name, Object obj, Attributes attrs) 関連付けられている属性とともに、名前をオブジェクトにバインドします。createSubcontext(String name, Attributes attrs) 関連付けられている属性とともに、名前をオブジェクトにバインドします。createSubcontext(Name name, Attributes attrs) 関連付けられている属性とともに、名前をオブジェクトにバインドします。getAttributes(String name) 名前付きオブジェクトに関連付けられている属性をすべて取得します。getAttributes(String name, String[] attrIds) 名前付きオブジェクトに関連付けられている属性で選択されたものを取得します。getAttributes(Name name) 名前付きオブジェクトに関連付けられている属性をすべて取得します。getAttributes(Name name, String[] attrIds) 名前付きオブジェクトに関連付けられている属性で選択されたものを取得します。名前付きオブジェクトに関連したスキーマを取得します。名前付きオブジェクトに関連したスキーマを取得します。指定されたオブジェクトのクラス定義のスキーマ・オブジェクトを含むコンテキストを取得します。getSchemaClassDefinition(Name name) 指定されたオブジェクトのクラス定義のスキーマ・オブジェクトを含むコンテキストを取得します。voidmodifyAttributes(String name, int mod_op, Attributes attrs) 名前付きオブジェクトに関連付けられている属性を変更します。voidmodifyAttributes(String name, ModificationItem[] mods) 順序付けされた変更リストを使用して、指定されたオブジェクトに関連付けられている属性を変更します。voidmodifyAttributes(Name name, int mod_op, Attributes attrs) 名前付きオブジェクトに関連付けられている属性を変更します。voidmodifyAttributes(Name name, ModificationItem[] mods) 順序付けされた変更リストを使用して、指定されたオブジェクトに関連付けられている属性を変更します。voidrebind(String name, Object obj, Attributes attrs) 関連付けられている属性とともに名前をオブジェクトにバインドし、既存のバインディングをオーバーライドします。voidrebind(Name name, Object obj, Attributes attrs) 関連付けられている属性とともに名前をオブジェクトにバインドし、既存のバインディングをオーバーライドします。search(String name, String filterExpr, Object[] filterArgs, SearchControls cons) 名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。search(String name, String filter, SearchControls cons) 名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。search(String name, Attributes matchingAttributes) 指定された属性のセットを含むオブジェクトを単一コンテキストで検索します。search(String name, Attributes matchingAttributes, String[] attributesToReturn) 指定された属性のセットを含むオブジェクトを単一コンテキストで検索し、選択した属性を取得します。search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons) 名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。search(Name name, String filter, SearchControls cons) 名前付きコンテキストまたは名前付きオブジェクトで、指定された検索フィルタを満たすエントリを検索します。search(Name name, Attributes matchingAttributes) 指定された属性のセットを含むオブジェクトを単一コンテキストで検索します。search(Name name, Attributes matchingAttributes, String[] attributesToReturn) 指定された属性のセットを含むオブジェクトを単一コンテキストで検索し、選択した属性を取得します。インタフェースで宣言されたメソッド EventContext
addNamingListener, addNamingListener, removeNamingListener, targetMustExist修飾子と型メソッド説明voidaddNamingListener(String target, int scope, NamingListener l) リスナーを追加して、文字列のターゲット名およびスコープで特定したオブジェクトの変更時に、トリガーされた名前付きイベントを受け取れるようにします。voidaddNamingListener(Name target, int scope, NamingListener l) リスナーを追加して、ターゲットおよびスコープで特定オブジェクトの変更時にトリガーされた、名前付きイベントを受け取れるようにします。voidこのEventContextによって起動されたネーミング・イベントの受信からリスナーを削除します。boolean存在しないターゲットで、リスナーが配信処理を登録できるかどうか判定します。
-
メソッドの詳細
-
addNamingListener
void addNamingListener(Name target, String filter, SearchControls ctls, NamingListener l) throws NamingException ターゲットで指定されたオブジェクトの検索フィルタfilterで識別されるオブジェクトが変更されたときに起動されるネーミング・イベントを受信するためのリスナーを追加します。検索コントロール
ctlsのスコープ、returningObjフラグおよびreturningAttributesフラグは、リスナーが対象とするオブジェクトの選択を制御し、最終的なNamingEventオブジェクトで返される情報を決定するために使用されます。 返されるリクエストされた情報は、NamingEventオブジェクトに存在しないか、サービス・プロバイダまたはサービスによって取得できなかった場合、存在しない可能性があります。- パラメータ:
target- このコンテキストを基準にして解決されたオブジェクトのnull以外の名前。filter- null以外の文字列フィルタ(RFC2254を参照)。ctls- nullの可能性がある検索コントロール。 nullの場合、デフォルトの検索コントロールが使用される。l- null以外のリスナー。- スロー:
NamingException- リスナーの追加中に問題が検出された場合。- 関連項目:
-
addNamingListener
void addNamingListener(String target, String filter, SearchControls ctls, NamingListener l) throws NamingException 文字列ターゲット名で指定されたオブジェクトの検索フィルタfilterで識別されるオブジェクトが変更されたときに起動されるネーミング・イベントを受信するためのリスナーを追加します。 このメソッドの動作の詳細は、Nameを受け入れるオーバーロードを参照してください。- パラメータ:
target- このコンテキストを基準にして解決されたオブジェクトのnull以外の文字列名。filter- null以外の文字列フィルタ(RFC2254を参照)。ctls- nullの可能性がある検索コントロール。 nullの場合、デフォルトの検索コントロールが使用される。l- null以外のリスナー。- スロー:
NamingException- リスナーの追加中に問題が検出された場合。- 関連項目:
-
addNamingListener
void addNamingListener(Name target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l) throws NamingException 検索フィルタfilterで識別されるオブジェクトおよびターゲットで指定されたオブジェクトのフィルタ引数が変更された場合に起動されるネーミング・イベントを受信するリスナーを追加します。 検索コントロールctlsのスコープ、returningObjフラグおよびreturningAttributesフラグは、リスナーが対象とするオブジェクトの選択を制御し、最終的なNamingEventオブジェクトで返される情報を決定するために使用されます。 返されるリクエストされた情報は、NamingEventオブジェクトに存在しないか、サービス・プロバイダまたはサービスによって取得できなかった場合、存在しない可能性があります。- パラメータ:
target- このコンテキストを基準にして解決されたオブジェクトのnull以外の名前。filter- null以外の文字列フィルタ(RFC2254を参照)。filterArgs- フィルタに対する引数のnullの可能性がある配列。ctls- nullの可能性がある検索コントロール。 nullの場合、デフォルトの検索コントロールが使用される。l- null以外のリスナー。- スロー:
NamingException- リスナーの追加中に問題が検出された場合。- 関連項目:
-
addNamingListener
void addNamingListener(String target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l) throws NamingException 検索フィルタfilterで識別されるオブジェクトおよび文字列ターゲット名で指定されたオブジェクトのフィルタ引数が変更された場合に起動されるネーミング・イベントを受信するリスナーを追加します。 このメソッドの動作の詳細は、Nameを受け入れるオーバーロードを参照してください。- パラメータ:
target- このコンテキストを基準にして解決されたオブジェクトのnull以外の文字列名。filter- null以外の文字列フィルタ(RFC2254を参照)。filterArgs- フィルタに対する引数のnullの可能性がある配列。ctls- nullの可能性がある検索コントロール。 nullの場合、デフォルトの検索コントロールが使用される。l- null以外のリスナー。- スロー:
NamingException- リスナーの追加中に問題が検出された場合。- 関連項目:
-