Module java.naming

软件包 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.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

Fields inherited from interface javax.naming.directory.DirContext

ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

Fields inherited from interface javax.naming.event.EventContext

OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE

方法摘要

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

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

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.event.EventContext

addNamingListener, addNamingListener, removeNamingListener, targetMustExist

方法详细信息

addNamingListener

void addNamingListener(Name target,
                       String filter,
                       SearchControls ctls,
                       NamingListener l)
                throws NamingException

添加一个侦听器，用于接收由目标命名的对象由搜索过滤器filter标识的对象时触发的命名事件。

来自搜索控件ctls的范围， ctls标志和ctls标志用于控制对收听者感兴趣的对象的选择，并确定在最终的NamingEvent对象中返回的信息。 请注意，如果NamingEvent对象不可用或无法由服务提供商或服务获取， NamingEvent返回的请求信息可能不存在。

参数

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

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

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

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

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

参数

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

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

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

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

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

l - 非 l的听众。

异常

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

另请参见：

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