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)