当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版
javax.naming.event
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
EventDirContext (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
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.directory.DirContext 继承的字段 |
|---|
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE |
| 方法摘要 | |
|---|---|
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.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 Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。