- 所有超级接口:
-
Context,DirContext,EventContext
包含用于注册监听器以通知目录上下文中命名对象更改时触发的事件的方法。
此接口中的方法支持通过RFC 2254搜索过滤器对对象进行标识。
使用搜索过滤器，可以注册对在注册时不存在但稍后出现并满足过滤器的对象感兴趣。但是，服务提供程序和底层协议/服务可能在支持此功能方面存在限制。如果调用者提交无法以此方式支持的过滤器，addNamingListener()会抛出一个InvalidSearchFilterException。
请参阅EventContext以了解事件源和目标的描述，以及关于监听器注册/注销的信息，这些信息也适用于此接口中的方法。有关线程问题的信息，请参阅包描述。
传递给任何方法的SearchControls或数组对象由调用者拥有。服务提供程序不会修改该对象或保留对其的引用。
- 自1.3版本起:
-
Field Summary
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_PREFIXESFields declared in interface javax.naming.directory.DirContext
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTEFields declared in interface javax.naming.event.EventContext
OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE -
Method Summary
Modifier and TypeMethodDescriptionvoidaddNamingListener(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在目标处的对象修改时触发的命名事件。Methods declared in 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, unbindMethods declared in 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, searchMethods declared in interface javax.naming.event.EventContext
addNamingListener, addNamingListener, removeNamingListener, targetMustExist
-
Method Details
-
addNamingListener
void addNamingListener(Name target, String filter, SearchControls ctls, NamingListener l) throws NamingException 添加一个监听器，用于接收由搜索过滤器filter在目标处的对象修改时触发的命名事件。搜索控件
ctls中的范围、returningObj标志和returningAttributes标志用于控制监听器感兴趣的对象的选择，并确定在最终NamingEvent对象中返回什么信息。请注意，如果请求返回的信息不可用或无法由服务提供程序或服务获取，则NamingEvent对象中可能不会包含这些信息。- 参数:
-
target- 相对于此上下文解析的对象的非空名称。 -
filter- 非空字符串过滤器（参见RFC2254）。 -
ctls- 可能为null的搜索控件。如果为null，则使用默认搜索控件。 -
l- 非空监听器。 - 抛出:
-
NamingException- 如果在添加监听器时遇到问题。 - 参见:
-
addNamingListener
void addNamingListener(String target, String filter, SearchControls ctls, NamingListener l) throws NamingException 添加一个监听器，用于接收由搜索过滤器filter在目标名称处的对象修改时触发的命名事件。有关此方法行为的详细信息，请参阅接受Name的重载。- 参数:
-
target- 相对于此上下文解析的对象的非空字符串名称。 -
filter- 非空字符串过滤器（参见RFC2254）。 -
ctls- 可能为null的搜索控件。如果为null，则使用默认搜索控件。 -
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- 可能为null的过滤器参数数组。 -
ctls- 可能为null的搜索控件。如果为null，则使用默认搜索控件。 -
l- 非空监听器。 - 抛出:
-
NamingException- 如果在添加监听器时遇到问题。 - 参见:
-
addNamingListener
void addNamingListener(String target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l) throws NamingException 添加一个监听器，用于接收由搜索过滤器filter和目标名称处的对象修改时触发的命名事件。有关此方法行为的详细信息，请参阅接受Name的重载。- 参数:
-
target- 相对于此上下文解析的对象的非空字符串名称。 -
filter- 非空字符串过滤器（参见RFC2254）。 -
filterArgs- 可能为null的过滤器参数数组。 -
ctls- 可能为null的搜索控件。如果为null，则使用默认搜索控件。 -
l- 非空监听器。 - 抛出:
-
NamingException- 如果在添加监听器时遇到问题。 - 参见:
-