java.applet

java.awt

java.awt.color

java.awt.datatransfer

java.awt.dnd

java.awt.event

java.awt.font

java.awt.geom

java.awt.im

java.awt.im.spi

java.awt.image

java.awt.image.renderable

java.awt.print

java.beans

java.beans.beancontext

java.io

java.lang

java.lang.annotation

java.lang.instrument

java.lang.management

java.lang.ref

java.lang.reflect

java.math

java.net

java.nio

java.nio.channels

java.nio.channels.spi

java.nio.charset

java.nio.charset.spi

java.rmi

java.rmi.activation

java.rmi.dgc

java.rmi.registry

java.rmi.server

java.security

java.security.acl

java.security.cert

java.security.interfaces

java.security.spec

java.sql

java.text

java.util

java.util.concurrent

java.util.concurrent.atomic

java.util.concurrent.locks

java.util.jar

java.util.logging

java.util.prefs

java.util.regex

java.util.zip

javax.accessibility

javax.activity

javax.crypto

javax.crypto.interfaces

javax.crypto.spec

javax.imageio

javax.imageio.event

javax.imageio.metadata

javax.imageio.plugins.bmp

javax.imageio.plugins.jpeg

javax.imageio.spi

javax.imageio.stream

javax.management

javax.management.loading

javax.management.modelmbean

javax.management.monitor

javax.management.openmbean

javax.management.relation

javax.management.remote

javax.management.remote.rmi

javax.management.timer

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

javax.net

javax.net.ssl

javax.print

javax.print.attribute

javax.print.attribute.standard

javax.print.event

javax.rmi

javax.rmi.CORBA

javax.rmi.ssl

javax.security.auth

javax.security.auth.callback

javax.security.auth.kerberos

javax.security.auth.login

javax.security.auth.spi

javax.security.auth.x500

javax.security.cert

javax.security.sasl

javax.sound.midi

javax.sound.midi.spi

javax.sound.sampled

javax.sound.sampled.spi

javax.sql

javax.sql.rowset

javax.sql.rowset.serial

javax.sql.rowset.spi

javax.swing

javax.swing.border

javax.swing.colorchooser

javax.swing.event

javax.swing.filechooser

javax.swing.plaf

javax.swing.plaf.basic

javax.swing.plaf.metal

javax.swing.plaf.multi

javax.swing.plaf.synth

javax.swing.table

javax.swing.text

javax.swing.text

javax.swing.text.parser

javax.swing.text.rtf

javax.swing.tree

javax.swing.undo

javax.transaction

javax.transaction.xa

javax.xml

javax.xml.datatype

javax.xml.namespace

javax.xml.parsers

javax.xml.transform

javax.xml.transform.dom

javax.xml.transform.sax

javax.xml.transform.stream

javax.xml.validation

javax.xml.xpath

org.ietf.jgss

org.omg.CORBA

org.omg.CORBA_2_3

org.omg.CORBA_2_3.portable

org.omg.CORBA.DynAnyPackage

org.omg.CORBA.ORBPackage

org.omg.CORBA.portable

org.omg.CORBA.TypeCodePackage

org.omg.CosNaming

org.omg.CosNaming.NamingContextExtPackage

org.omg.CosNaming.NamingContextPackage

org.omg.Dynamic

org.omg.DynamicAny

org.omg.DynamicAny.DynAnyFactoryPackage

org.omg.DynamicAny.DynAnyPackage

org.omg.IOP

org.omg.IOP.CodecFactoryPackage

org.omg.IOP.CodecPackage

org.omg.Messaging

org.omg.PortableInterceptor

org.omg.PortableInterceptor.ORBInitInfoPackage

org.omg.PortableServer

org.omg.PortableServer.CurrentPackage

org.omg.PortableServer.POAManagerPackage

org.omg.PortableServer.POAPackage

org.omg.PortableServer.portable

org.omg.PortableServer.ServantLocatorPackage

org.omg.SendingContext

org.omg.stub.java.rmi

org.w3c.dom

org.w3c.dom.bootstrap

org.w3c.dom.events

org.w3c.dom.ls

org.xml.sax

org.xml.sax.ext

org.xml.sax.helpers

allclasses-frame

allclasses-noframe

constant-values

deprecated-list

help-doc

JavaTM 2 Platform
Standard Ed. 5.0

javax.naming.event
接口 EventContext

所有超级接口:
Context
所有已知子接口:
EventDirContext

public interface EventContext
extends Context

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

目标

addNamingListener() 方法中的名称参数被称为目标。目标和范围一起标识侦听器感兴趣的对象。注册不存在的感兴趣目标是可能的,但是服务提供程序和底层协议/服务对这种情况的支持程度可能存在限制。

如果服务仅支持注册现有目标,则试图注册不存在的目标将导致第一时间抛出 NameNotFoundException,一般是在调用 addNamingListener() 时;如果这没有发生,则侦听器将通过 NamingExceptionEvent 收到异常。

此外,对于仅支持注册现有目标的服务提供程序而言,当以后从名称空间移除注册过侦听器的目标时,该侦听器通过 NamingExceptionEvent(包含 NameNotFoundException)获得通知。

应用程序可以使用 targetMustExist() 来检查 EventContext 是否支持注册不存在的目标。

事件源

对其调用注册方法的 EventContext 实例是(可能)生成事件的事件源。源不一定 是目标指定的对象。仅当目标为空名称时,目标指定的对象才是源。换句话说,目标和范围参数一起用于标识侦听器感兴趣的对象,而事件源是侦听器注册的 EventContext 实例。

例如,假定侦听器进行以下注册:

        NamespaceChangeListener listener = ...;
        src.addNamingListener("x", SUBTREE_SCOPE, listener);
以后删除名为 "x/y" 的对象时,相应的 NamingEvent (evt) 必须包含:
        evt.getEventContext() == src
        evt.getOldBinding().getName().equals("x/y")

此外,侦听器注册/注销是使用 EventContext 实例 进行的,而不是使用名称空间中的相应对象。如果程序在某个时候要移除侦听器,则它需要保持对要调用 addNamingListener()EventContext 实例的引用(这正如为了以后进行移除而需要保持对侦听器的引用)。不要期望它能进行 lookup() 而获取另一个可以执行注销的 EventContext 实例。

注册的生命周期

注册侦听器在以下情况将被注销:
  • 使用 removeNamingListener() 移除。
  • 在收集关于事件的信息时抛出异常。即当侦听器收到 NamingExceptionEvent 时。
  • 对它注册的 EventContext 实例调用 Context.close() 时。
这时,具有未完成侦听器的 EventContext 实例将继续存在,并由服务提供程序继续维护。

侦听器实现

注册/注销方法接受 NamingListener 的实例。对不同事件类型的 NamingEvent 使用不同的 NamingListener 子接口。例如,ObjectChangeListener 接口用于 NamingEvent.OBJECT_CHANGED 事件类型。要注册多个感兴趣事件类型,侦听器实现应该实现多个 NamingListener 子接口并调用一次 addNamingListener()。除了减少方法的调用次数并有可能减少侦听器的代码大小之外,这还允许某些服务提供程序对注册进行优化。

线程问题

像通常的 Context 实例一样,不保证 EventContext 实例是线程安全的。当多个线程并发访问同一个 EventContext 时必须谨慎。有关线程问题的更多信息,请参阅包描述

从以下版本开始:
1.3

字段摘要
static int OBJECT_SCOPE
          该常量用来表示对涉及目标指定对象的事件感兴趣。
static int ONELEVEL_SCOPE
          该常量用来表示对涉及目标指定上下文中对象的事件感兴趣,不包括目标指定的上下文。
static int 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
 
方法摘要
 void addNamingListener(Name target, int scope, NamingListener l)
          添加接收命名事件的侦听器,这些事件在目标和范围所标识的对象发生更改时触发。
 void addNamingListener(String target, int scope, NamingListener l)
          添加接收命名事件的侦听器,这些事件在目标名称和范围指定的对象发生更改时触发。
 void removeNamingListener(NamingListener l)
          从此 EventContext 触发的接收命名事件中移除一个侦听器。
 boolean 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
 

字段详细信息

OBJECT_SCOPE

static final int OBJECT_SCOPE
该常量用来表示对涉及目标指定对象的事件感兴趣。

此常量的值为 0

另请参见:
常量字段值

ONELEVEL_SCOPE

static final int ONELEVEL_SCOPE
该常量用来表示对涉及目标指定上下文中对象的事件感兴趣,不包括目标指定的上下文。

此常量的值为 1

另请参见:
常量字段值

SUBTREE_SCOPE

static final int SUBTREE_SCOPE
该常量用来表示对涉及目标指定对象的子树中对象的事件感兴趣,包括目标指定的对象。

此常量的值为 2

另请参见:
常量字段值
方法详细信息

addNamingListener

void addNamingListener(Name target,
                       int scope,
                       NamingListener l)
                       throws NamingException
添加接收命名事件的侦听器,这些事件在目标和范围所标识的对象发生更改时触发。 这些事件的事件源是此上下文。有关事件源和目标的讨论,请参阅类描述。请参阅对常量 OBJECT_SCOPEONELEVEL_SCOPESUBTREE_SCOPE 的描述,以了解 scope 如何影响注册。

target 仅在 scopeONELEVEL_SCOPE 时需要指定上下文,如果 scope 既不是 OBJECT_SCOPE 也不是 SUBTREE_SCOPE,则 target 可能指定非上下文。例如,如果调用方预先不知道 target 是否是上下文,而只想注册以 target 为根的(可能退化的)子树,则使用非上下文的 SUBTREE_SCOPE 可能很有用。

当侦听器收到事件通知时,侦听器可以在没有执行 addNamingListener() 的某个线程中调用。当多个线程并发访问同一个 EventContext 时必须谨慎。有关线程问题的更多信息,请参阅包描述

参数:
target - 要相对于此上下文解析的非 null 名称。
scope - OBJECT_SCOPEONELEVEL_SCOPESUBTREE_SCOPE 之一。
l - 非 null 侦听器。
抛出:
NamingException - 如果在添加侦听器时遇到问题。
另请参见:
removeNamingListener(javax.naming.event.NamingListener)

addNamingListener

void addNamingListener(String target,
                       int scope,
                       NamingListener l)
                       throws NamingException
添加接收命名事件的侦听器,这些事件在目标名称和范围指定的对象发生更改时触发。 有关详细信息,请参阅接受 Name 参数的重载方法。

参数:
target - 相对于此上下文解析的对象的非 null 字符串名称。
scope - OBJECT_SCOPEONELEVEL_SCOPESUBTREE_SCOPE 之一。
l - 非 null 侦听器。
抛出:
NamingException - 如果在添加侦听器时遇到问题。
另请参见:
removeNamingListener(javax.naming.event.NamingListener)

removeNamingListener

void removeNamingListener(NamingListener l)
                          throws NamingException
从此 EventContext 触发的接收命名事件中移除一个侦听器。该侦听器可能在此 EventContext 中注册过一次以上,并且可能使用不同的目标/范围参数进行。调用此方法后,侦听器将不再使用作为事件源的此 EventContext 实例接收事件(已经在指派过程中那些事件除外)。如果侦听器不(或不再)在此 EventContext 实例中注册,则此方法不执行任何操作。

参数:
l - 非 null 侦听器。
抛出:
NamingException - 如果在移除侦听器时遇到问题。
另请参见:
addNamingListener(javax.naming.Name, int, javax.naming.event.NamingListener)

targetMustExist

boolean targetMustExist()
                        throws NamingException
确定侦听器是否可以注册不存在的感兴趣目标。

返回:
如果目标存在,则返回 true;如果目标不必存在,则返回 false。
抛出:
NamingException - 如果无法确定上下文的这一行为。

JavaTM 2 Platform
Standard Ed. 5.0

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

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