compact3

javax.naming.event

Interface EventContext

All Superinterfaces:

Context

All Known Subinterfaces:

EventDirContext

public interface EventContext
extends Context

包含了注册/注销的听众被通知时触发的事件对象的上下文变化命名方法。

目标

在 addNamingListener()方法名称参数称为目标。目标，随着范围，确定侦听器对的对象（s）。它是可能的注册在一个不存在的目标的兴趣，但可能有一定的限制，在程度上，这可以支持的服务提供商和相关协议/服务。

如果一个服务只支持现有目标登记，企图登记为一个不存在的目标结果在NameNotFoundException被尽早，最好是在时间addNamingListener()叫，或如果这是不可能的，听者通过NamingExceptionEvent收到例外。

同时，对现有的目标只支持注册服务商，当一个侦听器注册为目标，随后从命名空间中删除，听者是通过NamingExceptionEvent通知（含NameNotFoundException）。

应用程序可以使用的方法targetMustExist()是否EventContext支持不存在的目标登记。

事件源

的 EventContext实例上调用注册的方法是事件的事件源（潜在的）产生的。该源不一定是目标命名的对象。只有当目标是空名称时，才是目标命名的对象源。换句话说，目标，随着范围的参数，用于识别对象（S），听众很感兴趣，但事件源是 EventContext实例，听者已注册。

例如，假设一个侦听器使以下注册：

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

当对象命名为“X / Y”随后被删除，相应的 NamingEvent（ evt）必须包含：

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

此外，监听器注册/注销与EventContext实例，而不是在命名空间对应的对象。如果计划在一些点移除侦听器，则需要保持一个参考的EventContext实例上调用addNamingListener()（正如它需要保持一个参考听者为了以后删除它）。不能期望做一个lookup()得到一个EventContext的另一个实例进行注销登记。

一生的登记

注册监听器就注销时：

• 它是利用removeNamingListener()删除。
• 在收集事件的信息时引发异常。即，当侦听器接收到NamingExceptionEvent。
• Context.close()调用的EventContext实例与它有注册。

直到那时，一 EventContext实例，具有突出的听众会继续存在，并由服务提供商维护。

侦听器的实现

注册/注销方法接受 NamingListener实例。有不同的 NamingEvent事件类型 NamingListener个子。例如，在 ObjectChangeListener接口是用于 NamingEvent.OBJECT_CHANGED事件类型。登记在多个事件类型的兴趣，听者的实现应该实现多个 NamingListener子接口和使用一个单一的调用 addNamingListener()。除了减少的方法调用的数量和可能的代码大小的听众，这允许一些服务提供商优化注册。

线程问题

像 Context实例一般情况下 EventContext不保证是线程安全的。必须注意，当多个线程访问同一 EventContext兼。看到 package description关于线程的问题的更多信息。

从以下版本开始：

一点三

Field Summary

Fields

Modifier and Type	Field and Description
static int	OBJECT_SCOPE 表示由目标命名的对象的事件的兴趣的常数。
static int	ONELEVEL_SCOPE 常量，用于表示由目标命名的上下文中的对象的事件的兴趣，不包括目标命名的上下文。
static int	SUBTREE_SCOPE 为了表达对对象的命名对象的事件感兴趣目标的子树的常数，包括对象的对象命名。

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

方法摘要

Modifier and Type	Method and Description
void	addNamingListener(Name target, int scope, NamingListener l) 添加一个侦听器，用于接收目标和范围更改标识的对象（S）时发射的命名事件。
void	addNamingListener(String target, int scope, NamingListener l) 添加一个侦听器，用于接收由字符串目标名称和范围更改命名的对象时发生的命名事件。
void	removeNamingListener(NamingListener l) 从接收命名事件被这 EventContext移除侦听器。
boolean	targetMustExist() 确定一个侦听器是否可以在不存在的目标中注册兴趣。

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

Field Detail

OBJECT_SCOPE

static final int OBJECT_SCOPE

表示由目标命名的对象的事件的兴趣的常数。

此常数的值是0。

另请参见：

Constant Field Values

ONELEVEL_SCOPE

static final int ONELEVEL_SCOPE

常量，用于表示由目标命名的上下文中的对象的事件的兴趣，不包括目标命名的上下文。

此常数的值是1。

另请参见：

Constant Field Values

SUBTREE_SCOPE

static final int SUBTREE_SCOPE

为了表达对对象的命名对象的事件感兴趣目标的子树的常数，包括对象的对象命名。

此常数的值是2。

另请参见：

Constant Field Values

方法详细信息

addNamingListener

void addNamingListener(Name target,
                       int scope,
                       NamingListener l)
                throws NamingException

添加一个侦听器，用于接收目标和范围更改标识的对象（S）时发射的命名事件。这些事件的事件源是这样的上下文。看到关于事件源和目标的讨论的类描述。看到 OBJECT_SCOPE ONELEVEL_SCOPE常数，描述，和 SUBTREE_SCOPE看看 scope影响登记。

target需要名称上下文只有scope是ONELEVEL_SCOPE。target可能名非语境如果scope是OBJECT_SCOPE或SUBTREE_SCOPE。使用SUBTREE_SCOPE对于非上下文可能是有用的，例如，如果对方事先并不知道是否target是上下文想登记的兴趣（可能退化的子树的根target）。

当你被通知事件，听众可能在其他所addNamingListener()执行线程调用。必须注意，当多个线程访问同一EventContext兼。看到package description关于线程的问题的更多信息。

参数

target -一个非空的名字来解决相对这个语境。

scope -一个 OBJECT_SCOPE， ONELEVEL_SCOPE，或 SUBTREE_SCOPE。

l -非空的听众。

异常

NamingException如果同时添加侦听器中遇到的一个问题。

另请参见：

removeNamingListener(javax.naming.event.NamingListener)

addNamingListener

void addNamingListener(String target,
                       int scope,
                       NamingListener l)
                throws NamingException

添加一个侦听器，用于接收由字符串目标名称和范围更改命名的对象时发生的命名事件。看到接受 Name详情过载。

参数

target -对象的非空字符串名称解决相对这个语境。

scope -一个 OBJECT_SCOPE， ONELEVEL_SCOPE，或 SUBTREE_SCOPE。

l -非空的听众。

异常

NamingException如果同时添加侦听器中遇到的一个问题。

另请参见：

removeNamingListener(javax.naming.event.NamingListener)

removeNamingListener

void removeNamingListener(NamingListener l)
                   throws NamingException

从接收命名事件被这 EventContext移除侦听器。听众可能已不止一次这样 EventContext，也许带着不同的目标和范围的争论。调用该方法后，听众将不再接收事件，这 EventContext实例作为事件源（除了那些事件已经在派遣过程）。如果听者没有，或不再，这 EventContext实例注册，此方法不做任何事。

参数

l -非空的听众。

异常

NamingException如果同时消除听众遇到的问题。

另请参见：

addNamingListener(javax.naming.Name, int, javax.naming.event.NamingListener)

targetMustExist

boolean targetMustExist()
                 throws NamingException

确定一个侦听器是否可以在不存在的目标中注册兴趣。

结果

如果目标必须存在，如果目标不存在的话，则是错误的。

异常

NamingException如果对此不能下决定的行为。