uTools-Manuals/docs/java/javax/naming/CompositeName.html

956 lines
42 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact3
</div>
<div class="subTitle">
javax.naming
</div>
<h2 class="title" title="Class CompositeName">Class CompositeName</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>javax.naming.CompositeName</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../java/io/Serializable.html" title="java.io中的接口">Serializable</a> <a href="../../java/lang/Cloneable.html" title="java.lang中的接口">Cloneable</a> <a href="../../java/lang/Comparable.html" title="java.lang中的接口">Comparable</a> &lt; <a href="../../java/lang/Object.html" title="java.lang中的类">Object</a> &gt; <a href="../../javax/naming/Name.html" title="javax.naming中的接口">Name</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">CompositeName</span>
extends <a href="../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></pre>
<div class="block">
<span>此类表示组合名称 - 跨多个命名空间的组件名称序列。</span>
<span>每个组件是命名系统的命名空间中的字符串名称。</span>
<span>如果组件来自分层命名空间则可以使用CompoundName类将该组件进一步解析为其原子部分。</span>
<p> <span>组合名称的组件被编号。</span> <span>具有N个组件的组合名称的索引范围从0到但不包括N。该范围可以写为[0N]。</span> <span>最重要的组件是索引0.空复合名称没有组件。</span> </p>
<h1> <span>JNDI复合名称语法</span> </h1>
<span>JNDI定义了复合名称的标准字符串表示形式。</span>
<span>该表示形式是使用组件分隔符(一个正斜杠字符(/))将组合名称的组件从左到右连接在一起,以分隔每个组件。</span>
<span>JNDI语法定义了以下元字符</span>
<ul>
<li> <span>逃避(反斜杠\</span> </li>
<li> <span>报价字符(单(')和双引号(“))和</span> </li>
<li> <span>组件分隔符(正斜杠字符(/))。</span> </li>
</ul>
<span>前导引号,任何元字符之前的转义,组件结尾处的转义,或未引用组件中的组件分隔符必须在该组件被组合成复合名称字符串的前面带有转义字符。</span>
<span>或者,为避免添加如所述的转义字符,可以使用匹配的单引号或匹配的双引号来引用整个组件。</span>
<span>在双引号组件中出现的单引号不被视为元字符(并且不需要转义),反之亦然。</span>
<p> <span>当比较两个复合名称时,字符的大小是很重要的。</span> </p>
<p> <span>前导组件分隔符(复合名称字符串以分隔符开头)表示前导空组件(由空字符串组成的组件)。</span> <span>尾部组件分隔符(复合名称字符串以分隔符结尾)表示尾部空白组件。</span> <span>相邻的组件分隔符表示空组件。</span> </p>
<h1> <span>复合名称示例</span> </h1>
<span>该表显示了一些复合名称的示例。</span>
<span>每行显示一个复合名称的字符串形式及其相应的结构形式( <tt>CompositeName</tt> )。</span>
<span> String Name CompositeName "" {} (the empty name == new CompositeName("") == new CompositeName()) "x" {"x"} "x/y" {"x", "y"} "x/" {"x", ""} "/x" {"", "x"} "/" {""} "//" {"", ""} "/x/" {"", "x", ""} "x//y" {"x", "", "y"} </span>
<table border="1" cellpadding="3" summary="examples showing string form of composite name and its corresponding structural form (CompositeName)">
</table>
<h1> <span>组合示例</span> </h1>
<span>以下是一些组合示例。</span>
<span>右列显示组合字符串复合名称,左侧列显示组成相应的<tt>CompositeName</tt> s。</span>
<span>请注意,组合两个复合名称的字符串形式只需要将其字符串形式连接在一起。</span>
<span> String Names CompositeNames "x/y" + "/" = x/y/ {"x", "y"} + {""} = {"x", "y", ""} "" + "x" = "x" {} + {"x"} = {"x"} "/" + "x" = "/x" {""} + {"x"} = {"", "x"} "x" + "" + "" = "x" {"x"} + {} + {} = {"x"} </span>
<table border="1" cellpadding="3" summary="composition examples showing string names and composite names">
</table>
<h1> <span>多线程访问</span> </h1>
<span><tt>CompositeName</tt>实例与并发多线程访问不同步。</span>
<span>尝试访问和修改<tt>CompositeName的</tt>多个线程应锁定该对象。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.3
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../serialized-form.html#javax.naming.CompositeName">Serialized Form</a>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== 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/CompositeName.html#CompositeName--">CompositeName</a></span>()</code>
<div class="block">
构造一个新的空复合名称。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#CompositeName-java.util.Enumeration-">CompositeName</a></span>(<a href="../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a>&lt;<a href="../../java/lang/String.html" title="class in java.lang">String</a>&gt; comps)</code>
<div class="block">
使用“comps”指定的组件构造新的组合名称实例。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code> </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#CompositeName-java.lang.String-">CompositeName</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> n)</code>
<div class="block">
通过使用复合名称语法从左到右斜杠分隔解析字符串n来构造新的复合名称实例。
</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><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#add-int-java.lang.String-">add</a></span>(int posn, <a href="../../java/lang/String.html" title="class in java.lang">String</a> comp)</code>
<div class="block">
在此复合名称中的指定位置添加单个组件。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#add-java.lang.String-">add</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> comp)</code>
<div class="block">
将单个组件添加到此组合名称的末尾。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#addAll-int-javax.naming.Name-">addAll</a></span>(int posn, <a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> n)</code>
<div class="block">
在组合名称中的指定位置添加复合名称的组件。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#addAll-javax.naming.Name-">addAll</a></span>(<a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> suffix)</code>
<div class="block">
将组合名称的组件按顺序添加到此组合名称的末尾。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<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/CompositeName.html#clone--">clone</a></span>()</code>
<div class="block">
生成此复合名称的副本。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#compareTo-java.lang.Object-">compareTo</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> obj)</code>
<div class="block">
将此CompositeName与指定的对象进行比较。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#endsWith-javax.naming.Name-">endsWith</a></span>(<a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> n)</code>
<div class="block">
确定复合名称是否是此复合名称的后缀。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#equals-java.lang.Object-">equals</a></span>(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> obj)</code>
<div class="block">
确定两个复合名称是否相等。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<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/CompositeName.html#get-int-">get</a></span>(int posn)</code>
<div class="block">
检索此复合名称的组件。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a>&lt;<a href="../../java/lang/String.html" title="class in java.lang">String</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#getAll--">getAll</a></span>()</code>
<div class="block">
检索此复合名称的组件作为字符串的枚举。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#getPrefix-int-">getPrefix</a></span>(int posn)</code>
<div class="block">
创建一个组合名称,其组件由此组合名称中组件的前缀组成。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#getSuffix-int-">getSuffix</a></span>(int posn)</code>
<div class="block">
创建一个组合名称,其组件由此组合名称中的组件的后缀组成。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#hashCode--">hashCode</a></span>()</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/CompositeName.html#isEmpty--">isEmpty</a></span>()</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/CompositeName.html#remove-int-">remove</a></span>(int posn)</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/CompositeName.html#size--">size</a></span>()</code>
<div class="block">
检索此组合名称中的组件数。
</div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/naming/CompositeName.html#startsWith-javax.naming.Name-">startsWith</a></span>(<a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> n)</code>
<div class="block">
确定复合名称是否是此复合名称的前缀。
</div> </td>
</tr>
<tr class="rowColor" id="i17">
<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/CompositeName.html#toString--">toString</a></span>()</code>
<div class="block">
生成此复合名称的字符串表示形式。
</div> </td>
</tr>
</tbody>
</table>
<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#finalize--">finalize</a>, <a href="../../java/lang/Object.html#getClass--">getClass</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#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> </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="CompositeName-java.util.Enumeration-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>CompositeName</h4> <pre>protected CompositeName(<a href="../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a>&lt;<a href="../../java/lang/String.html" title="class in java.lang">String</a>&gt; comps)</pre>
<div class="block">
<span>使用“comps”指定的组件构造新的组合名称实例。</span>
<span>当被覆盖的方法例如clonegetPrefixgetSuffix这个protected方法将被CompositeName的子类使用。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>comps</code> - 包含新组合名称的组件的非空枚举。</span>
<span>每个元素都是String类。</span>
<span>枚举将用于提取其元素。</span>
</dd>
</dl> </li>
</ul> <a name="CompositeName-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>CompositeName</h4> <pre>public CompositeName(<a href="../../java/lang/String.html" title="class in java.lang">String</a> n)
throws <a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></pre>
<div class="block">
<span>通过使用复合名称语法从左到右斜杠分隔解析字符串n来构造新的复合名称实例。</span>
<span>组合名称语法在类描述中有详细描述。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>n</code> - 要解析的非空字符串。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></code> - 如果n具有无效的复合名称语法。
</dd>
</dl> </li>
</ul> <a name="CompositeName--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>CompositeName</h4> <pre>public CompositeName()</pre>
<div class="block">
<span>构造一个新的空复合名称。</span>
<span>当调用<code>isEmpty()</code>这样的名称将返回true。</span>
</div> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="toString--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>toString</h4> <pre>public <a href="../../java/lang/String.html" title="class in java.lang">String</a> toString()</pre>
<div class="block">
<span>生成此复合名称的字符串表示形式。</span>
<span>字符串表示包括按顺序对复合名称的每个组件进行枚举,并用正斜杠字符分隔每个组件。</span>
<span>引用和转义字符在必要时根据类描述中描述的JNDI语法进行应用。</span>
<span>一个空的组件由一个空字符串表示。</span>
<span>这样生成的字符串表示可以传递给CompositeName构造函数以创建一个新的等效组合名称。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../java/lang/Object.html#toString--">toString</a></code>
<code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
此复合名称的非空字符串表示形式。
</dd>
</dl> </li>
</ul> <a name="equals-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>equals</h4> <pre>public boolean equals(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> obj)</pre>
<div class="block">
<span>确定两个复合名称是否相等。</span>
<span>如果obj为null或不是组合名称则返回false。</span>
<span>如果一个中的每个组件等于另一个中的相应组件,则两个组合名称相等。</span>
<span>这意味着两者都具有相同数量的组件并且每个组件的equals测试与其他名称中的相应组件返回true。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../java/lang/Object.html#equals-java.lang.Object-">equals</a></code>
<code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>obj</code> - 可能要比较的空对象。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果obj等于此复合名称则为true否则为false。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/naming/CompositeName.html#hashCode--"><code>hashCode()</code></a>
</dd>
</dl> </li>
</ul> <a name="hashCode--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>hashCode</h4> <pre>public int hashCode()</pre>
<div class="block">
<span>计算此复合名称的哈希码。</span>
<span>哈希码是此复合名称的各个组件的哈希码的总和。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../java/lang/Object.html#hashCode--">hashCode</a></code>在类别
<code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
表示此名称的哈希码的int。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../javax/naming/CompositeName.html#equals-java.lang.Object-"><code>equals(java.lang.Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="compareTo-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>compareTo</h4> <pre>public int compareTo(<a href="../../java/lang/Object.html" title="class in java.lang">Object</a> obj)</pre>
<div class="block">
<span>将此CompositeName与指定的对象进行比较。</span>
<span>返回一个负整数,零或正整数,因为该名称小于,等于或大于给定的对象。</span>
<p> <span>如果obj为null或CompositeName的实例则抛出ClassCastException。</span> </p>
<p> <span>对于两个复合名称相同这意味着equals</span> <span>如果两个复合名称相等则返回0。</span> </p>
<p> <span>复合名称的排序遵循字符串比较的字典规则,其扩展名适用于复合名称中的所有组件。</span> <span>效果就好像所有组件都按照指定的顺序排列,并且在两个阵容中应用了词典规则。</span> <span>如果此复合名称比词汇“词典”小,则返回一个负数。</span> <span>如果此复合名称比词典“词典”大,则返回正数。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../java/lang/Comparable.html#compareTo-T-">compareTo</a></code>在界面
<code><a href="../../java/lang/Comparable.html" title="interface in java.lang">Comparable</a>&lt;<a href="../../java/lang/Object.html" title="class in java.lang">Object</a>&gt;</code>
</dd>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#compareTo-java.lang.Object-">compareTo</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>obj</code> - 要比较的非空对象。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
负整数,零或正整数,因为该名称小于,等于或大于给定的对象。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/ClassCastException.html" title="class in java.lang">ClassCastException</a></code> - 如果obj不是CompositeName。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../java/lang/Comparable.html#compareTo-T-"><code>Comparable.compareTo(Object)</code></a>
</dd>
</dl> </li>
</ul> <a name="clone--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>clone</h4> <pre>public <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> clone()</pre>
<div class="block">
<span>生成此复合名称的副本。</span>
<span>对此组合名称的组件的更改不会影响新副本,反之亦然。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#clone--">clone</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../java/lang/Object.html#clone--">clone</a></code>在类别
<code><a href="../../java/lang/Object.html" title="class in java.lang">Object</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
此复合名称的非空拷贝。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../java/lang/Cloneable.html" title="java.lang中的接口"><code>Cloneable</code></a></span>
</dd>
</dl> </li>
</ul> <a name="size--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>size</h4> <pre>public int size()</pre>
<div class="block">
检索此组合名称中的组件数。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#size--">size</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该复合名称中的非负数组件。
</dd>
</dl> </li>
</ul> <a name="isEmpty--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isEmpty</h4> <pre>public boolean isEmpty()</pre>
<div class="block">
<span>确定此复合名称是否为空。</span>
<span>如果组合名称具有零组件,则为空。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#isEmpty--">isEmpty</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果此复合名称为空则为true否则为false。
</dd>
</dl> </li>
</ul> <a name="getAll--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAll</h4> <pre>public <a href="../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a>&lt;<a href="../../java/lang/String.html" title="class in java.lang">String</a>&gt; getAll()</pre>
<div class="block">
<span>检索此复合名称的组件作为字符串的枚举。</span>
<span>此枚举上的此组合名称的更新效果未定义。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#getAll--">getAll</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>此复合名称的组件的非空枚举。</span>
<span>枚举的每个元素都是String类。</span>
</dd>
</dl> </li>
</ul> <a name="get-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>get</h4> <pre>public <a href="../../java/lang/String.html" title="class in java.lang">String</a> get(int posn)</pre>
<div class="block">
检索此复合名称的组件。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#get-int-">get</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>posn</code> - 要检索的组件的基于0的索引。</span>
<span>必须在[0size范围内。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
索引posn处的非空组件。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</a></code> - 如果posn在指定范围之外。
</dd>
</dl> </li>
</ul> <a name="getPrefix-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPrefix</h4> <pre>public <a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> getPrefix(int posn)</pre>
<div class="block">
<span>创建一个组合名称,其组件由此组合名称中组件的前缀组成。</span>
<span>此复合名称的后续更改不会影响返回的名称。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#getPrefix-int-">getPrefix</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>posn</code> - 要停止的组件的基于0的索引。</span>
<span>必须在[0size]范围内。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
由[0posn]范围内的索引组成的组合名称。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</a></code> - 如果posn在指定范围之外。
</dd>
</dl> </li>
</ul> <a name="getSuffix-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSuffix</h4> <pre>public <a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> getSuffix(int posn)</pre>
<div class="block">
<span>创建一个组合名称,其组件由此组合名称中的组件的后缀组成。</span>
<span>此复合名称的后续更改不会影响返回的名称。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#getSuffix-int-">getSuffix</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>posn</code> - 要启动的组件的基于0的索引。</span>
<span>必须在[0size]范围内。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>由[posnsize范围内的索引组成的组合名称。</span>
<span>如果posn等于size则返回一个空的复合名称。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</a></code> - 如果posn在指定范围之外。
</dd>
</dl> </li>
</ul> <a name="startsWith-javax.naming.Name-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>startsWith</h4> <pre>public boolean startsWith(<a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> n)</pre>
<div class="block">
<span>确定复合名称是否是此复合名称的前缀。</span>
<span>复合名称“n”如果等于getPrefixn.size则为前缀 - 换句话说,此复合名称以'n'开头。</span>
<span>如果'n'为空或不是复合名称则返回false。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#startsWith-javax.naming.Name-">startsWith</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>n</code> - 可能要查询的null名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果n是CompositeName并且是此复合名称的前缀则为true否则为false。
</dd>
</dl> </li>
</ul> <a name="endsWith-javax.naming.Name-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>endsWith</h4> <pre>public boolean endsWith(<a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> n)</pre>
<div class="block">
<span>确定复合名称是否是此复合名称的后缀。</span>
<span>如果复合名称等于getSuffixsize - n.size则复合名称“n”是后缀 - 换句话说此复合名称以“n”结尾。</span>
<span>如果n不为复合名则返回false。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#endsWith-javax.naming.Name-">endsWith</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>n</code> - 可能要查询的null名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果n是CompositeName并且是此复合名称的后缀则为true否则为false。
</dd>
</dl> </li>
</ul> <a name="addAll-javax.naming.Name-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addAll</h4> <pre>public <a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> addAll(<a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> suffix)
throws <a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></pre>
<div class="block">
将组合名称的组件按顺序添加到此组合名称的末尾。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#addAll-javax.naming.Name-">addAll</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>suffix</code> - 要添加的非零组件。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>更新的CompositeName而不是一个新的。</span>
<span>不能为空。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></code> - 如果后缀不是复合名称。
</dd>
</dl> </li>
</ul> <a name="addAll-int-javax.naming.Name-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addAll</h4> <pre>public <a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> addAll(int posn,
<a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> n)
throws <a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></pre>
<div class="block">
<span>在组合名称中的指定位置添加复合名称的组件。</span>
<span>在第一个新组件的索引之前或之后此组合名称的组件向上移动远离索引0以适应新的组件。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#addAll-int-javax.naming.Name-">addAll</a></code>在接口
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>n</code> - 要添加的非零组件。
</dd>
<dd>
<span><code>posn</code> - 添加新组件的此名称中的索引。</span>
<span>必须在[0size]范围内。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>更新的CompositeName而不是一个新的。</span>
<span>不能为空。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></code> - 如果n不是组合名称。
</dd>
<dd>
<code><a href="../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</a></code> - 如果posn在指定范围之外。
</dd>
</dl> </li>
</ul> <a name="add-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>add</h4> <pre>public <a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> add(<a href="../../java/lang/String.html" title="class in java.lang">String</a> comp)
throws <a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></pre>
<div class="block">
将单个组件添加到此组合名称的末尾。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#add-java.lang.String-">add</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>comp</code> - 要添加的非空组件。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>更新的CompositeName而不是一个新的。</span>
<span>不能为空。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></code> - 如果在名称末尾添加comp将违反名称的语法。
</dd>
</dl> </li>
</ul> <a name="add-int-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>add</h4> <pre>public <a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a> add(int posn,
<a href="../../java/lang/String.html" title="class in java.lang">String</a> comp)
throws <a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></pre>
<div class="block">
<span>在此复合名称中的指定位置添加单个组件。</span>
<span>在新组件的索引之前或之后此组合名称的组件向上移动一远离索引0以适应新组件。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#add-int-java.lang.String-">add</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>comp</code> - 要添加的非零组件。
</dd>
<dd>
<span><code>posn</code> - 添加新组件的索引。</span>
<span>必须在[0size]范围内。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>更新的CompositeName而不是一个新的。</span>
<span>不能为空。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</a></code> - 如果posn在指定范围之外。
</dd>
<dd>
<code><a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></code> - 如果在指定位置添加comp将违反名称的语法。
</dd>
</dl> </li>
</ul> <a name="remove-int-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>remove</h4> <pre>public <a href="../../java/lang/Object.html" title="class in java.lang">Object</a> remove(int posn)
throws <a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></pre>
<div class="block">
<span>从此复合名称中删除组件。</span>
<span>该复合名称在“posn”位置的组件被删除而大于“posn”的索引的组件向下移动朝向索引01。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/naming/Name.html#remove-int-">remove</a></code>在界面
<code><a href="../../javax/naming/Name.html" title="interface in javax.naming">Name</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>posn</code> - 要删除的组件的索引。</span>
<span>必须在[0size范围内。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
删除组件一个String
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/ArrayIndexOutOfBoundsException.html" title="class in java.lang">ArrayIndexOutOfBoundsException</a></code> - 如果posn在指定范围之外包括组合名称为空的情况
</dd>
<dd>
<code><a href="../../javax/naming/InvalidNameException.html" title="class in javax.naming">InvalidNameException</a></code> - 如果删除组件将违反名称的语法。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>