- すべてのスーパー・インタフェース:
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)
-