模块 java.naming

软件包 javax.naming.event

Interface EventDirContext

All Superinterfaces:

Context ， DirContext ， EventContext

public interface EventDirContextextends EventContext, DirContext

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

此接口中的方法支持RFC 2254搜索过滤器对象的标识 。

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

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

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

从以下版本开始：

1.3

字段汇总

Fields declared in 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 declared in interface javax.naming.directory.DirContext

ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

Fields declared in interface 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对象不可用或服务提供商或服务无法获取， NamingEvent返回的请求信息可能不存在。

参数

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

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

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

l - 非 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 - 可能为空的搜索控件。 如果为null，则使用默认搜索控件。

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

参数

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

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

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

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

l - 非 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 - 过滤器的可能为null的参数数组。

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

l - 非 l的侦听器。

异常

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

另请参见：

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