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.directory.DirContext から継承されたフィールド

ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

インタフェース 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

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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.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

インタフェース 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

メソッドの詳細

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 - リスナーの追加中に問題が検出された場合。

関連項目:

EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(javax.naming.Name, java.lang.String, javax.naming.directory.SearchControls)

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 - リスナーの追加中に問題が検出された場合。

関連項目:

EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(java.lang.String, java.lang.String, javax.naming.directory.SearchControls)

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 - リスナーの追加中に問題が検出された場合。

関連項目:

EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(javax.naming.Name, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)

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 - リスナーの追加中に問題が検出された場合。

関連項目:

EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(java.lang.String, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)