-
- 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)
-
-