- 所有父级接口：
Context,DirContext,EventContext
包含用于注册监听的方法，这些监听将在目录上下文中命名的对象发生更改时收到事件通知。
此接口中的方法支持通过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 -
方法总结
修饰符和类型方法描述voidaddNamingListener(String target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l) 添加一个监听器，用于接收命名事件，当搜索过滤器filter标识的对象和由字符串目标名称命名的对象的过滤器参数被修改时触发。voidaddNamingListener(String target, String filter, SearchControls ctls, NamingListener l) 添加一个监听器，用于接收命名事件，当搜索过滤器filter在由字符串目标名称命名的对象处标识的对象被修改时触发。voidaddNamingListener(Name target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l) 添加一个监听器，用于接收命名事件，当搜索过滤器filter标识的对象和目标命名对象的过滤器参数被修改时触发。voidaddNamingListener(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- 相对于此上下文解析的对象的非空名称。filter- 非空字符串过滤器（参见 RFC2254）。ctls- 可能为空的搜索控件。如果为空，则使用默认搜索控件。l- 非空监听器。- 抛出：
NamingException- 如果在添加监听器时遇到问题。- 参见：
-
addNamingListener
void addNamingListener(String target, String filter, SearchControls ctls, NamingListener l) throws NamingException 添加一个监听器，用于接收命名事件，当搜索过滤器filter在由字符串目标名称命名的对象处标识的对象被修改时触发。有关此方法的行为方式的详细信息，请参阅接受Name的重载。- 参数：
target- 相对于此上下文解析的对象的非空字符串名称。filter- 非空字符串过滤器（参见 RFC2254）。ctls- 可能为空的搜索控件。如果为空，则使用默认搜索控件。l- 非空监听器。- 抛出：
NamingException- 如果在添加监听器时遇到问题。- 参见：
-
addNamingListener
void addNamingListener(Name target, String filter, Object [] filterArgs, SearchControls ctls, NamingListener l) throws NamingException 添加一个监听器，用于接收命名事件，当搜索过滤器filter标识的对象和目标命名对象的过滤器参数被修改时触发。搜索控件ctls中的范围、returningObj 标志和 returningAttributes 标志用于控制监听器感兴趣的对象的选择，并确定在最终的NamingEvent对象中返回哪些信息。请注意，如果服务提供商或服务不可用或无法获取，则要返回的请求信息可能不会出现在NamingEvent对象中。- 参数：
target- 相对于此上下文解析的对象的非空名称。filter- 非空字符串过滤器（参见 RFC2254）。filterArgs- 过滤器的可能为空的参数数组。ctls- 可能为空的搜索控件。如果为空，则使用默认搜索控件。l- 非空监听器。- 抛出：
NamingException- 如果在添加监听器时遇到问题。- 参见：
-
addNamingListener
void addNamingListener(String target, String filter, Object [] filterArgs, SearchControls ctls, NamingListener l) throws NamingException 添加一个监听器，用于接收命名事件，当搜索过滤器filter标识的对象和由字符串目标名称命名的对象的过滤器参数被修改时触发。有关此方法的行为方式的详细信息，请参阅接受Name的重载。- 参数：
target- 相对于此上下文解析的对象的非空字符串名称。filter- 非空字符串过滤器（参见 RFC2254）。filterArgs- 过滤器的可能为空的参数数组。ctls- 可能为空的搜索控件。如果为空，则使用默认搜索控件。l- 非空监听器。- 抛出：
NamingException- 如果在添加监听器时遇到问题。- 参见：
-