Java javax.naming.event 类 NamingEvent（JDK5）

150 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.naming.event
类 NamingEvent

java.lang.Object
  java.util.EventObject
      javax.naming.event.NamingEvent

所有已实现的接口：: Serializable

public class NamingEvent
extends EventObject
extends EventObject

此类表示命名/目录服务触发的事件。

NamingEvent 的状态包括

事件源：触发此事件的 EventContext。
事件类型。
新绑定：关于更改后对象的信息。
旧绑定：关于更改前对象的信息。
更改信息：关于触发此事件的更改的信息；通常是特定于服务提供程序或特定于服务器的信息。

注意，事件源始终是注册了侦听器的那个 EventContext 实例。此外，NamingEvent 中绑定的名称始终相对于该实例。例如，假定侦听器进行以下注册：

        NamespaceChangeListener listener = ...;
        src.addNamingListener("x", SUBTREE_SCOPE, listener);

以后删除名为 "x/y" 的对象时，相应的 NamingEvent (evt) 必须包含：

        evt.getEventContext() == src
        evt.getOldBinding().getName().equals("x/y")

当多个线程并发访问同一个 EventContext 时必须谨慎。有关线程问题的更多信息，请参阅包描述。

从以下版本开始：: 1.3
另请参见：: NamingListener, EventContext, 序列化表格

字段摘要
`protected Object`	`changeInfo` 包含关于生成此事件的更改的信息。
`protected Binding`	`newBinding` 包含关于更改后对象的信息。
`static int`	`OBJECT_ADDED` 指示已经添加了新对象的命名事件类型。
`static int`	`OBJECT_CHANGED` 指示已经更改了某个对象的命名事件类型。
`static int`	`OBJECT_REMOVED` 指示已经移除了某个对象的命名事件类型。
`static int`	`OBJECT_RENAMED` 指示已经重命名了某个对象的命名事件类型。
`protected Binding`	`oldBinding` 包含关于更改前对象的信息。
`protected int`	`type` 包含此事件的类型。

从类 java.util.EventObject 继承的字段
`source`

构造方法摘要
`NamingEvent(EventContext source, int type, Binding newBd, Binding oldBd, Object changeInfo)` 构造一个 `NamingEvent` 的实例。

方法摘要
`void`	`dispatch(NamingListener listener)` 对此事件调用适当的侦听器方法。
`Object`	`getChangeInfo()` 检索此事件的更改信息。
`EventContext`	`getEventContext()` 检索触发此事件的事件源。
`Binding`	`getNewBinding()` 检索更改后对象的绑定。
`Binding`	`getOldBinding()` 检索更改前对象的绑定。
`int`	`getType()` 返回此事件的类型。

从类 java.util.EventObject 继承的方法
`getSource, toString`

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

字段详细信息

OBJECT_ADDED

public static final int OBJECT_ADDED

指示已经添加了新对象的命名事件类型。此常量的值为 0。

另请参见：: 常量字段值

OBJECT_REMOVED

public static final int OBJECT_REMOVED

指示已经移除了某个对象的命名事件类型。此常量的值为 1。

另请参见：: 常量字段值

OBJECT_RENAMED

public static final int OBJECT_RENAMED

指示已经重命名了某个对象的命名事件类型。注意，有些服务可能为单个逻辑重命名操作触发多个事件。例如，重命名操作可能通过添加具有新名称的绑定并移除旧绑定来实现。

如果新名称或旧名称在侦听器注册的范围之外，则 NamingEvent 中的新/旧绑定为 null。

重命名名称空间树中的内部节点后，应该使用作为侦听器范围一部分的顶层节点生成重命名事件。对这一点的支持程度是特定于提供程序的。例如，服务可能为所有已更改内部节点的子代都生成重命名通知，相应的提供程序可能无法阻止将这些通知传播到侦听器。

此常量的值为 2。

另请参见：: 常量字段值

OBJECT_CHANGED

public static final int OBJECT_CHANGED

指示已经更改了某个对象的命名事件类型。更改可能包括对象的属性，也可能包括对象本身。注意，有些服务可能为单个修改触发多个事件。例如，修改可能通过首先移除旧绑定，然后添加包含相同名称但不同对象的新绑定来实现。

此常量的值为 3。

另请参见：: 常量字段值

changeInfo

protected Object changeInfo

包含关于生成此事件的更改的信息。

type

protected int type

包含此事件的类型。

另请参见：: OBJECT_ADDED, OBJECT_REMOVED, OBJECT_RENAMED, OBJECT_CHANGED

oldBinding

protected Binding oldBinding

包含关于更改前对象的信息。