uTools-Manuals/docs/java/javax/naming/directory/InitialDirContext.html

<div class="header">
<div class="subTitle">
     compact3 
   </div>
<div class="subTitle">
     javax.naming.directory 
   </div>
<h2 class="title" title="Class InitialDirContext">Class InitialDirContext</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../javax/naming/InitialContext.html" title="class in javax.naming">javax.naming.InitialContext</a></li>
<li>
<ul class="inheritance">
<li>javax.naming.directory.InitialDirContext</li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Implemented Interfaces: 
       </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></span>
</dd>
</dl>
<dl>
<dt>
        已知直接子类：
       </dt>
<dd>
<span><a href="../../../javax/naming/ldap/InitialLdapContext.html" title="javax.naming.ldap中的类">InitialLdapContext</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">InitialDirContext</span>
extends <a href="../../../javax/naming/InitialContext.html" title="class in javax.naming">InitialContext</a>
implements <a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></pre>
<div class="block">
<span>此类是执行目录操作的起始上下文。</span>
<span>InitialContext的类描述文件（包括用于同步的文档）适用于此。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         1.3 
       </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../javax/naming/InitialContext.html" title="javax.naming中的类"><code>InitialContext</code></a></span>
</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.InitialContext">
<!-- --> </a> <h3>Fields inherited from class javax.naming.<a href="../../../javax/naming/InitialContext.html" title="class in javax.naming">InitialContext</a></h3> <code><a href="../../../javax/naming/InitialContext.html#defaultInitCtx">defaultInitCtx</a>, <a href="../../../javax/naming/InitialContext.html#gotDefault">gotDefault</a>, <a href="../../../javax/naming/InitialContext.html#myProps">myProps</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>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier</th>
<th class="colLast" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code> </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#InitialDirContext--">InitialDirContext</a></span>()</code>
<div class="block">
              构造一个初始DirContext。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#InitialDirContext-boolean-">InitialDirContext</a></span>(boolean lazy)</code>
<div class="block">
              构造一个初始DirContext，可选择不初始化它。 
            </div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code> </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#InitialDirContext-java.util.Hashtable-">InitialDirContext</a></span>(<a href="../../../java/util/Hashtable.html" title="class in java.util">Hashtable</a>&lt;?,?&gt; environment)</code>
<div class="block">
              使用提供的环境构建初始DirContext。 
            </div> </td>
</tr>
</tbody>
</table> </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="t4"><span><a href="javascript:show(8);">具体的方法</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/directory/InitialDirContext.html#bind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">bind</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> obj, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)</code>
<div class="block">
              将名称绑定到对象，以及关联的属性。 
            </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/directory/InitialDirContext.html#bind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">bind</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> obj, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)</code>
<div class="block">
              将名称绑定到对象，以及关联的属性。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#createSubcontext-javax.naming.Name-javax.naming.directory.Attributes-">createSubcontext</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)</code>
<div class="block">
              创建和绑定新的上下文以及关联的属性。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#createSubcontext-java.lang.String-javax.naming.directory.Attributes-">createSubcontext</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)</code>
<div class="block">
              创建和绑定新的上下文以及关联的属性。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#getAttributes-javax.naming.Name-">getAttributes</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name)</code>
<div class="block">
              检索与命名对象关联的所有属性。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#getAttributes-javax.naming.Name-java.lang.String:A-">getAttributes</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] attrIds)</code>
<div class="block">
              检索与命名对象关联的所选属性。 
            </div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#getAttributes-java.lang.String-">getAttributes</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
              检索与命名对象关联的所有属性。 
            </div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#getAttributes-java.lang.String-java.lang.String:A-">getAttributes</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] attrIds)</code>
<div class="block">
              检索与命名对象关联的所选属性。 
            </div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#getSchema-javax.naming.Name-">getSchema</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name)</code>
<div class="block">
              检索与命名对象关联的模式。 
            </div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#getSchema-java.lang.String-">getSchema</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
              检索与命名对象关联的模式。 
            </div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#getSchemaClassDefinition-javax.naming.Name-">getSchemaClassDefinition</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name)</code>
<div class="block">
              检索包含命名对象的类定义的模式对象的上下文。 
            </div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#getSchemaClassDefinition-java.lang.String-">getSchemaClassDefinition</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
              检索包含命名对象的类定义的模式对象的上下文。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#modifyAttributes-javax.naming.Name-int-javax.naming.directory.Attributes-">modifyAttributes</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name, int mod_op, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)</code>
<div class="block">
              修改与命名对象关联的属性。 
            </div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#modifyAttributes-javax.naming.Name-javax.naming.directory.ModificationItem:A-">modifyAttributes</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name, <a href="../../../javax/naming/directory/ModificationItem.html" title="class in javax.naming.directory">ModificationItem</a>[] mods)</code>
<div class="block">
              使用有序的修改列表修改与命名对象关联的属性。 
            </div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#modifyAttributes-java.lang.String-int-javax.naming.directory.Attributes-">modifyAttributes</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, int mod_op, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)</code>
<div class="block">
              修改与命名对象关联的属性。 
            </div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#modifyAttributes-java.lang.String-javax.naming.directory.ModificationItem:A-">modifyAttributes</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../javax/naming/directory/ModificationItem.html" title="class in javax.naming.directory">ModificationItem</a>[] mods)</code>
<div class="block">
              使用有序的修改列表修改与命名对象关联的属性。 
            </div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#rebind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">rebind</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> obj, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)</code>
<div class="block">
              将名称绑定到对象以及关联的属性，覆盖任何现有绑定。 
            </div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#rebind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">rebind</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> obj, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)</code>
<div class="block">
              将名称绑定到对象以及关联的属性，覆盖任何现有绑定。 
            </div> </td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code><a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-">search</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> matchingAttributes)</code>
<div class="block">
              在单个上下文中搜索包含指定属性集的对象。 
            </div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code><a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-">search</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> matchingAttributes, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] attributesToReturn)</code>
<div class="block">
              在单个上下文中搜索包含指定属性集的对象，并检索所选属性。 
            </div> </td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code><a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#search-javax.naming.Name-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">search</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filterExpr, <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> cons)</code>
<div class="block">
              在命名的上下文或对象中搜索满足给定搜索过滤器的条目。 
            </div> </td>
</tr>
<tr class="rowColor" id="i21">
<td class="colFirst"><code><a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#search-javax.naming.Name-java.lang.String-javax.naming.directory.SearchControls-">search</a></span>(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name, <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> cons)</code>
<div class="block">
              在命名的上下文或对象中搜索满足给定搜索过滤器的条目。 
            </div> </td>
</tr>
<tr class="altColor" id="i22">
<td class="colFirst"><code><a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#search-java.lang.String-javax.naming.directory.Attributes-">search</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> matchingAttributes)</code>
<div class="block">
              在单个上下文中搜索包含指定属性集的对象。 
            </div> </td>
</tr>
<tr class="rowColor" id="i23">
<td class="colFirst"><code><a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#search-java.lang.String-javax.naming.directory.Attributes-java.lang.String:A-">search</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> matchingAttributes, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] attributesToReturn)</code>
<div class="block">
              在单个上下文中搜索包含指定属性集的对象，并检索所选属性。 
            </div> </td>
</tr>
<tr class="altColor" id="i24">
<td class="colFirst"><code><a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#search-java.lang.String-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">search</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filterExpr, <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> cons)</code>
<div class="block">
              在命名的上下文或对象中搜索满足给定搜索过滤器的条目。 
            </div> </td>
</tr>
<tr class="rowColor" id="i25">
<td class="colFirst"><code><a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/InitialDirContext.html#search-java.lang.String-java.lang.String-javax.naming.directory.SearchControls-">search</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <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> cons)</code>
<div class="block">
              在命名的上下文或对象中搜索满足给定搜索过滤器的条目。 
            </div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.naming.InitialContext">
<!-- --> </a> <h3>Methods inherited from class javax.naming.<a href="../../../javax/naming/InitialContext.html" title="class in javax.naming">InitialContext</a></h3> <code><a href="../../../javax/naming/InitialContext.html#addToEnvironment-java.lang.String-java.lang.Object-">addToEnvironment</a>, <a href="../../../javax/naming/InitialContext.html#bind-javax.naming.Name-java.lang.Object-">bind</a>, <a href="../../../javax/naming/InitialContext.html#bind-java.lang.String-java.lang.Object-">bind</a>, <a href="../../../javax/naming/InitialContext.html#close--">close</a>, <a href="../../../javax/naming/InitialContext.html#composeName-javax.naming.Name-javax.naming.Name-">composeName</a>, <a href="../../../javax/naming/InitialContext.html#composeName-java.lang.String-java.lang.String-">composeName</a>, <a href="../../../javax/naming/InitialContext.html#createSubcontext-javax.naming.Name-">createSubcontext</a>, <a href="../../../javax/naming/InitialContext.html#createSubcontext-java.lang.String-">createSubcontext</a>, <a href="../../../javax/naming/InitialContext.html#destroySubcontext-javax.naming.Name-">destroySubcontext</a>, <a href="../../../javax/naming/InitialContext.html#destroySubcontext-java.lang.String-">destroySubcontext</a>, <a href="../../../javax/naming/InitialContext.html#doLookup-javax.naming.Name-">doLookup</a>, <a href="../../../javax/naming/InitialContext.html#doLookup-java.lang.String-">doLookup</a>, <a href="../../../javax/naming/InitialContext.html#getDefaultInitCtx--">getDefaultInitCtx</a>, <a href="../../../javax/naming/InitialContext.html#getEnvironment--">getEnvironment</a>, <a href="../../../javax/naming/InitialContext.html#getNameInNamespace--">getNameInNamespace</a>, <a href="../../../javax/naming/InitialContext.html#getNameParser-javax.naming.Name-">getNameParser</a>, <a href="../../../javax/naming/InitialContext.html#getNameParser-java.lang.String-">getNameParser</a>, <a href="../../../javax/naming/InitialContext.html#getURLOrDefaultInitCtx-javax.naming.Name-">getURLOrDefaultInitCtx</a>, <a href="../../../javax/naming/InitialContext.html#getURLOrDefaultInitCtx-java.lang.String-">getURLOrDefaultInitCtx</a>, <a href="../../../javax/naming/InitialContext.html#init-java.util.Hashtable-">init</a>, <a href="../../../javax/naming/InitialContext.html#list-javax.naming.Name-">list</a>, <a href="../../../javax/naming/InitialContext.html#list-java.lang.String-">list</a>, <a href="../../../javax/naming/InitialContext.html#listBindings-javax.naming.Name-">listBindings</a>, <a href="../../../javax/naming/InitialContext.html#listBindings-java.lang.String-">listBindings</a>, <a href="../../../javax/naming/InitialContext.html#lookup-javax.naming.Name-">lookup</a>, <a href="../../../javax/naming/InitialContext.html#lookup-java.lang.String-">lookup</a>, <a href="../../../javax/naming/InitialContext.html#lookupLink-javax.naming.Name-">lookupLink</a>, <a href="../../../javax/naming/InitialContext.html#lookupLink-java.lang.String-">lookupLink</a>, <a href="../../../javax/naming/InitialContext.html#rebind-javax.naming.Name-java.lang.Object-">rebind</a>, <a href="../../../javax/naming/InitialContext.html#rebind-java.lang.String-java.lang.Object-">rebind</a>, <a href="../../../javax/naming/InitialContext.html#removeFromEnvironment-java.lang.String-">removeFromEnvironment</a>, <a href="../../../javax/naming/InitialContext.html#rename-javax.naming.Name-javax.naming.Name-">rename</a>, <a href="../../../javax/naming/InitialContext.html#rename-java.lang.String-java.lang.String-">rename</a>, <a href="../../../javax/naming/InitialContext.html#unbind-javax.naming.Name-">unbind</a>, <a href="../../../javax/naming/InitialContext.html#unbind-java.lang.String-">unbind</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../java/lang/Object.html#toString--">toString</a>, <a href="../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../java/lang/Object.html#wait-long-int-">wait</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">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="InitialDirContext-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>InitialDirContext</h4> <pre>protected InitialDirContext(boolean lazy)
                     throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span>构造一个初始DirContext，可选择不初始化它。</span>
<span>这可以通过构造函数中，当环境参数的值不会在<tt>InitialDirContext</tt>构造函数被调用的时候还不知道子类中使用。</span>
<span>子类的构造函数调用此构造方法，计算环境的值，然后在返回之前调用<tt>init()。</tt></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>lazy</code> - 真正的手段不初始化初始DirContext;</span>
<span>false相当于调用<tt>new InitialDirContext()</tt></span>
</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="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             1.3 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/naming/InitialContext.html#init-java.util.Hashtable-"><code>InitialContext.init(Hashtable)</code></a>
</dd>
</dl> </li>
</ul> <a name="InitialDirContext--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>InitialDirContext</h4> <pre>public InitialDirContext()
                  throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span>构造一个初始DirContext。</span>
<span>没有提供环境属性。</span>
<span>相当于<tt>new InitialDirContext(null)</tt> 。</span>
</div>
<dl>
<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/directory/InitialDirContext.html#InitialDirContext-java.util.Hashtable-"><code>InitialDirContext(Hashtable)</code></a>
</dd>
</dl> </li>
</ul> <a name="InitialDirContext-java.util.Hashtable-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>InitialDirContext</h4> <pre>public InitialDirContext(<a href="../../../java/util/Hashtable.html" title="class in java.util">Hashtable</a>&lt;?,?&gt; environment)
                  throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span>使用提供的环境构建初始DirContext。</span>
<span>javax.naming.InitialContext类的描述中讨论了<tt>环境</tt>属性。</span>
<p> <span>此构造函数不会修改<tt>environment</tt>或保存对其的<tt>引用</tt> ，但可以保存克隆。</span> <span>在<tt>environment</tt>传递给<tt>构造函数</tt>后，调用者不应修改可变键和值。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>environment</code> - 用于创建初始DirContext的环境。</span>
<span>空指示空的环境。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getAttributes-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributes</h4> <pre>public <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> getAttributes(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)
                         throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#getAttributes-java.lang.String-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>检索与命名对象关联的所有属性。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#getAttributes-javax.naming.Name-"><code>DirContext.getAttributes(Name)</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#getAttributes-java.lang.String-">getAttributes</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 从中检索属性的对象的名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             与name相关联的一组 
            <code>name</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>
</dl> </li>
</ul> <a name="getAttributes-java.lang.String-java.lang.String:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributes</h4> <pre>public <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> getAttributes(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                                <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] attrIds)
                         throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#getAttributes-java.lang.String-java.lang.String:A-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>检索与命名对象关联的所选属性。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#getAttributes-javax.naming.Name-java.lang.String:A-"><code>DirContext.getAttributes(Name, String[])</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#getAttributes-java.lang.String-java.lang.String:A-">getAttributes</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 从中检索属性的对象的名称 
           </dd>
<dd>
<span><code>attrIds</code> - 要检索的属性的标识符。</span>
<span>null表示应检索所有属性;</span>
<span>一个空数组表示不应该检索。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>请求的属性;</span>
<span>从不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="getAttributes-javax.naming.Name-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributes</h4> <pre>public <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> getAttributes(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name)
                         throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#getAttributes-javax.naming.Name-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>检索与命名对象关联的所有属性。</span>
<span>请参阅有关属性模型，属性类型名称和操作属性的类描述。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#getAttributes-javax.naming.Name-">getAttributes</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 从中检索属性的对象的名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>与name相关联的一组<code>name</code> 。</span>
<span>如果name没有属性，返回一个空属性集;</span>
<span>从不为空。</span>
</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/directory/DirContext.html#getAttributes-java.lang.String-"><code>DirContext.getAttributes(String)</code></a> ， 
            <a href="../../../javax/naming/directory/DirContext.html#getAttributes-javax.naming.Name-java.lang.String:A-"><code>DirContext.getAttributes(Name, String[])</code></a>
</dd>
</dl> </li>
</ul> <a name="getAttributes-javax.naming.Name-java.lang.String:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributes</h4> <pre>public <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> getAttributes(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name,
                                <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] attrIds)
                         throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#getAttributes-javax.naming.Name-java.lang.String:A-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>检索与命名对象关联的所选属性。</span>
<span>请参阅有关属性模型，属性类型名称和操作属性的类描述。</span>
<p> <span>如果对象没有指定属性，则该目录将忽略不存在的属性，并返回该对象具有的请求属性。</span> </p>
<p> <span>目录可能会返回比所请求的更多属性（请参阅类描述中的属性<strong>类型名称</strong> ），但不允许返回任意的，不相关的属性。</span> </p>
<p> <span>请参阅类描述也<strong>操作属性</strong> 。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#getAttributes-javax.naming.Name-java.lang.String:A-">getAttributes</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 从中检索属性的对象的名称 
           </dd>
<dd>
<span><code>attrIds</code> - 要检索的属性的标识符。</span>
<span>null表示应检索所有属性;</span>
<span>一个空数组表示不应该检索。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>请求的属性;</span>
<span>从不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="modifyAttributes-java.lang.String-int-javax.naming.directory.Attributes-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>modifyAttributes</h4> <pre>public void modifyAttributes(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                             int mod_op,
                             <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)
                      throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-java.lang.String-int-javax.naming.directory.Attributes-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>修改与命名对象关联的属性。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-int-javax.naming.directory.Attributes-"><code>DirContext.modifyAttributes(Name, int, Attributes)</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-java.lang.String-int-javax.naming.directory.Attributes-">modifyAttributes</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 其属性将被更新的对象的名称 
           </dd>
<dd>
<code>mod_op</code> -修改操作的一个： 
            <code>ADD_ATTRIBUTE</code> ， 
            <code>REPLACE_ATTRIBUTE</code> ， 
            <code>REMOVE_ATTRIBUTE</code> 。 
           </dd>
<dd>
<span><code>attrs</code> - 用于修改的属性;</span>
<span>可能不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/AttributeModificationException.html" title="class in javax.naming.directory">AttributeModificationException</a></code> - 如果修改不能成功完成 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="modifyAttributes-javax.naming.Name-int-javax.naming.directory.Attributes-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>modifyAttributes</h4> <pre>public void modifyAttributes(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name,
                             int mod_op,
                             <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)
                      throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-int-javax.naming.directory.Attributes-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>修改与命名对象关联的属性。</span>
<span>未指定修改的顺序。</span>
<span>在可能的情况下，修改以原子方式执行。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-int-javax.naming.directory.Attributes-">modifyAttributes</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 其属性将被更新的对象的名称 
           </dd>
<dd>
<code>mod_op</code> -修改操作的一个： 
            <code>ADD_ATTRIBUTE</code> ， 
            <code>REPLACE_ATTRIBUTE</code> ， 
            <code>REMOVE_ATTRIBUTE</code> 。 
           </dd>
<dd>
<span><code>attrs</code> - 用于修改的属性;</span>
<span>可能不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/AttributeModificationException.html" title="class in javax.naming.directory">AttributeModificationException</a></code> - 如果修改无法成功完成 
           </dd>
<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/directory/DirContext.html#modifyAttributes-javax.naming.Name-javax.naming.directory.ModificationItem:A-"><code>DirContext.modifyAttributes(Name, ModificationItem[])</code></a>
</dd>
</dl> </li>
</ul> <a name="modifyAttributes-java.lang.String-javax.naming.directory.ModificationItem:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>modifyAttributes</h4> <pre>public void modifyAttributes(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                             <a href="../../../javax/naming/directory/ModificationItem.html" title="class in javax.naming.directory">ModificationItem</a>[] mods)
                      throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-java.lang.String-javax.naming.directory.ModificationItem:A-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>使用有序的修改列表修改与命名对象关联的属性。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-javax.naming.directory.ModificationItem:A-"><code>DirContext.modifyAttributes(Name, ModificationItem[])</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-java.lang.String-javax.naming.directory.ModificationItem:A-">modifyAttributes</a></code>在接口 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 其属性将被更新的对象的名称 
           </dd>
<dd>
<span><code>mods</code> - 要执行的有序修改序列;</span>
<span>可能不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/AttributeModificationException.html" title="class in javax.naming.directory">AttributeModificationException</a></code> - 如果修改不能成功完成 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="modifyAttributes-javax.naming.Name-javax.naming.directory.ModificationItem:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>modifyAttributes</h4> <pre>public void modifyAttributes(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name,
                             <a href="../../../javax/naming/directory/ModificationItem.html" title="class in javax.naming.directory">ModificationItem</a>[] mods)
                      throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-javax.naming.directory.ModificationItem:A-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>使用有序的修改列表修改与命名对象关联的属性。</span>
<span>修改按指定的顺序执行。</span>
<span>每个修改指定修改操作代码和要在其上操作的属性。</span>
<span>在可能的情况下，修改以原子方式执行。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-javax.naming.directory.ModificationItem:A-">modifyAttributes</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 其属性将被更新的对象的名称 
           </dd>
<dd>
<span><code>mods</code> - 要执行的有序修改序列;</span>
<span>可能不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/AttributeModificationException.html" title="class in javax.naming.directory">AttributeModificationException</a></code> - 如果修改不能成功完成 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-int-javax.naming.directory.Attributes-"><code>DirContext.modifyAttributes(Name, int, Attributes)</code></a> ， <a href="../../../javax/naming/directory/ModificationItem.html" title="javax.naming.directory中的类"><code>ModificationItem</code></a></span>
</dd>
</dl> </li>
</ul> <a name="bind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>bind</h4> <pre>public void bind(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                 <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> obj,
                 <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)
          throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#bind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>将名称绑定到对象，以及关联的属性。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#bind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-"><code>DirContext.bind(Name, Object, Attributes)</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#bind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">bind</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 要绑定的名称</span>
<span>可能不是空的</span>
</dd>
<dd>
<span><code>obj</code> - 要绑定的对象;</span>
<span>可能为null</span>
</dd>
<dd>
<code>attrs</code> - 与绑定关联的属性 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NameAlreadyBoundException.html" title="class in javax.naming">NameAlreadyBoundException</a></code> - 如果名称已经绑定 
           </dd>
<dd>
<code><a href="../../../javax/naming/directory/InvalidAttributesException.html" title="class in javax.naming.directory">InvalidAttributesException</a></code> - 如果不提供绑定的某些“强制”属性 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="bind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>bind</h4> <pre>public void bind(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name,
                 <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> obj,
                 <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)
          throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#bind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>将名称绑定到对象，以及关联的属性。</span>
<span>如果<tt>attrs</tt>为null，则所得绑定将具有与<tt>obj</tt>相关的属性，如果<tt>obj</tt>是<tt>DirContext，</tt>否则没有属性。</span>
<span>如果<tt>attrs</tt>是非空值，则结果绑定将具有<tt>attrs</tt>作为其属性;</span>
<span>与<tt>obj相关联的</tt>任何属性都将被忽略。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#bind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">bind</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 要绑定的名称</span>
<span>可能不是空的</span>
</dd>
<dd>
<span><code>obj</code> - 要绑定的对象;</span>
<span>可能为null</span>
</dd>
<dd>
<code>attrs</code> - 与绑定关联的属性 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NameAlreadyBoundException.html" title="class in javax.naming">NameAlreadyBoundException</a></code> - 如果名称已经绑定 
           </dd>
<dd>
<code><a href="../../../javax/naming/directory/InvalidAttributesException.html" title="class in javax.naming.directory">InvalidAttributesException</a></code> - 如果不提供绑定的某些“强制”属性 
           </dd>
<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/Context.html#bind-javax.naming.Name-java.lang.Object-"><code>Context.bind(Name, Object)</code></a> ， 
            <a href="../../../javax/naming/directory/DirContext.html#rebind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-"><code>DirContext.rebind(Name, Object, Attributes)</code></a>
</dd>
</dl> </li>
</ul> <a name="rebind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>rebind</h4> <pre>public void rebind(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                   <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> obj,
                   <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)
            throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#rebind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>将名称绑定到对象以及关联的属性，覆盖任何现有绑定。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#rebind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-"><code>DirContext.rebind(Name, Object, Attributes)</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#rebind-java.lang.String-java.lang.Object-javax.naming.directory.Attributes-">rebind</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 要绑定的名称</span>
<span>可能不是空的</span>
</dd>
<dd>
<span><code>obj</code> - 要绑定的对象;</span>
<span>可能为null</span>
</dd>
<dd>
<code>attrs</code> - 与绑定关联的属性 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/InvalidAttributesException.html" title="class in javax.naming.directory">InvalidAttributesException</a></code> - 如果不提供绑定的某些“强制”属性 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="rebind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>rebind</h4> <pre>public void rebind(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name,
                   <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> obj,
                   <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)
            throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">描述从界面： <code><a href="../../../javax/naming/directory/DirContext.html#rebind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>将名称绑定到对象以及关联的属性，覆盖任何现有绑定。</span>
<span>如果<tt>attrs</tt>为空，并且<tt>obj</tt>是<tt>DirContext</tt> ，则使用来自<tt>obj的属性</tt> 。</span>
<span>如果<tt>attrs</tt>为空，并且<tt>obj</tt>不是<tt>DirContext</tt> ，则与已经绑定在目录中的对象相关联的任何现有属性保持不变。</span>
<span>如果<tt>attrs</tt>不为null，在目录已经绑定的对象关联的所有现有属性被删除<tt>，attrs</tt>与命名对象关联。</span>
<span>如果<tt>obj</tt>是<tt>DirContext</tt> ，并且<tt>attrs</tt>是非空的，那么obj的<tt>属性</tt>将被忽略。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#rebind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-">rebind</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 要绑定的名称</span>
<span>可能不是空的</span>
</dd>
<dd>
<span><code>obj</code> - 要绑定的对象;</span>
<span>可能为null</span>
</dd>
<dd>
<code>attrs</code> - 与绑定关联的属性 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/InvalidAttributesException.html" title="class in javax.naming.directory">InvalidAttributesException</a></code> - 如果不提供绑定的某些“强制”属性 
           </dd>
<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/Context.html#bind-javax.naming.Name-java.lang.Object-"><code>Context.bind(Name, Object)</code></a> ， 
            <a href="../../../javax/naming/directory/DirContext.html#bind-javax.naming.Name-java.lang.Object-javax.naming.directory.Attributes-"><code>DirContext.bind(Name, Object, Attributes)</code></a>
</dd>
</dl> </li>
</ul> <a name="createSubcontext-java.lang.String-javax.naming.directory.Attributes-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createSubcontext</h4> <pre>public <a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a> createSubcontext(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                                   <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)
                            throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#createSubcontext-java.lang.String-javax.naming.directory.Attributes-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>创建和绑定新的上下文以及关联的属性。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#createSubcontext-javax.naming.Name-javax.naming.directory.Attributes-"><code>DirContext.createSubcontext(Name, Attributes)</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#createSubcontext-java.lang.String-javax.naming.directory.Attributes-">createSubcontext</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 要创建的上下文的名称;</span>
<span>可能不是空的</span>
</dd>
<dd>
<code>attrs</code> - 与新创建的上下文关联的属性 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             新创建的上下文 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NameAlreadyBoundException.html" title="class in javax.naming">NameAlreadyBoundException</a></code> - 如果名称已经绑定 
           </dd>
<dd>
<code><a href="../../../javax/naming/directory/InvalidAttributesException.html" title="class in javax.naming.directory">InvalidAttributesException</a></code> - 如果 
            <code>attrs</code>不包含创建所需的所有必需属性 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="createSubcontext-javax.naming.Name-javax.naming.directory.Attributes-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createSubcontext</h4> <pre>public <a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a> createSubcontext(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name,
                                   <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> attrs)
                            throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">描述从界面： <code><a href="../../../javax/naming/directory/DirContext.html#createSubcontext-javax.naming.Name-javax.naming.directory.Attributes-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>创建和绑定新的上下文以及关联的属性。</span>
<span>此方法将创建一个具有给定名称的新子上下文，并将其绑定到目标上下文中（由名称的所有终端原子组件命名），并将提供的属性与新创建的对象相关联。</span>
<span>所有中间和目标上下文必须已经存在。</span>
<span>如果<tt>attrs</tt>为null，则此方法相当于<tt>Context.createSubcontext()</tt> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#createSubcontext-javax.naming.Name-javax.naming.directory.Attributes-">createSubcontext</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 要创建的上下文的名称;</span>
<span>可能不是空的</span>
</dd>
<dd>
<code>attrs</code> - 与新创建的上下文关联的属性 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             新创建的上下文 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NameAlreadyBoundException.html" title="class in javax.naming">NameAlreadyBoundException</a></code> - 如果名称已经绑定 
           </dd>
<dd>
<code><a href="../../../javax/naming/directory/InvalidAttributesException.html" title="class in javax.naming.directory">InvalidAttributesException</a></code> - 如果 
            <code>attrs</code>不包含创建所需的所有必需属性 
           </dd>
<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/Context.html#createSubcontext-javax.naming.Name-"><code>Context.createSubcontext(Name)</code></a>
</dd>
</dl> </li>
</ul> <a name="getSchema-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSchema</h4> <pre>public <a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a> getSchema(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)
                     throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#getSchema-java.lang.String-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>检索与命名对象关联的模式。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#getSchema-javax.naming.Name-"><code>DirContext.getSchema(Name)</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#getSchema-java.lang.String-">getSchema</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要检索其模式的对象的名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>与上下文相关联的模式;</span>
<span>从不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/OperationNotSupportedException.html" title="class in javax.naming">OperationNotSupportedException</a></code> - 如果不支持模式 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="getSchema-javax.naming.Name-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSchema</h4> <pre>public <a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a> getSchema(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name)
                     throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">描述从界面： <code><a href="../../../javax/naming/directory/DirContext.html#getSchema-javax.naming.Name-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>检索与命名对象关联的模式。</span>
<span>该模式描述了关于命名空间的结构和存储在其中的属性的规则。</span>
<span>模式指定可以将什么类型的对象添加到目录以及可以添加到哪里？</span>
<span>对象可以具有什么强制和可选属性。</span>
<span>对架构的支持范围是目录特定的。</span>
<p> <span>此方法返回适用于命名对象的模式信息树的根。</span> <span>几个命名对象（甚至是整个目录）可能共享相同的模式。</span> </p>
<p> <span>诸如架构树的结构和内容，修改模式树的内容的权限以及此类修改对目录的影响等问题取决于底层目录。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#getSchema-javax.naming.Name-">getSchema</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要检索其模式的对象的名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>与上下文相关联的模式;</span>
<span>从不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/OperationNotSupportedException.html" title="class in javax.naming">OperationNotSupportedException</a></code> - 如果不支持模式 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="getSchemaClassDefinition-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSchemaClassDefinition</h4> <pre>public <a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a> getSchemaClassDefinition(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)
                                    throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#getSchemaClassDefinition-java.lang.String-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>检索包含命名对象的类定义的模式对象的上下文。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#getSchemaClassDefinition-javax.naming.Name-"><code>DirContext.getSchemaClassDefinition(Name)</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#getSchemaClassDefinition-java.lang.String-">getSchemaClassDefinition</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要检索其对象类定义的对象的名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>该<tt>DirContext</tt>包含命名对象的类定义;</span>
<span>从不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/OperationNotSupportedException.html" title="class in javax.naming">OperationNotSupportedException</a></code> - 如果不支持模式 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="getSchemaClassDefinition-javax.naming.Name-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSchemaClassDefinition</h4> <pre>public <a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a> getSchemaClassDefinition(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name)
                                    throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#getSchemaClassDefinition-javax.naming.Name-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>检索包含命名对象的类定义的模式对象的上下文。</span>
<p> <span>目录模式中找到的一类信息是<em>类定义</em> 。</span> <span>“对象类”定义指定对象的<em>类型</em>以及对象必须/可以具有的属性（强制和可选）。</span> <span>请注意，这里所指的术语“对象类”在目录中是以Java的方式而不是目录。</span> <span>例如，如果命名对象是“Person”类的目录对象， <tt>那么getSchemaClassDefinition()</tt>将返回一个<tt>DirContext，</tt>表示（目录）的对象类定义“Person”。</span> </p>
<p> <span>可以从对象类定义检索的信息与目录相关。</span> </p>
<p> <span>在JNDI 1.2之前，此方法返回一个表示命名对象的类定义的模式对象。</span> <span>从JNDI 1.2开始，此方法返回一个<tt>DirContext</tt>包含所有命名对象类定义的。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#getSchemaClassDefinition-javax.naming.Name-">getSchemaClassDefinition</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要检索其对象类定义的对象的名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>该<tt>DirContext</tt>包含命名对象的类定义;</span>
<span>从不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/OperationNotSupportedException.html" title="class in javax.naming">OperationNotSupportedException</a></code> - 如果不支持模式 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="search-java.lang.String-javax.naming.directory.Attributes-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>search</h4> <pre>public <a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt; search(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                                              <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> matchingAttributes)
                                       throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-javax.naming.directory.Attributes-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>在单个上下文中搜索包含指定属性集的对象。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-"><code>DirContext.search(Name, Attributes)</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-javax.naming.directory.Attributes-">search</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要搜索的上下文的名称 
           </dd>
<dd>
<code>matchingAttributes</code> - 要搜索的属性 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             枚举 
            <tt>SearchResult个</tt>对象 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="search-javax.naming.Name-javax.naming.directory.Attributes-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>search</h4> <pre>public <a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt; search(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name,
                                              <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> matchingAttributes)
                                       throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>在单个上下文中搜索包含指定属性集的对象。</span>
<span>此方法返回此类对象的所有属性。</span>
<span>它相当于为方法search(Name, Attributes, String[])提供null作为<tt>atributesToReturn</tt> <code>search(Name, Attributes, String[])</code> 。</span>
<br/>
<span>见<a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-"><code>DirContext.search(Name, Attributes, String[])</code></a>完整的说明。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-">search</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要搜索的上下文的名称 
           </dd>
<dd>
<code>matchingAttributes</code> - 要搜索的属性 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             枚举 
            <tt>SearchResult个</tt>对象 
           </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/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-"><code>DirContext.search(Name, Attributes, String[])</code></a>
</dd>
</dl> </li>
</ul> <a name="search-java.lang.String-javax.naming.directory.Attributes-java.lang.String:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>search</h4> <pre>public <a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt; search(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                                              <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> matchingAttributes,
                                              <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] attributesToReturn)
                                       throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-javax.naming.directory.Attributes-java.lang.String:A-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>在单个上下文中搜索包含指定属性集的对象，并检索所选属性。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-"><code>DirContext.search(Name, Attributes, String[])</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-javax.naming.directory.Attributes-java.lang.String:A-">search</a></code>在接口 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要搜索的上下文的名称 
           </dd>
<dd>
<code>matchingAttributes</code> - 要搜索的属性 
           </dd>
<dd>
<code>attributesToReturn</code> - 要返回的属性 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<tt>SearchResult</tt>对象的非空枚举 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>search</h4> <pre>public <a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt; search(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name,
                                              <a href="../../../javax/naming/directory/Attributes.html" title="interface in javax.naming.directory">Attributes</a> matchingAttributes,
                                              <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] attributesToReturn)
                                       throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>在单个上下文中搜索包含指定属性集的对象，并检索所选属性。</span>
<span>搜索使用默认的<code>SearchControls</code>设置执行。</span>
<p> <span>对于要选择的对象，matchingAttributes中的每个<code>matchingAttributes</code>必须匹配对象的某些属性。</span> <span>如果<code>matchingAttributes</code>为空或为null，则返回目标上下文中的所有对象。</span> </p>
<p> <span>在属性<em>A</em> <sub>1</sub> <code>matchingAttributes</code>被认为是匹配的属性<em>A</em> <sub>2</sub>的物体的，如果<em>A</em> <sub>1</sub>和<em>A</em> <sub>2</sub>具有相同的标识符，和<em>A</em> <sub>1</sub>的每个值等于<em>A</em> <sub>2</sub>的某个值。</span> <span>这意味着值的顺序不重要，并且<em>A</em> <sub>2</sub>可能包含在<em>A</em> <sub>1中</sub>找不到的“额外”值，而不影响比较。</span> <span>这也意味着如果<em>A</em> <sub>1</sub>没有值，则匹配的测试等同于测试具有相同标识符的属性<em>A</em> <sub>2</sub>的存在。</span> </p>
<p> <span>用于比较属性值的“等同”的精确定义由底层目录服务定义。</span> <span>例如，它可能使用<code>Object.equals</code>方法，或者可能使用模式来指定不同的相等操作。</span> <span>对于基于除等于的操作（如子串比较）进行匹配，请使用采用过滤器参数的版本<code>search</code> 。</span> </p>
<p> <span>当对此进行更改<tt>DirContext</tt>时，对此方法的先前调用返回的对枚举的影响是未定义的。</span> </p>
<p> <span>如果对象没有指定属性，该目录将忽略不存在的属性，并返回对象所具有的请求属性。</span> </p>
<p> <span>目录可能会返回比所请求的更多属性（请参阅类描述中的属性<strong>类型名称</strong> ），但不允许返回任意的，不相关的属性。</span> </p>
<p> <span>请参阅类描述也<strong>操作属性</strong> 。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-">search</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要搜索的上下文的名称 
           </dd>
<dd>
<span><code>matchingAttributes</code> - 要搜索的属性。</span>
<span>如果为空，则返回目标上下文中的所有对象。</span>
</dd>
<dd>
<span><code>attributesToReturn</code> - 要返回的属性。</span>
<span>null表示要返回的所有属性;</span>
<span>一个空数组表示不返回任何数组。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span><tt>SearchResult</tt>对象的非空枚举。</span>
<span>每个<tt>SearchResult</tt>包含由attributesToReturn标识的<code>attributesToReturn</code>和相对于由<code>name</code>命名的上下文相对应的对象的名称。</span>
</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>
<span><a href="../../../javax/naming/directory/SearchControls.html" title="javax.naming.directory中的类"><code>SearchControls</code></a> ， <a href="../../../javax/naming/directory/SearchResult.html" title="javax.naming.directory中的类"><code>SearchResult</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(Name, String, Object[], SearchControls)</code></a></span>
</dd>
</dl> </li>
</ul> <a name="search-java.lang.String-java.lang.String-javax.naming.directory.SearchControls-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>search</h4> <pre>public <a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt; search(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                                              <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> cons)
                                       throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">描述从界面： <code><a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-java.lang.String-javax.naming.directory.SearchControls-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>在命名的上下文或对象中搜索满足给定搜索过滤器的条目。</span>
<span>按照搜索控件的指定执行搜索。</span>
<span>详见<a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-java.lang.String-javax.naming.directory.SearchControls-"><code>DirContext.search(Name, String, SearchControls)</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-java.lang.String-javax.naming.directory.SearchControls-">search</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要搜索的上下文或对象的名称 
           </dd>
<dd>
<span><code>filter</code> - 用于搜索的过滤器表达式;</span>
<span>可能不为空</span>
</dd>
<dd>
<span><code>cons</code> - 控制搜索的搜索控件。</span>
<span>如果为空，则使用默认搜索控件（相当于<tt>(new SearchControls())</tt> ）。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             枚举满足过滤器的对象为 
            <tt>SearchResult</tt> 。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/InvalidSearchFilterException.html" title="class in javax.naming.directory">InvalidSearchFilterException</a></code> - 如果指定的搜索过滤器不被底层目录支持或理解 
           </dd>
<dd>
<code><a href="../../../javax/naming/directory/InvalidSearchControlsException.html" title="class in javax.naming.directory">InvalidSearchControlsException</a></code> - 搜索控件是否包含无效设置 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="search-javax.naming.Name-java.lang.String-javax.naming.directory.SearchControls-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>search</h4> <pre>public <a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt; search(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name,
                                              <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> cons)
                                       throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-java.lang.String-javax.naming.directory.SearchControls-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>在命名的上下文或对象中搜索满足给定搜索过滤器的条目。</span>
<span>按照搜索控件的指定执行搜索。</span>
<p> <span>的格式和解释<code>filter</code>遵循RFC 2254，解释如下<code>attr</code>和<code>value</code> RFC中提及。</span> </p>
<p> <span><code>attr</code>是属性的标识符。</span> </p>
<p> <span><code>value</code>是属性值的字符串表示形式。</span> <span>将此字符串表示形式转换为属性值是特定于目录的。</span> </p>
<p> <span>对于断言“someCount = 127”，例如， <code>attr</code>是“someCount”， <code>value</code>是“127”。</span> <span>提供者根据属性ID（“someCount”）（以及可能的模式）确定属性的值是整数。</span> <span>然后适当地解析字符串“127”。</span> </p>
<p> <span>过滤器字符串中的任何非ASCII字符都应由适当的Java（Unicode）字符表示，而不是以UTF-8字节编码。</span> <span>或者，可以使用RFC 2254中描述的“反斜杠十六进制”符号。</span> </p>
<p> <span>如果目录不支持部分或全部其属性的字符串表示的形式<code>search</code>接受在对象的形式过滤器参数可以用来代替。</span> <span>然后，这样一个目录的服务提供商将把过滤器参数转换成用于过滤器评估的服务特定表示。</span> <span>见<code>search(Name, String, Object[], SearchControls)</code> 。</span> </p>
<p> <span>RFC 2254为过滤器定义了某些运算符，包括子串匹配，等式，近似匹配，大于，小于。</span> <span>这些运算符映射到基础目录中具有相应语义的运算符。</span> <span>例如，对于equals运算符，假设目录具有定义过滤器中属性“等于”的匹配规则。</span> <span>该规则将用于检查过滤器中指定的属性与目录中对象属性的相等性。</span> <span>类似地，如果目录具有用于排序的匹配规则，则该规则将用于进行“大于”和“小于”比较。</span> </p>
<p> <span>并非RFC 2254中定义的所有运算符都适用于所有属性。</span> <span>当操作员不适用时，抛出异常<code>InvalidSearchFilterException</code> 。</span> </p>
<p> <span>结果以枚举<tt>SearchResult</tt> s的形式返回。</span> <span>每个<tt>SearchResult</tt>包含对象的名称和有关对象的其他信息（请参阅SearchResult）。</span> <span>该名称是相对于搜索的目标上下文（由<code>name</code>参数命名的），或者它是一个URL字符串。</span> <span>如果目标上下文包含在枚举中（ <code>cons</code>指定<code>SearchControls.OBJECT_SCOPE</code>或<code>SearchControls.SUBSTREE_SCOPE</code>的搜索范围是可能的），其名称为空字符串。</span> <span><tt>SearchResult</tt>也可以包含匹配对象的属性，如果<tt>cons</tt>参数指定返回属性。</span> </p>
<p> <span>如果对象没有请求的属性，则该不存在的属性将被忽略。</span> <span>将返回对象确实拥有的那些请求的属性。</span> </p>
<p> <span>目录可能会返回比所请求的更多属性（请参阅类描述中的属性<strong>类型名称</strong> ），但不允许返回任意不相关的属性。</span> </p>
<p> <span>请参阅类描述也<strong>操作属性</strong> 。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-java.lang.String-javax.naming.directory.SearchControls-">search</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要搜索的上下文或对象的名称 
           </dd>
<dd>
<span><code>filter</code> - 用于搜索的过滤器表达式;</span>
<span>可能不为空</span>
</dd>
<dd>
<span><code>cons</code> - 控制搜索的搜索控件。</span>
<span>如果为空，则使用默认搜索控件（相当于<tt>(new SearchControls())</tt> ）。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>枚举满足过滤器的对象的<tt>SearchResult</tt> s;</span>
<span>从不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/InvalidSearchFilterException.html" title="class in javax.naming.directory">InvalidSearchFilterException</a></code> - 如果指定的搜索过滤器不受底层目录的支持或理解 
           </dd>
<dd>
<code><a href="../../../javax/naming/directory/InvalidSearchControlsException.html" title="class in javax.naming.directory">InvalidSearchControlsException</a></code> - 如果搜索控件包含无效设置 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><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(Name, String, Object[], SearchControls)</code></a> ， <a href="../../../javax/naming/directory/SearchControls.html" title="javax.naming.directory中的类"><code>SearchControls</code></a> ， <a href="../../../javax/naming/directory/SearchResult.html" title="javax.naming.directory中的类"><code>SearchResult</code></a></span>
</dd>
</dl> </li>
</ul> <a name="search-java.lang.String-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>search</h4> <pre>public <a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt; search(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
                                              <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filterExpr,
                                              <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> cons)
                                       throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>在命名的上下文或对象中搜索满足给定搜索过滤器的条目。</span>
<span>按照搜索控件的指定执行搜索。</span>
<span>详见<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(Name, String, Object[], SearchControls)</code></a> 。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#search-java.lang.String-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">search</a></code>在界面 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要搜索的上下文或对象的名称 
           </dd>
<dd>
<span><code>filterExpr</code> - 用于搜索的过滤器表达式。</span>
<span>表达式可能包含“ <code>{i}</code> ”形式的<code>{i}</code> ，其中<code>i</code>是非负整数。</span>
<span>可能不为空</span>
</dd>
<dd>
<span><code>filterArgs</code> - 在filterExpr中替换变量的参数<code>filterExpr</code> 。</span>
<span><code>filterArgs[i]</code>的值将替换每次出现的“ <code>{i}</code> ”。</span>
<span>如果为空，则相当于一个空数组。</span>
</dd>
<dd>
<span><code>cons</code> - 控制搜索的搜索控件。</span>
<span>如果为空，则使用默认搜索控件（相当于<tt>(new SearchControls())</tt> ）。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>枚举满足过滤器的对象的<tt>SearchResult</tt> s;</span>
<span>从不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/InvalidSearchControlsException.html" title="class in javax.naming.directory">InvalidSearchControlsException</a></code> - 如果 
            <tt>cons</tt>包含无效设置 
           </dd>
<dd>
<code><a href="../../../javax/naming/directory/InvalidSearchFilterException.html" title="class in javax.naming.directory">InvalidSearchFilterException</a></code> -如果 
            <tt>filterExpr</tt>与 
            <tt>filterArgs</tt>表示无效的搜索过滤器 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
</dl> </li>
</ul> <a name="search-javax.naming.Name-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>search</h4> <pre>public <a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a>&lt;<a href="../../../javax/naming/directory/SearchResult.html" title="class in javax.naming.directory">SearchResult</a>&gt; search(<a href="../../../javax/naming/Name.html" title="interface in javax.naming">Name</a> name,
                                              <a href="../../../java/lang/String.html" title="class in java.lang">String</a> filterExpr,
                                              <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> cons)
                                       throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span class="descfrmTypeLabel">描述从界面： <code><a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">DirContext</a></code>复制</span>
</div>
<div class="block">
<span>在命名的上下文或对象中搜索满足给定搜索过滤器的条目。</span>
<span>按照搜索控件的指定执行搜索。</span>
<p> <span>filterExpr的<code>filterExpr</code>基于RFC 2254.它还可以包含{i}格式的<code>{i}</code> ，其中<code>i</code>是一个整数，表示<code>filterArgs</code>数组中的对象。</span> <span>filterExpr的<code>filterExpr</code>与方法<code>search(Name, String, SearchControls)</code>的<code>filter</code>参数的<code>search(Name, String, SearchControls)</code> 。</span> </p>
<p> <span>当变量<code>{i}</code>出现在搜索过滤器中时，表示在该位置使用过滤器参数<code>filterArgs[i]</code> 。</span> <span>在RFC 2254第4节的过滤器语法中出现<em>attr</em> ， <em>value</em>或<em>matchingrule</em>生产的任何地方都可以使用这些变量。当一个字符串值过滤器参数代替一个变量时，过滤器被解释为：变量的位置，具有根据RFC 2254的规则被转义的过滤器（如<code>'*'</code> ）中具有特殊意义的任何字符。</span> </p>
<p> <span>对于不对某些或全部属性使用字符串表示形式的目录，与属性值相对应的过滤器参数可能不是String类型。</span> <span>例如，支持非结构化二进制值属性的目录应该接受字节数组作为过滤器参数。</span> <span>任何其他类型的过滤器参数的解释（如果有）由该目录的服务提供者确定，该服务提供者将过滤器操作映射到基础目录中具有相应语义的操作。</span> </p>
<p> <span>此方法返回结果的枚举。</span> <span>枚举中的每个元素都包含对象的名称和有关对象的其他信息（参见<code>SearchResult</code> ）。</span> <span>该名称是相对于搜索的目标上下文（由<code>name</code>参数命名的），或者它是一个URL字符串。</span> <span>如果目标上下文包括在枚举（如可能时<code>cons</code>指定的检索范围<code>SearchControls.OBJECT_SCOPE</code>或<code>SearchControls.SUBSTREE_SCOPE</code> ），其名称为空字符串。</span> </p>
<p> <span><tt>SearchResult</tt>也可以包含匹配对象的属性，如果<tt>cons</tt>参数指定返回属性。</span> </p>
<p> <span>如果对象没有请求的属性，则该不存在的属性将被忽略。</span> <span>将返回对象确实拥有的那些请求的属性。</span> </p>
<p> <span>目录可能会返回比所请求的更多属性（请参阅类描述中的属性<strong>类型名称</strong> ），但不允许返回任意不相关的属性。</span> </p>
<p> <span>如果为此方法提供了带有无效变量替换的搜索过滤器，则结果未定义。</span> <span>当对此DirContext进行更改时，对此方法的先前调用返回的对枚举的影响是未定义的。</span> </p>
<p> <span>请参阅类描述也<strong>操作属性</strong> 。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-java.lang.String-java.lang.Object:A-javax.naming.directory.SearchControls-">search</a></code>在接口 
            <code><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 要搜索的上下文或对象的名称 
           </dd>
<dd>
<span><code>filterExpr</code> - 用于搜索的过滤器表达式。</span>
<span>该表达式可能包含“ <code>{i}</code> ”形式的<code>{i}</code> ，其中<code>i</code>是非负整数。</span>
<span>可能不为空</span>
</dd>
<dd>
<span><code>filterArgs</code> - 在filterExpr中替换变量的参数<code>filterExpr</code> 。</span>
<span><code>filterArgs[i]</code>的值将取代每个“ <code>{i}</code> ”的发生。</span>
<span>如果为空，则相当于一个空数组。</span>
</dd>
<dd>
<span><code>cons</code> - 控制搜索的搜索控件。</span>
<span>如果为空，则使用默认搜索控件（相当于<tt>(new SearchControls())</tt> ）。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>枚举满足过滤器的对象的<tt>SearchResult</tt> s;</span>
<span>从不为空</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/naming/directory/InvalidSearchControlsException.html" title="class in javax.naming.directory">InvalidSearchControlsException</a></code> - 如果 
            <tt>cons</tt>包含无效设置 
           </dd>
<dd>
<code><a href="../../../javax/naming/directory/InvalidSearchFilterException.html" title="class in javax.naming.directory">InvalidSearchFilterException</a></code> -如果 
            <tt>filterExpr</tt>与 
            <tt>filterArgs</tt>表示无效的搜索过滤器 
           </dd>
<dd>
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code> - 如果遇到命名异常 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../javax/naming/directory/DirContext.html#search-javax.naming.Name-javax.naming.directory.Attributes-java.lang.String:A-"><code>DirContext.search(Name, Attributes, String[])</code></a> ， <a href="../../../java/text/MessageFormat.html" title="java.text中的类"><code>MessageFormat</code></a></span>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>