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
接口 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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策