java.lang.Object
- javax.naming.CompositeName

All Implemented Interfaces:: Serializable， Cloneable， Comparable < Object >， Name

public class CompositeName
extends Object
implements Name

这类代表一个复合的名字--一个组件名称生成多个命名空间序列。每个组件都是一个命名系统的命名空间的字符串名称。如果组件来自分层命名空间，该组件可以进一步分解成原子部分采用compoundname类。

复合名称的组件被编号。n个组件的复合名称的索引范围从0到，但不包括，这个范围可以写为[ 0，n）。最重要的组成部分是指数0。一个空的复合名称没有组件。

JNDI复合名称的语法

JNDI定义复合名称标准字符串表示形式。这表示是从左到右用分隔符的复合名称组件连接（一个正斜杠字符（/））分隔每个组件。JNDI的语法定义如下：

逃生（后退），
报价字符（单（'）和双引号（“）），和
组件分隔符（前向字符（/））。

元字符出现的任何一个领导报价，逃跑前任何元字符，在一个构件端部的逃避，或在非上市组件分隔符必须使用转义字符时，组件被组合成一个复合名称的字符串。另外，为了避免添加逃脱的字符描述，整个组件可以被引用，使用匹配的单引号或匹配的双引号。在双引号的组件内发生的一个引用不被认为是元字符（不需要被逃脱），反之亦然。

当两个组合的名称进行比较时，字符的情况下是显着的。

一个领先的组件分隔符（复合名称字符串开头有一个分隔符）表示一个主要的空组件（一个空字符串组成的组件）。一个尾随组件分隔符（复合名称字符串以分隔符结尾）表示一个尾随的空组件。相邻的组件分隔符表示一个空组件。

复合名称的例子

表显示了一些复合名称的例子。每行显示一个复合名称和相应的结构形式的字符串形式（ CompositeName）。这里有一些例子

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"}

构图实例

组成。在右列中显示的字符串名称而组成复合左栏显示相应的 CompositeNames组成。注意，组成两复合名称的字符串形式仅仅涉及到连接字符串形式。

String Names	CompositeNames
"x/y" + "/" = x/y/	{"x", "y"} + {""} = {"x", "y", ""}
"" + "x" = "x"	{} + {"x"} = {"x"}
"/" + "x" = "/x"	{""} + {"x"} = {"", "x"}
"x" + "" + "" = "x"	{"x"} + {} + {} = {"x"}

多线程访问

一 CompositeName实例不同步的并发多线程访问。多个线程试图访问和修改 CompositeName应该锁定对象。

从以下版本开始：: 一点三
另请参见：: Serialized Form

构造方法摘要

构造方法
Modifier	Constructor and Description
	`CompositeName()` 构造一个新的空复合名称。
`protected`	`CompositeName(Enumeration<String> comps)` 利用“谱曲”指定的组件构建了一种新的复合名称的实例。
	`CompositeName(String n)` 通过使用复合名称语法（左到右）解析字符串，构造一个新的复合名称实例（左到右）。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Name`	`add(int posn, String comp)` 在该复合名称中在指定位置添加一个单一组件。
`Name`	`add(String comp)` 添加一个单一组件到这个复合名称的结尾。
`Name`	`addAll(int posn, Name n)` 在复合名称中添加一个复合名称的组件-在一个指定的位置。
`Name`	`addAll(Name suffix)` 添加一个复合名称的组件-以-到这个复合名称的结尾。
`Object`	`clone()` 生成此复合名称的副本。
`int`	`compareTo(Object obj)` 这compositename与指定对象按顺序比较。
`boolean`	`endsWith(Name n)` 确定复合名称是否为该复合名称的后缀。
`boolean`	`equals(Object obj)` 确定两个复合名称是否相等。
`String`	`get(int posn)` 检索此复合名称的一个组件。
`Enumeration<String>`	`getAll()` 检索此复合名称的组件作为字符串的枚举。
`Name`	`getPrefix(int posn)` 创建一个复合名，其组件由该复合名称中的组件的前缀组成。
`Name`	`getSuffix(int posn)` 创建一个复合名，其组件由该复合名称中的组件的后缀组成。
`int`	`hashCode()` 计算该复合名的哈希代码。
`boolean`	`isEmpty()` 确定该复合名称是否为空。
`Object`	`remove(int posn)` 从这个复合名称中删除一个组件。
`int`	`size()` 检索此复合名称中的组件的数量。
`boolean`	`startsWith(Name n)` 确定复合名称是否为该复合名称的前缀。
`String`	`toString()` 生成此复合名称的字符串表示形式。

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - CompositeName
```
protected CompositeName(Enumeration<String> comps)
```
    利用“谱曲”指定的组件构建了一种新的复合名称的实例。这种保护方法的目的是要使用的子compositename当他们覆盖方法，如（），getprefix()，getsuffix()。
    
    参数
    
    comps -含新型复合名称的组件的非零计数。每个元素都是类字符串的。枚举将被消耗以提取其元素。
  - CompositeName
```
public CompositeName(String n)
              throws InvalidNameException
```
    通过使用复合名称语法（左到右）解析字符串，构造一个新的复合名称实例（左到右）。在类描述中详细描述了复合名称语法。
    
    参数
    
    n -非空字符串解析。
    
    异常
    
    InvalidNameException如果N复合名称语法无效。
  - CompositeName
```
public CompositeName()
```
    构造一个新的空复合名称。这样一个名字时返回真 isEmpty()调用它。
- 方法详细信息
  - toString
```
public String toString()
```
    生成此复合名称的字符串表示形式。的字符串表示形式由枚举为每个组件的复合名字和分离各组件由一个正斜杠字符。引用和转义字符的应用，根据JNDI的语法是必要的，这是在类描述。一个空的组件由一个空字符串表示。由此产生的字符串表示形式可以传递给compositename构造函数来创建一个新的等效复合名称。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    此复合名称的非空字符串表示。
  - equals
```
public boolean equals(Object obj)
```
    确定两个复合名称是否相等。如果obj为空或不是一个复合的名字，返回false。如果一个组件中的每个组件都等于另一个的相应组件，两个组合的名称是相等的。这意味着既有相同数量的组件，每个组件的equals()测试对其他名称相应的组件返回true。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj -比较可能的空对象。
    
    结果
    
    如果obj等于该复合名字真，否则为假。
    
    另请参见：
    
    hashCode()
  - hashCode
```
public int hashCode()
```
    计算该复合名的哈希代码。哈希代码是这个复合名的单个组件的哈希代码的总和。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    表示此名称的哈希代码int。
    
    另请参见：
    
    equals(java.lang.Object)
  - compareTo
```
public int compareTo(Object obj)
```
    这compositename与指定对象按顺序比较。返回一个负整数、零或一个正整数，因为这个名称小于、等于或大于给定的对象。
    如果对象是无效的或不compositename实例，抛出ClassCastException。
    
    看到等于两组合的名字意味着什么equals()。如果两个复合名是相等的，则返回0。
    
    复合名称排序如下字符串比较的编纂规则，这种适用于复合名称的所有组件的扩展。效果就好像所有的成分都排在其指定的命令在两线UPS应用词典学的规则。如果这个组合的名字是“字典”小于obj，返回一个负数。如果这个组合的名字是“字典”大于obj，正数返回。
    
    Specified by:
    
    compareTo 接口 Comparable<Object>
    
    Specified by:
    
    compareTo 接口 Name
    
    参数
    
    obj -非null对象比较。
    
    结果
    
    一个负整数，零，或一个正整数，因为这个名称小于，等于或大于给定的对象。
    
    异常
    
    ClassCastException如果obj是不compositename。
    
    另请参见：
    
    Comparable.compareTo(Object)
  - clone
```
public Object clone()
```
    生成此复合名称的副本。更改此复合名称的组件不会影响新副本，反之亦然。
    
    Specified by:
    
    clone 接口 Name
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    此复合名称的非空副本。
    
    另请参见：
    
    Cloneable
  - size
```
public int size()
```
    检索此复合名称中的组件的数量。
    
    Specified by:
    
    size 接口 Name
    
    结果
    
    此复合名称中的组件的非负数。
  - isEmpty
```
public boolean isEmpty()
```
    确定该复合名称是否为空。复合名称是空的，如果它有零组件。
    
    Specified by:
    
    isEmpty 接口 Name
    
    结果
    
    如果此复合名称为空，则为假。
  - getAll
```
public Enumeration<String> getAll()
```
    检索此复合名称的组件作为字符串的枚举。在这个枚举上的更新对这个复合名称的影响是不确定的。
    
    Specified by:
    
    getAll 接口 Name
    
    结果
    
    此复合名称的组件的非空枚举。枚举的每个元素都是类字符串的。
  - get
```
public String get(int posn)
```
    检索此复合名称的一个组件。
    
    Specified by:
    
    get 接口 Name
    
    参数
    
    posn - 0的构件检索索引。必须在范围[ 0，size()）。
    
    结果
    
    在索引位置非零组件。
    
    异常
    
    ArrayIndexOutOfBoundsException如果位置是在指定范围内。
  - getPrefix
```
public Name getPrefix(int posn)
```
    创建一个复合名，其组件由该复合名称中的组件的前缀组成。随后对该复合名称的更改不影响返回的名称。
    
    Specified by:
    
    getPrefix 接口 Name
    
    参数
    
    posn - 0指数的成分停止。必须在范围[ 0 ]，size()。
    
    结果
    
    一个复合的名字组成的成分范围内的[ 0个指标，普森）。
    
    异常
    
    ArrayIndexOutOfBoundsException如果位置是在指定范围内。
  - getSuffix
```
public Name getSuffix(int posn)
```
    创建一个复合名，其组件由该复合名称中的组件的后缀组成。随后对该复合名称的更改不影响返回的名称。
    
    Specified by:
    
    getSuffix 接口 Name
    
    参数
    
    posn - 0开始索引处的组件开始。必须在范围[ 0 ]，size()。
    
    结果
    
    一个复合的名字组成的成分范围内的[输入指标，size()）。如果输入等于size()、空复合叫回来。
    
    异常
    
    ArrayIndexOutOfBoundsException如果位置是在指定范围内。
  - startsWith
```
public boolean startsWith(Name n)
```
    确定复合名称是否为该复合名称的前缀。组合名称“N”是一个前缀，如果它等于getprefix（N. size()）——换句话说，这种复合的名字开始“N”。如果“n”是无效的，则返回一个复合名。
    
    Specified by:
    
    startsWith 接口 Name
    
    参数
    
    n -可能的空名检查。
    
    结果
    
    如果一个compositename N是一个前缀这种复合名字真，否则为假。
  - endsWith
```
public boolean endsWith(Name n)
```
    确定复合名称是否为该复合名称的后缀。一个复合的名字“N”是一个后缀，如果它等于getsuffix（size()，size()）--换句话说，这个组合名称结尾“N”。如果n为空或没有一个复合名称，则返回假。
    
    Specified by:
    
    endsWith 接口 Name
    
    参数
    
    n -可能的空名检查。
    
    结果
    
    如果一个compositename N是一个后缀这种复合名字真，否则为假。
  - addAll
```
public Name addAll(Name suffix)
            throws InvalidNameException
```
    添加一个复合名称的组件-以-到这个复合名称的结尾。
    
    Specified by:
    
    addAll 接口 Name
    
    参数
    
    suffix -非零组件添加。
    
    结果
    
    更新compositename，不是一个新的。不能为空。
    
    异常
    
    InvalidNameException -如果不是复合名称后缀。
  - addAll
```
public Name addAll(int posn,
                   Name n)
            throws InvalidNameException
```
    在复合名称中添加一个复合名称的组件-在一个指定的位置。此复合名称的组件在第一个新组件的索引或之后被上移（远离索引0）以适应新的组件。
    
    Specified by:
    
    addAll 接口 Name
    
    参数
    
    n -非零组件添加。
    
    posn -这个名字的索引添加新组件。必须在范围[ 0 ]，size()。
    
    结果
    
    更新compositename，不是一个新的。不能为空。
    
    异常
    
    InvalidNameException如果n不是一个复合的名字。
    
    ArrayIndexOutOfBoundsException如果位置是在指定范围内。
  - add
```
public Name add(String comp)
         throws InvalidNameException
```
    添加一个单一组件到这个复合名称的结尾。
    
    Specified by:
    
    add 接口 Name
    
    参数
    
    comp -非零组件添加。
    
    结果
    
    更新compositename，不是一个新的。不能为空。
    
    异常
    
    InvalidNameException如果加入公司最后的名字会违反名称的语法。
  - add
```
public Name add(int posn,
                String comp)
         throws InvalidNameException
```
    在该复合名称中在指定位置添加一个单一组件。此复合名称的组件在新组件的索引或之后被一个（远离索引0）上移以适应新的组件。
    
    Specified by:
    
    add 接口 Name
    
    参数
    
    comp -非零组件添加。
    
    posn -的索引添加新组件。必须在范围[ 0 ]，size()。
    
    结果
    
    更新compositename，不是一个新的。不能为空。
    
    异常
    
    ArrayIndexOutOfBoundsException如果位置是在指定范围内。
    
    InvalidNameException如果加入公司的指定位置处将违反名称的语法。
  - remove
```
public Object remove(int posn)
              throws InvalidNameException
```
    从这个复合名称中删除一个组件。在位置的位置的这种复合名称的部分被删除，并在指数大于“输入”组件向下移动（向指数0）一。
    
    Specified by:
    
    remove 接口 Name
    
    参数
    
    posn -组件删除索引。必须在范围[ 0，size()）。
    
    结果
    
    组件删除（字符串）。
    
    异常
    
    ArrayIndexOutOfBoundsException如果位置是在指定范围内（包括在复合名称是空的）。
    
    InvalidNameException如果删除组件会违反名称的语法。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class CompositeName

JNDI复合名称的语法

复合名称的例子

构图实例

多线程访问

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

CompositeName

CompositeName

CompositeName

方法详细信息

toString

equals

hashCode

compareTo

clone

size

isEmpty

getAll

get

getPrefix

getSuffix

startsWith

endsWith

addAll

addAll

add

add

remove