モジュール java.naming

パッケージ javax.naming.event

インタフェースEventDirContext

すべてのスーパー・インタフェース:

Context, DirContext, EventContext

public interface EventDirContext
extends EventContext, DirContext

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

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

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

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

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

導入されたバージョン:

1.3

フィールドのサマリー

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

インタフェース javax.naming.event.EventContextで宣言されたフィールド

OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE

メソッドのサマリー

修飾子と型	メソッド	説明
void	addNamingListener(String target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l)	リスナーを追加し、文字列ターゲット名によるオブジェクトの指定された際に、検索フィルタfilterおよびフィルタ引数で特定したオブジェクトが修正された場合、トリガーされたネーミング・イベントを受け取れるようにします。
void	addNamingListener(String target, String filter, SearchControls ctls, NamingListener l)	リスナーを追加して、文字列ターゲット名で指定されたオブジェクトにある、検索フィルタfilterで識別されるオブジェクトが変更されたときにトリガーされたネーミング・イベントを受信できるようにします。
void	addNamingListener(Name target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l)	リスナーを追加し、ターゲットに指定されたオブジェクトで、検索フィルタfilterおよびフィルタ引数で特定したオブジェクトが修正された場合、トリガーされたネーミング・イベントを受け取れるようにします。
void	addNamingListener(Name target, String filter, SearchControls ctls, NamingListener l)	リスナーを追加して、ターゲットで指定されたオブジェクトにある、検索フィルタfilterで識別されるオブジェクトが変更されたときにトリガーされたネーミング・イベントを受信できるようにします。

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

インタフェース javax.naming.event.EventContextで宣言されたメソッド

addNamingListener, addNamingListener, removeNamingListener, targetMustExist

メソッドの詳細

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)