compact3

javax.naming.event

Interface EventDirContext

All Superinterfaces:

Context ， DirContext ， EventContext

public interface EventDirContext
extends EventContext, DirContext

包含用于注册侦听器的方法，以便在目录上下文中指定的对象更改时触发的事件被通知。

该界面中的方法支持通过RFC 2254搜索过滤器识别对象。

使用搜索过滤器，可以注册在注册时不存在的对象的兴趣，但是后来出现并满足过滤器。 但是，在服务提供商和底层协议/服务可以支持的程度上可能会受到限制。 如果调用者以这种方式提交一个不能支持的过滤器， 那么addNamingListener()会抛出一个InvalidSearchFilterException 。

有关事件源和目标的描述以及有关侦听器注册/注销的信息，请参见EventContext ，这些信息也适用于此接口中的方法。 见package description关于线程问题。

作为参数传递给任何方法的SearchControls或数组对象由调用者拥有。 服务提供商不会修改对象或保留对它的引用。

从以下版本开始：

1.3

Field Summary

Fields inherited from interface javax.naming.event.EventContext

OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE

Fields inherited from interface javax.naming.directory.DirContext

ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

Fields inherited from interface 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

方法摘要

Modifier and Type	Method and Description
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标识的对象时触发的命名事件。

Methods inherited from interface javax.naming.event.EventContext

addNamingListener, addNamingListener, removeNamingListener, targetMustExist

Methods inherited from interface 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

Methods inherited from interface 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的范围，returnsObj标志和returnsAttributes标志用于控制对收听者感兴趣的对象的选择，并确定最终NamingEvent对象中返回的信息。 请注意，如果NamingEvent对象不可用或无法由服务提供商或服务获取，则要返回的请求信息可能不存在。

参数

target - 相对于此上下文解析的对象的非空名称。

filter - 非空字符串过滤器（参见RFC2254）。

ctls - 可能为空的搜索控件。 如果为空，则使用默认搜索控件。

l - 非正常听众。

异常

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 - 相对于此上下文解析的对象的非空字符串名称。

filter - 非空字符串过滤器（请参阅RFC2254）。

ctls - 可能为空的搜索控件。 如果为空，则使用默认搜索控件。

l - 非空的侦听器。

异常

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的范围，returnsObj标志和returnsAttributes标志用于控制对收听者感兴趣的对象的选择，并确定最终NamingEvent对象中返回的信息。 请注意，如果服务提供商或服务不可用或无法获取，则所请求的信息可能不会出现在NamingEvent对象中。

参数

target - 相对于此上下文解析的对象的非空名称。

filter - 非空字符串过滤器（参见RFC2254）。

filterArgs - 过滤器的参数可能为空的数组。

ctls - 可能为空的搜索控件。 如果为空，则使用默认搜索控件。

l - 非空的侦听器。

异常

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 - 相对于此上下文解析的对象的非空字符串名称。

filter - 非空字符串过滤器（参见RFC2254）。

filterArgs - 过滤器的参数可能为空的数组。

ctls - 可能为空的搜索控件。 如果为空，则使用默认搜索控件。

l - 非内容侦听器。

异常

NamingException - 如果在添加侦听器时遇到问题。

另请参见：

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