JavaTM 2 Platform
Standard Ed. 5.0

javax.naming.event
接口 EventDirContext

所有超级接口:
Context, DirContext, EventContext

public interface EventDirContext
extends EventContext, DirContext

包含注册侦听器的一些方法,这些侦听器在目录上下文中命名的对象发生更改时将获得触发事件的通知。

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

通过使用搜索过滤器,使注册在注册时不存在但后来存在并符合过滤器的感兴趣对象成为可能。不过,服务提供程序和底层协议/服务对这种情况的支持程度可能存在限制。如果调用方提交不能以此方式支持的过滤器,则 addNamingListener() 抛出 InvalidSearchFilterException

有关同时适用于此接口方法的事件源和目标的描述,以及关于侦听器注册/注销的信息,请参阅 EventContext。有关线程问题的信息,请参阅包描述

作为参数传递给任何方法的 SearchControls 或数组对象都归调用方所有。服务提供程序将不修改对象,也不保持对它的引用。

从以下版本开始:
1.3

字段摘要
 
从接口 javax.naming.event.EventContext 继承的字段
OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE
 
从接口 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.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
 
方法摘要
 void addNamingListener(Name target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l)
          添加接收命名事件的侦听器,这些事件在修改由 target 指定的对象上的搜索过滤器 filter 和过滤器参数标识的对象时触发。
 void addNamingListener(Name target, String filter, SearchControls ctls, NamingListener l)
          添加接收命名事件的侦听器,这些事件在修改由 target 指定的对象上的搜索过滤器 filter 标识的对象时触发。
 void addNamingListener(String target, String filter, Object[] filterArgs, SearchControls ctls, NamingListener l)
          添加接收命名事件的侦听器,这些事件在修改由字符串目标名称指定的对象上的搜索过滤器 filter 和过滤器参数标识的对象时触发。
 void addNamingListener(String target, String filter, SearchControls ctls, NamingListener l)
          添加接收命名事件的侦听器,这些事件在修改由字符串目标名称指定的对象上的搜索过滤器 filter 标识的对象时触发。
 
从接口 javax.naming.event.EventContext 继承的方法
addNamingListener, addNamingListener, removeNamingListener, targetMustExist
 
从接口 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.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
 

方法详细信息

addNamingListener

void addNamingListener(Name target,
                       String filter,
                       SearchControls ctls,
                       NamingListener l)
                       throws NamingException
添加接收命名事件的侦听器,这些事件在修改由 target 指定的对象上的搜索过滤器 filter 标识的对象时触发。

搜索控件 ctls 的范围、returningObj 标志和 returningAttributes 标志用来控制对侦听器感兴趣对象的选择和确定在最终 NamingEvent 对象中返回的信息。注意,如果要返回的请求信息不可用或者不能通过服务提供程序或服务获取,则这些信息可能不会出现在 NamingEvent 对象中。

参数:
target - 相对于此上下文解析的对象的非 null 名称。
filter - 非 null 字符串过滤器(请参阅 RFC2254)。
ctls - 可能为 null 的搜索控件。如果为 null,则使用默认的搜索控件。
l - 非 null 侦听器。
抛出:
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 - 相对于此上下文解析的对象的非 null 字符串名称。
filter - 非 null 字符串过滤器(请参阅 RFC2254)。
ctls - 可能为 null 的搜索控件。如果为 null,则使用默认的搜索控件。
l - 非 null 侦听器。
抛出:
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
添加接收命名事件的侦听器,这些事件在修改由 target 指定的对象上的搜索过滤器 filter 和过滤器参数标识的对象时触发。搜索控件 ctls 的范围、returningObj 标志和 returningAttributes 标志用来控制对侦听器感兴趣对象的选择和确定在最终 NamingEvent 对象中返回的信息。注意,如果要返回的请求信息不可用或者不能通过服务提供程序或服务获取,则这些信息可能不会出现在 NamingEvent 对象中。

参数:
target - 相对于此上下文解析的对象的非 null 名称。
filter - 非 null 字符串过滤器(请参阅 RFC2254)。
filterArgs - 过滤器参数所组成的数组(可能为 null)。
ctls - 可能为 null 的搜索控件。如果为 null,则使用默认的搜索控件。
l - 非 null 侦听器。
抛出:
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 - 相对于此上下文解析的对象的非 null 字符串名称。
filter - 非 null 字符串过滤器(请参阅 RFC2254)。
filterArgs - 过滤器参数所组成的数组(可能为 null)。
ctls - 可能为 null 的搜索控件。如果为 null,则使用默认的搜索控件。
l - 非 null 侦听器。
抛出:
NamingException - 如果在添加侦听器时遇到问题。
另请参见:
EventContext.removeNamingListener(javax.naming.event.NamingListener), DirContext.search(java.lang.String, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策