mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-06 09:02:49 +08:00
678 lines
30 KiB
HTML
678 lines
30 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
javax.naming.directory
|
||
</div>
|
||
<h2 class="title" title="Interface Attribute">Interface Attribute</h2>
|
||
</div><div class="contentContainer">
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<dl>
|
||
<dt>
|
||
All Superinterfaces:
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../java/lang/Cloneable.html" title="java.lang中的接口">Cloneable</a> , <a href="../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a></span>
|
||
</dd>
|
||
</dl>
|
||
<dl>
|
||
<dt>
|
||
所有已知实现类:
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/naming/directory/BasicAttribute.html" title="javax.naming.directory中的类">BasicAttribute</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public interface <span class="typeNameLabel">Attribute</span>
|
||
extends <a href="../../../java/lang/Cloneable.html" title="interface in java.lang">Cloneable</a>, <a href="../../../java/io/Serializable.html" title="interface in java.io">Serializable</a></pre>
|
||
<div class="block">
|
||
<span>此接口表示与命名对象关联的属性。</span>
|
||
<p> <span>在一个目录中,命名对象可以与它们相关联的属性。</span> <span><tt>Attribute</tt>接口表示与命名对象关联的属性。</span> <span>属性包含0个或更多,可能为null的值。</span> <span>属性值可以是有序的或无序的(参见<tt>isOrdered()</tt> )。</span> <span>如果值无序,则不允许重复。</span> <span>如果值被排序,则允许重复。</span> </p>
|
||
<p> <span>属性及其值的内容和表示由属性的<em>模式定义</em> 。</span> <span>该模式包含有关属性的属性的语法和其他属性的信息。</span> <span>有关如何在基础目录服务支持模式时如何获取有关属性的架构信息的详细信息,请参阅<tt>getAttributeDefinition()</tt>和<tt>getAttributeSyntaxDefinition()</tt> 。</span> </p>
|
||
<p> <span>两个属性的平等由实现类决定。</span> <span>简单的实现可以使用<tt>Object.equals()</tt>来确定属性值的相等性,而更复杂的实现可能会使用模式信息来确定相等性。</span> <span>类似地,一个实现可以提供静态存储结构,其简单地返回传递给其构造器的值,而另一个实现可以定义<tt>get()</tt>和<tt>getAll()</tt> 。</span> <span>从目录动态获取值。</span> </p>
|
||
<p> <span>请注意, <tt>Attribute的</tt>更新(如添加或删除值)不会影响目录中属性的相应表示形式。</span> <span>只能使用DirContext接口中的操作来<tt>更新</tt>目录。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始:</span>
|
||
</dt>
|
||
<dd>
|
||
1.3
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/naming/directory/BasicAttribute.html" title="javax.naming.directory中的类"><code>BasicAttribute</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>
|
||
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
|
||
<caption>
|
||
<span>Fields</span>
|
||
<span class="tabEnd"> </span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier and Type</th>
|
||
<th class="colLast" scope="col">Field and Description</th>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code>static long</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#serialVersionUID">serialVersionUID</a></span></code>
|
||
<div class="block">
|
||
使用JNDI 1.1.1的serialVersionUID进行互操作。
|
||
</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="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier and Type</th>
|
||
<th class="colLast" scope="col">Method and Description</th>
|
||
</tr>
|
||
<tr class="altColor" id="i0">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#add-int-java.lang.Object-">add</a></span>(int ix, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> attrVal)</code>
|
||
<div class="block">
|
||
向属性值的有序列表添加属性值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#add-java.lang.Object-">add</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> attrVal)</code>
|
||
<div class="block">
|
||
向属性添加一个新值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#clear--">clear</a></span>()</code>
|
||
<div class="block">
|
||
从此属性中删除所有值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#clone--">clone</a></span>()</code>
|
||
<div class="block">
|
||
制作属性的副本。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#contains-java.lang.Object-">contains</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> attrVal)</code>
|
||
<div class="block">
|
||
确定值是否在属性中。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i5">
|
||
<td class="colFirst"><code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#get--">get</a></span>()</code>
|
||
<div class="block">
|
||
检索此属性值之一。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i6">
|
||
<td class="colFirst"><code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#get-int-">get</a></span>(int ix)</code>
|
||
<div class="block">
|
||
从有序的属性值列表中检索属性值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i7">
|
||
<td class="colFirst"><code><a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a><?></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#getAll--">getAll</a></span>()</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/Attribute.html#getAttributeDefinition--">getAttributeDefinition</a></span>()</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/Attribute.html#getAttributeSyntaxDefinition--">getAttributeSyntaxDefinition</a></span>()</code>
|
||
<div class="block">
|
||
检索与属性相关联的语法定义。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i10">
|
||
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#getID--">getID</a></span>()</code>
|
||
<div class="block">
|
||
检索此属性的ID。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i11">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#isOrdered--">isOrdered</a></span>()</code>
|
||
<div class="block">
|
||
确定此属性的值是否被排序。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i12">
|
||
<td class="colFirst"><code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#remove-int-">remove</a></span>(int ix)</code>
|
||
<div class="block">
|
||
从有序的属性值列表中删除属性值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i13">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#remove-java.lang.Object-">remove</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> attrval)</code>
|
||
<div class="block">
|
||
从属性中删除指定的值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i14">
|
||
<td class="colFirst"><code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#set-int-java.lang.Object-">set</a></span>(int ix, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> attrVal)</code>
|
||
<div class="block">
|
||
在属性值的有序列表中设置属性值。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i15">
|
||
<td class="colFirst"><code>int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/Attribute.html#size--">size</a></span>()</code>
|
||
<div class="block">
|
||
检索此属性中的值的数量。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="details">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- ============ FIELD DETAIL =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="field.detail">
|
||
<!-- --> </a> <h3>字段详细信息</h3> <a name="serialVersionUID">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>serialVersionUID</h4> <pre>static final long serialVersionUID</pre>
|
||
<div class="block">
|
||
使用JNDI 1.1.1的serialVersionUID进行互操作。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../constant-values.html#javax.naming.directory.Attribute.serialVersionUID">Constant Field Values</a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ============ METHOD DETAIL ========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.detail">
|
||
<!-- --> </a> <h3>方法详细信息</h3> <a name="getAll--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getAll</h4> <pre><a href="../../../javax/naming/NamingEnumeration.html" title="interface in javax.naming">NamingEnumeration</a><?> getAll()
|
||
throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
|
||
<div class="block">
|
||
<span>检索属性值的枚举。</span>
|
||
<span>如果在枚举过程中添加,更改或删除属性的值,则此枚举的行为是未指定的。</span>
|
||
<span>如果属性值被排序,则枚举的项将被排序。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>属性值的非空枚举。</span>
|
||
<span>枚举的每个元素都是可能为空的Object。</span>
|
||
<span>对象的类是属性值的类。</span>
|
||
<span>如果属性的值为null,则该元素为null。</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/Attribute.html#isOrdered--"><code>isOrdered()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="get--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>get</h4> <pre><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> get()
|
||
throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
|
||
<div class="block">
|
||
<span>检索此属性值之一。</span>
|
||
<span>如果属性具有多个值且无序,则返回任何一个值。</span>
|
||
<span>如果属性具有多个值并被排序,则返回第一个值。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>表示属性值之一的可能为null的对象。</span>
|
||
<span>如果属性的值为null,则为null。</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>
|
||
<dd>
|
||
<code><a href="../../../java/util/NoSuchElementException.html" title="class in java.util">NoSuchElementException</a></code> - 如果此属性没有值。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="size--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>size</h4> <pre>int size()</pre>
|
||
<div class="block">
|
||
检索此属性中的值的数量。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
此属性中的非负数值。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getID--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getID</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getID()</pre>
|
||
<div class="block">
|
||
检索此属性的ID。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>该属性的id。</span>
|
||
<span>它不能为空。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="contains-java.lang.Object-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>contains</h4> <pre>boolean contains(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> attrVal)</pre>
|
||
<div class="block">
|
||
<span>确定值是否在属性中。</span>
|
||
<span>平等由实现决定,可以使用<tt>Object.equals()</tt>或模式信息来确定相等。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>attrVal</code> - 可能要检查的空值。</span>
|
||
<span>如果为null,请检查属性是否具有值为null的属性值。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>如果attrVal是此属性的值之一,则为true;</span>
|
||
<span>否则为假。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../java/lang/Object.html#equals-java.lang.Object-"><code>Object.equals(java.lang.Object)</code></a> ,
|
||
<a href="../../../javax/naming/directory/BasicAttribute.html#equals-java.lang.Object-"><code>BasicAttribute.equals(java.lang.Object)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="add-java.lang.Object-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>add</h4> <pre>boolean add(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> attrVal)</pre>
|
||
<div class="block">
|
||
<span>向属性添加一个新值。</span>
|
||
<span>如果属性值无序,并且<tt>属性</tt>中已经有attrVal,则此方法不起作用。</span>
|
||
<span>如果属性值被排序, <tt>则将attrVal</tt>添加到属性值列表的末尾。</span>
|
||
<p> <span>平等由实现决定,可以使用<tt>Object.equals()</tt>或模式信息来确定相等。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>attrVal</code> - 要添加的新的可能的空值。</span>
|
||
<span>如果为null,则添加null作为属性值。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>如果添加了值,则为true;</span>
|
||
<span>否则为假。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="remove-java.lang.Object-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>remove</h4> <pre>boolean remove(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> attrval)</pre>
|
||
<div class="block">
|
||
<span>从属性中删除指定的值。</span>
|
||
<span>如果<tt>attrval</tt>不在属性中,则此方法不执行任何操作。</span>
|
||
<span>如果属性值被排序,则删除第一次出现的<tt>attrVal</tt> ,并且索引大于移除值的属性值向上移动到列表的头部(并且它们的索引减1)。</span>
|
||
<p> <span>平等由实现决定,可以使用<tt>Object.equals()</tt>或模式信息来确定相等。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>attrval</code> - 从该属性中删除的可能的空值。</span>
|
||
<span>如果为null,则删除属性值为null。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>如果值被删除,则为true;</span>
|
||
<span>否则为假。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="clear--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>clear</h4> <pre>void clear()</pre>
|
||
<div class="block">
|
||
从此属性中删除所有值。
|
||
</div> </li>
|
||
</ul> <a name="getAttributeSyntaxDefinition--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getAttributeSyntaxDefinition</h4> <pre><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a> getAttributeSyntaxDefinition()
|
||
throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
|
||
<div class="block">
|
||
<span>检索与属性相关联的语法定义。</span>
|
||
<span>属性的语法定义指定属性值的格式。</span>
|
||
<span>请注意,这不同于属性值的表示形式作为Java对象。</span>
|
||
<span>语法定义是指目录的<em>语法</em>概念。</span>
|
||
<p> <span>例如,即使值可能是Java String对象,其目录语法可能是“可打印字符串”或“电话号码”。</span> <span>或者一个值可能是一个字节数组,其目录语法是“JPEG”或“证书”。</span> <span>例如,如果此属性的语法为“JPEG”,则此方法将返回“JPEG”的语法定义。</span> </p>
|
||
<p> <span>您可以从语法定义中检索的信息与目录相关。</span> </p>
|
||
<p> <span>如果一个实现不支持模式,它应该抛出OperationNotSupportedException。</span> <span>如果一个实现支持模式,它应该定义这个方法来返回适当的信息。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<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="getAttributeDefinition--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getAttributeDefinition</h4> <pre><a href="../../../javax/naming/directory/DirContext.html" title="interface in javax.naming.directory">DirContext</a> getAttributeDefinition()
|
||
throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
|
||
<div class="block">
|
||
<span>检索属性的模式定义。</span>
|
||
<span>属性的模式定义包含诸如属性是多值的还是单值的信息,在比较属性值时使用的匹配规则。</span>
|
||
<span>您可以从属性定义检索的信息与目录相关。</span>
|
||
<p> <span>如果一个实现不支持模式,它应该抛出OperationNotSupportedException。</span> <span>如果一个实现支持模式,它应该定义这个方法来返回适当的信息。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<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="clone--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>clone</h4> <pre><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> clone()</pre>
|
||
<div class="block">
|
||
<span>制作属性的副本。</span>
|
||
<span>该副本包含与原始属性相同的属性值:属性值本身不被克隆。</span>
|
||
<span>副本的更改不会影响原始文件,反之亦然。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
属性的非空拷贝。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="isOrdered--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>isOrdered</h4> <pre>boolean isOrdered()</pre>
|
||
<div class="block">
|
||
<span>确定此属性的值是否被排序。</span>
|
||
<span>如果一个属性的值被排序,则允许重复的值。</span>
|
||
<span>如果一个属性的值是无序的,它们以任何顺序呈现,并且没有重复的值。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>如果此属性的值被排序,则为true;</span>
|
||
<span>否则为假。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/naming/directory/Attribute.html#get-int-"><code>get(int)</code></a> ,
|
||
<a href="../../../javax/naming/directory/Attribute.html#remove-int-"><code>remove(int)</code></a> ,
|
||
<a href="../../../javax/naming/directory/Attribute.html#add-int-java.lang.Object-"><code>add(int, java.lang.Object)</code></a> ,
|
||
<a href="../../../javax/naming/directory/Attribute.html#set-int-java.lang.Object-"><code>set(int, java.lang.Object)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="get-int-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>get</h4> <pre><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> get(int ix)
|
||
throws <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
|
||
<div class="block">
|
||
<span>从有序的属性值列表中检索属性值。</span>
|
||
<span>此方法返回在<tt>ix</tt>索引的属性值的列表中的值。</span>
|
||
<span>如果属性值是无序的,则此方法返回恰好在该索引处的值。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>ix</code> - 属性值有序列表中的值的索引。</span>
|
||
<span><code>0 <= ix < size()</code> 。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>索引<tt>ix</tt>可能为null的属性值;</span>
|
||
<span>如果属性值为null,则为null。</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>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果
|
||
<tt>ix</tt>在指定范围之外。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="remove-int-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>remove</h4> <pre><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> remove(int ix)</pre>
|
||
<div class="block">
|
||
<span>从有序的属性值列表中删除属性值。</span>
|
||
<span>此方法删除在<tt>ix</tt>索引的属性值的列表中的值。</span>
|
||
<span>如果属性值是无序的,则此方法将删除恰好在该索引处的值。</span>
|
||
<span>位于大于<tt>ix的</tt>指数的值<tt>向上</tt>移动到列表的前面(并且它们的指数减1)。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>ix</code> - 要删除的值的索引。</span>
|
||
<span><code>0 <= ix < size()</code> 。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>索引号为<tt>ix</tt>的可能为null的属性值被删除;</span>
|
||
<span>如果属性值为null,则为null。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果
|
||
<tt>ix</tt>在指定范围之外。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="add-int-java.lang.Object-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>add</h4> <pre>void add(int ix,
|
||
<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> attrVal)</pre>
|
||
<div class="block">
|
||
<span>向属性值的有序列表添加属性值。</span>
|
||
<span>此方法将<tt>attrVal</tt>添加到索引<tt>号</tt>为ix的属性值列表。</span>
|
||
<span>位于或大于<tt>ix的</tt>指数的值向下移动到列表的末尾(并且它们的指数递增1)。</span>
|
||
<span>如果属性值无序且已经有<tt>attrVal</tt> ,则抛出<tt>IllegalStateException</tt> 。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>ix</code> - 添加新值的属性值的有序列表中的索引。</span>
|
||
<span><code>0 <= ix <= size()</code> 。</span>
|
||
</dd>
|
||
<dd>
|
||
<span><code>attrVal</code> - 要添加的可能的null属性值;</span>
|
||
<span>如果为null,则为添加的值。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果
|
||
<tt>ix</tt>在指定范围之外。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果属性值是无序的,并且
|
||
<tt>attrVal</tt>是这些值之一。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="set-int-java.lang.Object-">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>set</h4> <pre><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> set(int ix,
|
||
<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> attrVal)</pre>
|
||
<div class="block">
|
||
<span>在属性值的有序列表中设置属性值。</span>
|
||
<span>此方法将属性值列表的<tt>ix</tt>索引值设置为<tt>attrVal</tt> 。</span>
|
||
<span>旧值被删除。</span>
|
||
<span>如果属性值无序,则该方法将该索引处的值设置为<tt>attrVal</tt> ,除非<tt>attrVal</tt>已经是其中一个值。</span>
|
||
<span>在这种情况下,抛出<tt>IllegalStateException</tt> 。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>ix</code> - 属性值有序列表中的值的索引。</span>
|
||
<span><code>0 <= ix < size()</code> 。</span>
|
||
</dd>
|
||
<dd>
|
||
<span><code>attrVal</code> - 要使用的可能为null的属性值。</span>
|
||
<span>如果为null,'null'替换旧值。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>索引ix上可能为null的属性值被替换。</span>
|
||
<span>如果属性值为空,则为空。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果
|
||
<tt>ix</tt>在指定范围之外。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果
|
||
<tt>attrVal</tt>已经存在且属性值无序。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |