uTools-Manuals/docs/java/javax/naming/event/EventDirContext.html

<div class="header">
<div class="subTitle">
     compact3 
   </div>
<div class="subTitle">
     javax.naming.event 
   </div>
<h2 class="title" title="Interface EventDirContext">Interface EventDirContext</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Superinterfaces: 
       </dt>
<dd>
<span><a href="../../../javax/naming/Context.html" title="javax.naming中的接口">Context</a> ， <a href="../../../javax/naming/directory/DirContext.html" title="javax.naming.directory中的接口">DirContext</a> ， <a href="../../../javax/naming/event/EventContext.html" title="javax.naming.event中的接口">EventContext</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">EventDirContext</span>
extends <a href="../../../javax/naming/event/EventContext.html" title="interface in javax.naming.event">EventContext</a>, <a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></pre>
<div class="block">
<span>包含用于注册侦听器的方法，以便在目录上下文中指定的对象更改时触发的事件被通知。</span>
<p> <span>该界面中的方法支持通过<a href="http://www.ietf.org/rfc/rfc2254.txt">RFC 2254</a>搜索过滤器识别对象。</span> </p>
<p> <span>使用搜索过滤器，可以注册在注册时不存在的对象的兴趣，但是后来出现并满足过滤器。</span> <span>但是，在服务提供商和底层协议/服务可以支持的程度上可能会受到限制。</span> <span>如果调用者以这种方式提交一个不能支持的过滤器， <tt>那么addNamingListener()</tt>会抛出一个<tt>InvalidSearchFilterException</tt> 。</span> </p>
<p> <span>有关事件源和目标的描述以及有关侦听器注册/注销的信息，请参见<tt>EventContext</tt> ，这些信息也适用于此接口中的方法。</span> <span>见<a href="package-summary.html#THREADING">package description</a>关于线程问题。</span> </p>
<p> <span>作为<tt>参数</tt>传递给任何方法的<tt>SearchControls</tt>或数组对象由调用者拥有。</span> <span>服务提供商不会修改对象或保留对它的引用。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         1.3 
       </dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.naming.event.EventContext">
<!-- --> </a> <h3>Fields inherited from interface javax.naming.event.<a href="../../../javax/naming/event/EventContext.html" title="interface in javax.naming.event">EventContext</a></h3> <code><a href="../../../javax/naming/event/EventContext.html#OBJECT_SCOPE">OBJECT_SCOPE</a>, <a href="../../../javax/naming/event/EventContext.html#ONELEVEL_SCOPE">ONELEVEL_SCOPE</a>, <a href="../../../javax/naming/event/EventContext.html#SUBTREE_SCOPE">SUBTREE_SCOPE</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.naming.directory.DirContext">
<!-- --> </a> <h3>Fields inherited from interface javax.naming.directory.<a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></h3> <code><a href="../../../javax/naming/directory/DirContext.html#ADD_ATTRIBUTE">ADD_ATTRIBUTE</a>, <a href="../../../javax/naming/directory/DirContext.html#REMOVE_ATTRIBUTE">REMOVE_ATTRIBUTE</a>, <a href="../../../javax/naming/directory/DirContext.html#REPLACE_ATTRIBUTE">REPLACE_ATTRIBUTE</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.naming.Context">
<!-- --> </a> <h3>Fields inherited from interface javax.naming.<a href="../../../javax/naming/Context.html" title="interface in javax.naming">Context</a></h3> <code><a href="../../../javax/naming/Context.html#APPLET">APPLET</a>, <a href="../../../javax/naming/Context.html#AUTHORITATIVE">AUTHORITATIVE</a>, <a href="../../../javax/naming/Context.html#BATCHSIZE">BATCHSIZE</a>, <a href="../../../javax/naming/Context.html#DNS_URL">DNS_URL</a>, <a href="../../../javax/naming/Context.html#INITIAL_CONTEXT_FACTORY">INITIAL_CONTEXT_FACTORY</a>, <a href="../../../javax/naming/Context.html#LANGUAGE">LANGUAGE</a>, <a href="../../../javax/naming/Context.html#OBJECT_FACTORIES">OBJECT_FACTORIES</a>, <a href="../../../javax/naming/Context.html#PROVIDER_URL">PROVIDER_URL</a>, <a href="../../../javax/naming/Context.html#REFERRAL">REFERRAL</a>, <a href="../../../javax/naming/Context.html#SECURITY_AUTHENTICATION">SECURITY_AUTHENTICATION</a>, <a href="../../../javax/naming/Context.html#SECURITY_CREDENTIALS">SECURITY_CREDENTIALS</a>, <a href="../../../javax/naming/Context.html#SECURITY_PRINCIPAL">SECURITY_PRINCIPAL</a>, <a href="../../../javax/naming/Context.html#SECURITY_PROTOCOL">SECURITY_PROTOCOL</a>, <a href="../../../javax/naming/Context.html#STATE_FACTORIES">STATE_FACTORIES</a>, <a href="../../../javax/naming/Context.html#URL_PKG_PREFIXES">URL_PKG_PREFIXES</a></code></li>
</ul> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/event/EventDirContext.html#addNamingListener-javax.naming.Name-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-javax.naming.event.NamingListener-">addNamingListener</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> target, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filter, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a>[] filterArgs, <a href="../../../javax/naming/directory/SearchControls.html" title="class in javax.naming.directory">SearchControls</a> ctls, <a href="../../../javax/naming/event/NamingListener.html" title="interface in javax.naming.event">NamingListener</a> l)</code>
<div class="block">
              添加一个侦听器，用于接收由搜索过滤器 
             <tt>识别的</tt>对象filter触发的命名事件，并修改由目标命名的对象的过滤器参数。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/event/EventDirContext.html#addNamingListener-javax.naming.Name-java.lang.String-javax.naming.directory.SearchControls-javax.naming.event.NamingListener-">addNamingListener</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> target, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filter, <a href="../../../javax/naming/directory/SearchControls.html" title="class in javax.naming.directory">SearchControls</a> ctls, <a href="../../../javax/naming/event/NamingListener.html" title="interface in javax.naming.event">NamingListener</a> l)</code>
<div class="block">
              添加一个侦听器，用于接收由目标命名的对象由搜索过滤器 
             <tt>filter标识</tt>的对象时触发的命名事件。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/event/EventDirContext.html#addNamingListener-java.lang.String-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-javax.naming.event.NamingListener-">addNamingListener</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> target, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filter, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a>[] filterArgs, <a href="../../../javax/naming/directory/SearchControls.html" title="class in javax.naming.directory">SearchControls</a> ctls, <a href="../../../javax/naming/event/NamingListener.html" title="interface in javax.naming.event">NamingListener</a> l)</code>
<div class="block">
              添加一个侦听器用于接收时的搜索过滤器 
             <tt>filter</tt>和过滤器参数由字符串目标名称指定的对象标识的对象被修改解雇命名事件。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/event/EventDirContext.html#addNamingListener-java.lang.String-java.lang.String-javax.naming.directory.SearchControls-javax.naming.event.NamingListener-">addNamingListener</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> target, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filter, <a href="../../../javax/naming/directory/SearchControls.html" title="class in javax.naming.directory">SearchControls</a> ctls, <a href="../../../javax/naming/event/NamingListener.html" title="interface in javax.naming.event">NamingListener</a> l)</code>
<div class="block">
              添加一个侦听器，用于接收在由字符串目标名称命名的对象由搜索过滤器 
             <tt>filter标识</tt>的对象时触发的命名事件。 
            </div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.naming.event.EventContext">
<!-- --> </a> <h3>Methods inherited from interface javax.naming.event.<a href="../../../javax/naming/event/EventContext.html" title="interface in javax.naming.event">EventContext</a></h3> <code><a href="../../../javax/naming/event/EventContext.html#addNamingListener-javax.naming.Name-int-javax.naming.event.NamingListener-">addNamingListener</a>, <a href="../../../javax/naming/event/EventContext.html#addNamingListener-java.lang.String-int-javax.naming.event.NamingListener-">addNamingListener</a>, <a href="../../../javax/naming/event/EventContext.html#removeNamingListener-javax.naming.event.NamingListener-">removeNamingListener</a>, <a href="../../../javax/naming/event/EventContext.html#targetMustExist--">targetMustExist</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.naming.directory.DirContext">
<!-- --> </a> <h3>Methods inherited from interface javax.naming.directory.<a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></h3> <code><a href="../../../javax/naming/directory/DirContext.html#bind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">bind</a>, <a href="../../../javax/naming/directory/DirContext.html#bind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">bind</a>, <a href="../../../javax/naming/directory/DirContext.html#createSubcontext-javax.naming.Name-javax.naming.directory.Attributes-">createSubcontext</a>, <a href="../../../javax/naming/directory/DirContext.html#createSubcontext-java.lang.String-javax.naming.directory.Attributes-">createSubcontext</a>, <a href="../../../javax/naming/directory/DirContext.html#getAttributes-javax.naming.Name-">getAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#getAttributes-javax.naming.Name-java.lang.String:A-">getAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#getAttributes-java.lang.String-">getAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#getAttributes-java.lang.String-java.lang.String:A-">getAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#getSchema-javax.naming.Name-">getSchema</a>, <a href="../../../javax/naming/directory/DirContext.html#getSchema-java.lang.String-">getSchema</a>, <a href="../../../javax/naming/directory/DirContext.html#getSchemaClassDefinition-javax.naming.Name-">getSchemaClassDefinition</a>, <a href="../../../javax/naming/directory/DirContext.html#getSchemaClassDefinition-java.lang.String-">getSchemaClassDefinition</a>, <a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-int-javax.naming.directory.Attributes-">modifyAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-javax.naming.directory.ModificationItem:A-">modifyAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-java.lang.String-int-javax.naming.directory.Attributes-">modifyAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-java.lang.String-javax.naming.directory.ModificationItem:A-">modifyAttributes</a>, <a href="../../../javax/naming/directory/DirContext.html#rebind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">rebind</a>, <a href="../../../javax/naming/directory/DirContext.html#rebind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">rebind</a>, <a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-java.lang.String-javax.naming.directory.SearchControls-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-javax.naming.directory.Attributes-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-javax.naming.directory.Attributes-java.lang.String:A-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">search</a>, <a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-java.lang.String-javax.naming.directory.SearchControls-">search</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.naming.Context">
<!-- --> </a> <h3>Methods inherited from interface javax.naming.<a href="../../../javax/naming/Context.html" title="interface in javax.naming">Context</a></h3> <code><a href="../../../javax/naming/Context.html#addToEnvironment-java.lang.String-java.lang.Object-">addToEnvironment</a>, <a href="../../../javax/naming/Context.html#bind-javax.naming.Name-java.lang.Object-">bind</a>, <a href="../../../javax/naming/Context.html#bind-java.lang.String-java.lang.Object-">bind</a>, <a href="../../../javax/naming/Context.html#close--">close</a>, <a href="../../../javax/naming/Context.html#composeName-javax.naming.Name-javax.naming.Name-">composeName</a>, <a href="../../../javax/naming/Context.html#composeName-java.lang.String-java.lang.String-">composeName</a>, <a href="../../../javax/naming/Context.html#createSubcontext-javax.naming.Name-">createSubcontext</a>, <a href="../../../javax/naming/Context.html#createSubcontext-java.lang.String-">createSubcontext</a>, <a href="../../../javax/naming/Context.html#destroySubcontext-javax.naming.Name-">destroySubcontext</a>, <a href="../../../javax/naming/Context.html#destroySubcontext-java.lang.String-">destroySubcontext</a>, <a href="../../../javax/naming/Context.html#getEnvironment--">getEnvironment</a>, <a href="../../../javax/naming/Context.html#getNameInNamespace--">getNameInNamespace</a>, <a href="../../../javax/naming/Context.html#getNameParser-javax.naming.Name-">getNameParser</a>, <a href="../../../javax/naming/Context.html#getNameParser-java.lang.String-">getNameParser</a>, <a href="../../../javax/naming/Context.html#list-javax.naming.Name-">list</a>, <a href="../../../javax/naming/Context.html#list-java.lang.String-">list</a>, <a href="../../../javax/naming/Context.html#listBindings-javax.naming.Name-">listBindings</a>, <a href="../../../javax/naming/Context.html#listBindings-java.lang.String-">listBindings</a>, <a href="../../../javax/naming/Context.html#lookup-javax.naming.Name-">lookup</a>, <a href="../../../javax/naming/Context.html#lookup-java.lang.String-">lookup</a>, <a href="../../../javax/naming/Context.html#lookupLink-javax.naming.Name-">lookupLink</a>, <a href="../../../javax/naming/Context.html#lookupLink-java.lang.String-">lookupLink</a>, <a href="../../../javax/naming/Context.html#rebind-javax.naming.Name-java.lang.Object-">rebind</a>, <a href="../../../javax/naming/Context.html#rebind-java.lang.String-java.lang.Object-">rebind</a>, <a href="../../../javax/naming/Context.html#removeFromEnvironment-java.lang.String-">removeFromEnvironment</a>, <a href="../../../javax/naming/Context.html#rename-javax.naming.Name-javax.naming.Name-">rename</a>, <a href="../../../javax/naming/Context.html#rename-java.lang.String-java.lang.String-">rename</a>, <a href="../../../javax/naming/Context.html#unbind-javax.naming.Name-">unbind</a>, <a href="../../../javax/naming/Context.html#unbind-java.lang.String-">unbind</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="addNamingListener-javax.naming.Name-java.lang.String-javax.naming.directory.SearchControls-javax.naming.event.NamingListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addNamingListener</h4> <pre>void addNamingListener(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> target,
                       <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filter,
                       <a href="../../../javax/naming/directory/SearchControls.html" title="class in javax.naming.directory">SearchControls</a> ctls,
                       <a href="../../../javax/naming/event/NamingListener.html" title="interface in javax.naming.event">NamingListener</a> l)
                throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span>添加一个侦听器，用于接收由目标命名的对象由搜索过滤器<tt>filter标识</tt>的对象时触发的命名事件。</span>
<p> <span>来自搜索控件<tt>ctls</tt>的范围，returnsObj标志和returnsAttributes标志用于控制对收听者感兴趣的对象的选择，并确定最终<tt>NamingEvent</tt>对象中返回的信息。</span> <span>请注意，如果<tt>NamingEvent</tt>对象不可用或无法由服务提供商或服务获取，则要返回的请求信息可能不存在。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>target</code> - 相对于此上下文解析的对象的非空名称。 
           </dd>
<dd>
<code>filter</code> - 非空字符串过滤器（参见RFC2254）。 
           </dd>
<dd>
<span><code>ctls</code> - 可能为空的搜索控件。</span>
<span>如果为空，则使用默认搜索控件。</span>
</dd>
<dd>
<code>l</code> - 非正常听众。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果在添加侦听器时遇到问题。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/naming/event/EventContext.html#removeNamingListener-javax.naming.event.NamingListener-"><code>EventContext.removeNamingListener(javax.naming.event.NamingListener)</code></a> ， 
            <a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-java.lang.String-javax.naming.directory.SearchControls-"><code>DirContext.search(javax.naming.Name, java.lang.String, javax.naming.directory.SearchControls)</code></a>
</dd>
</dl> </li>
</ul> <a name="addNamingListener-java.lang.String-java.lang.String-javax.naming.directory.SearchControls-javax.naming.event.NamingListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addNamingListener</h4> <pre>void addNamingListener(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> target,
                       <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filter,
                       <a href="../../../javax/naming/directory/SearchControls.html" title="class in javax.naming.directory">SearchControls</a> ctls,
                       <a href="../../../javax/naming/event/NamingListener.html" title="interface in javax.naming.event">NamingListener</a> l)
                throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span>添加一个侦听器，用于接收在由字符串目标名称命名的对象上由搜索过滤器<tt>filter标识</tt>的对象时触发的命名事件。</span>
<span>有关此方法的行为的详细信息，请参阅接受<tt>Name</tt>的重载。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>target</code> - 相对于此上下文解析的对象的非空字符串名称。 
           </dd>
<dd>
<code>filter</code> - 非空字符串过滤器（请参阅RFC2254）。 
           </dd>
<dd>
<span><code>ctls</code> - 可能为空的搜索控件。</span>
<span>如果为空，则使用默认搜索控件。</span>
</dd>
<dd>
<code>l</code> - 非空的侦听器。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果在添加侦听器时遇到问题。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/naming/event/EventContext.html#removeNamingListener-javax.naming.event.NamingListener-"><code>EventContext.removeNamingListener(javax.naming.event.NamingListener)</code></a> ， 
            <a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-java.lang.String-javax.naming.directory.SearchControls-"><code>DirContext.search(java.lang.String, java.lang.String, javax.naming.directory.SearchControls)</code></a>
</dd>
</dl> </li>
</ul> <a name="addNamingListener-javax.naming.Name-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-javax.naming.event.NamingListener-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addNamingListener</h4> <pre>void addNamingListener(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> target,
                       <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filter,
                       <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a>[] filterArgs,
                       <a href="../../../javax/naming/directory/SearchControls.html" title="class in javax.naming.directory">SearchControls</a> ctls,
                       <a href="../../../javax/naming/event/NamingListener.html" title="interface in javax.naming.event">NamingListener</a> l)
                throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span>添加一个侦听器，用于接收由搜索过滤器<tt>标识的</tt>对象filter触发的命名事件，并修改由目标命名的对象的过滤器参数。</span>
<span>来自搜索控件<tt>ctls</tt>的范围，returnsObj标志和returnsAttributes标志用于控制对收听者感兴趣的对象的选择，并确定最终<tt>NamingEvent</tt>对象中返回的信息。</span>
<span>请注意，如果服务提供商或服务不可用或无法获取，则所请求的信息可能不会出现在<tt>NamingEvent</tt>对象中。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>target</code> - 相对于此上下文解析的对象的非空名称。 
           </dd>
<dd>
<code>filter</code> - 非空字符串过滤器（参见RFC2254）。 
           </dd>
<dd>
<code>filterArgs</code> - 过滤器的参数可能为空的数组。 
           </dd>
<dd>
<span><code>ctls</code> - 可能为空的搜索控件。</span>
<span>如果为空，则使用默认搜索控件。</span>
</dd>
<dd>
<code>l</code> - 非空的侦听器。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果在添加侦听器时遇到问题。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/naming/event/EventContext.html#removeNamingListener-javax.naming.event.NamingListener-"><code>EventContext.removeNamingListener(javax.naming.event.NamingListener)</code></a> ， 
            <a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-"><code>DirContext.search(javax.naming.Name, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)</code></a>
</dd>
</dl> </li>
</ul> <a name="addNamingListener-java.lang.String-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-javax.naming.event.NamingListener-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>addNamingListener</h4> <pre>void addNamingListener(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> target,
                       <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filter,
                       <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a>[] filterArgs,
                       <a href="../../../javax/naming/directory/SearchControls.html" title="class in javax.naming.directory">SearchControls</a> ctls,
                       <a href="../../../javax/naming/event/NamingListener.html" title="interface in javax.naming.event">NamingListener</a> l)
                throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span>添加一个侦听器用于接收时的搜索过滤器<tt>filter</tt>和过滤器参数由字符串目标名称指定的对象标识的对象被修改解雇命名事件。</span>
<span>有关此方法的行为的详细信息，请参阅接受<tt>Name</tt>的重载。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>target</code> - 相对于此上下文解析的对象的非空字符串名称。 
           </dd>
<dd>
<code>filter</code> - 非空字符串过滤器（参见RFC2254）。 
           </dd>
<dd>
<code>filterArgs</code> - 过滤器的参数可能为空的数组。 
           </dd>
<dd>
<span><code>ctls</code> - 可能为空的搜索控件。</span>
<span>如果为空，则使用默认搜索控件。</span>
</dd>
<dd>
<code>l</code> - 非内容侦听器。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果在添加侦听器时遇到问题。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/naming/event/EventContext.html#removeNamingListener-javax.naming.event.NamingListener-"><code>EventContext.removeNamingListener(javax.naming.event.NamingListener)</code></a>, 
            <a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-"><code>DirContext.search(java.lang.String, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>