-
- All Superinterfaces:
-
Context
,DirContext
,EventContext
public interface EventDirContext extends EventContext, DirContext
包含注册侦听器的方法,以便在目录上下文中指定的对象发生更改时触发事件。使用搜索过滤器,可以注册对在注册时不存在但后来存在并满足过滤器的对象的兴趣。 但是,服务提供商和底层协议/服务可以支持的程度可能存在限制。 如果调用者提交了以这种方式不支持的过滤器,则
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)
-
-