JavaTM 2
Platform
Std. Ed. v1.4.0

javax.naming.event
インタフェース EventDirContext

すべてのスーパーインタフェース:
Context, DirContext, EventContext

public interface EventDirContext
extends EventContext, DirContext

ディレクトリコンテキストに指定されたオブジェクトが変更されたときにトリガされたイベントの通知を受け取る、リスナーの登録に関するメソッドを含みます。

このインタフェースにあるメソッドは、RFC 2254 の検索フィルタによるオブジェクトの識別をサポートしています。

検索フィルタを使用すると、登録時に存在しないオブジェクトで配信対象を登録し、後でオブジェクトを作成してフィルタを満たすことが可能になります。ただし、サービスプロバイダや使用するプロトコル/サービスによってはサポート内容に制限がある場合があります。呼び出し側がこの方法ではサポートされていないフィルタを送信した場合、addNamingListener()InvalidSearchFilterException をスローします。

イベントソースとターゲットの説明、およびこのインターフェースのメソッドでも適用できるリスナー登録/登録解除については、EventContext を参照してください。スレッド問題の詳細は、「パッケージの説明」を参照してください。

SearchControls または、パラメータとしてメソッドに渡された配列オブジェクトは、呼び出し側が所有することになります。サービスプロバイダがオブジェクトを修正したり、その参照を保存することはできません。

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

フィールドの概要
 
インタフェース javax.naming.event.EventContext から継承したフィールド
OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE
 
インタフェース javax.naming.Context から継承したフィールド
APPLET, 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
 
インタフェース javax.naming.directory.DirContext から継承したフィールド
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE
 
メソッドの概要
 void addNamingListener(Name target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l)
          リスナーを追加し、ターゲットに指定されたオブジェクトで、検索フィルタ filter およびフィルタ引数で特定したオブジェクトが修正された場合、トリガされたネーミングイベントを受け取れるようにします。
 void addNamingListener(Name target, String filter, SearchControls ctls, NamingListener l)
          リスナーを追加し、ターゲットによるオブジェクトの指定された際に、検索フィルタ filter で特定されたオブジェクトが修正された場合、トリガされたネーミングイベントを受け取れるようにします。
 void addNamingListener(String target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l)
          リスナーを追加し、文字列ターゲット名によるオブジェクトの指定された際に、検索フィルタ filter およびフィルタ引数で特定したオブジェクトが修正された場合、トリガされたネーミングイベントを受け取れるようにします。
 void addNamingListener(String target, String filter, SearchControls ctls, NamingListener l)
          リスナーを追加し、文字列ターゲット名によるオブジェクトの指定された際に、検索フィルタ filter で特定されたオブジェクトが修正された場合、トリガされたネーミングイベントを受け取れるようにします。
 
インタフェース javax.naming.event.EventContext から継承したメソッド
addNamingListener, addNamingListener, removeNamingListener, targetMustExist
 
インタフェース javax.naming.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
 
インタフェース javax.naming.directory.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
 

メソッドの詳細

addNamingListener

public 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 - リスナー追加時に問題が発生した場合
関連項目:
EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(javax.naming.Name, java.lang.String, javax.naming.directory.SearchControls)

addNamingListener

public 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 - リスナー追加時に問題が発生した場合
関連項目:
EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(java.lang.String, java.lang.String, javax.naming.directory.SearchControls)

addNamingListener

public 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 - リスナー追加時に問題が発生した場合
関連項目:
EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(javax.naming.Name, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)

addNamingListener

public 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 - リスナー追加時に問題が発生した場合
関連項目:
EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(java.lang.String, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)

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.