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) 添加接收命名事件的偵聽器，這些事件在修改由 target 指定的物件上的搜尋過濾器 filter 和過濾器參數標識的物件時觸發。
void	addNamingListener(Name target, String filter, SearchControls ctls, NamingListener l) 添加接收命名事件的偵聽器，這些事件在修改由 target 指定的物件上的搜尋過濾器 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

添加接收命名事件的偵聽器，這些事件在修改由 target 指定的物件上的搜尋過濾器 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

添加接收命名事件的偵聽器，這些事件在修改由 target 指定的物件上的搜尋過濾器 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)