CompoundName (Java Platform SE 8 )

java.lang.Object
- javax.naming.CompoundName

All Implemented Interfaces:

Serializable， Cloneable， Comparable < Object >， Name
```
public class CompoundName
extends Object
implements Name
```
这个类代表一个复合名-一个层次名称空间的名称。复合名称中的每个组件都是一个原子名称。
复合名称的组件被编号。与N个组件的复合名称的索引范围从0到，但不包括，这个范围可以写为[ 0，n）。最重要的组成部分是指数0。一个空的复合名没有组件。

化合物名称语法
复合名称的语法是使用一组属性指定：

jndi.syntax.direction

方向解析（“right_to_left”、“left_to_right”、“平”）。如果未指定，默认为“平”，这意味着命名空间是平坦的，没有层次结构。

jndi.syntax.separator

原子名称组件之间的分隔符。除非方向是“平坦”。

jndi.syntax.ignorecase

如果存在，“真”意味着在比较名称组件时忽略这种情况。如果它的值不是“真”，或如果属性不存在，则在比较名称组件时被考虑。

jndi.syntax.escape

如果存在，指定重写分隔符的逃生字符串、逸出和引号。

jndi.syntax.beginquote

如果存在，指定字符串分隔开始引用串。

jndi.syntax.endquote

字符串分隔字符串结束。如果存在，指定字符串，划定的引用字符串的末尾。如果不存在，使用syntax.beginquote最终报价。

jndi.syntax.beginquote2

开始/结束引用的另一组。

jndi.syntax.endquote2

开始/结束引用的另一组。

jndi.syntax.trimblanks

如果存在，“真”是指修剪任何领导和在一个比较目的名称部分尾部空格。如果它的值不是“真”，或如果属性不存在，空格是显着的。

jndi.syntax.separator.ava

如果存在，指定在指定多个属性/值对时分隔属性值断言的字符串。（例如：“在65岁时，性别=男）。

jndi.syntax.separator.typeval

如果存在，指定分隔符属性的字符串（例如“年龄= 65”）中的属性值（例如：“=”）

这些属性是按照以下规则：
1. 在一个没有引号或转义字符串，任何实例分离划两原子的名字。每个原子名称都被称为一个组件。
2. 一个分隔符，引用或逃脱，如果前面有立即（左侧）的逃生。
3. 如果有两套报价，一个特定的开始报价必须与相应的结束报价相匹配。
4. 一个非逃脱的开始报价之前的一个组成部分必须匹配一个非逃脱结束引用的组件结束时。因此引用的一个组件被称为引用的组件。它是通过删除被解析和结束引号，并通过处理作为普通字符的中间字符，除非涉及下列规则的规则之一，下面列出的应用。
5. 嵌入在非引用的组件中的引用被视为普通的字符串，不需要匹配。
6. 在非逃脱引号之间的分隔符被处理为一个普通的字符串，而不是分隔符。
7. 引用的组件中的一个字符串作为一个逃避，只有当相应的结束引用字符串。这可以用于在引用的组件中嵌入一个逃脱的引用。
8. 未处理的未处理的未处理的字符串作为一个字符串。
9. 一个不在元字符串（引号或分隔符）之前的字符串，而不是在一个组件的结尾处被视为一个普通的字符串。
10. 一个领先的分隔符（复合名称字符串开头有一个分隔符）表示一个主要的空原子组件（由一个空字符串）。一个尾随分隔符（复合名称字符串以分隔符结尾）表示一个尾随的空原子组件。相邻的分隔符表示一个空的原子组件。
复合名称的字符串形式如下所述的语法。当复合名称的组件被变成他们的字符串表示时，上面描述的保留的语法规则被应用（例如：嵌入的分隔符被逃脱或引用），当相同的字符串被解析时，它将产生原始的复合名的相同的组件。

多线程访问
一 CompoundName实例不同步的并发多线程访问。多个线程试图访问和修改 CompoundName应该锁定对象。
从以下版本开始：

一点三

另请参见：

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected javax.naming.NameImpl`	`impl` 此复合名称的实现。
`protected Properties`	`mySyntax` 此复合名称的语法属性。

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`CompoundName(Enumeration<String> comps, Properties syntax)` 采用比较和语法指定组件构建了一种新的化合物名称实例。
	`CompoundName(String n, Properties syntax)` 通过使用提供的语法属性指定的语法解析解析字符串，构造一个新的复合名称实例。

方法摘要

所有方法接口方法具体的方法
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)` 这compoundname与指定对象按顺序比较。
`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

- Field Detail
  - impl
```
protected transient javax.naming.NameImpl impl
```
    此复合名称的实现。此字段由构造函数初始化，不能为空。它应该被视为一个只读变量的子类。
  - mySyntax
```
protected transient Properties mySyntax
```
    此复合名称的语法属性。此字段由构造函数初始化，不能为空。它应该被视为一个只读变量的子类。对mysyntax任何必要的变更应在施工后不复的名字已经被实例化了。
- Constructor Detail
  - CompoundName
```
protected CompoundName(Enumeration<String> comps,
                       Properties syntax)
```
    采用比较和语法指定组件构建了一种新的化合物名称实例。这种保护方法的目的是要使用的子compoundname当他们覆盖方法，如（），getprefix()，getsuffix()。
    
    参数
    
    comps -一个非空的枚举组件的添加。枚举的每个元素都是类字符串的。枚举将被消耗以提取其元素。
    
    syntax -一个非空的属性指定此化合物名称的语法。查看属性内容的类描述。
  - CompoundName
```
public CompoundName(String n,
                    Properties syntax)
             throws InvalidNameException
```
    通过使用提供的语法属性指定的语法解析解析字符串，构造一个新的复合名称实例。
    
    参数
    
    n -非空字符串解析。
    
    syntax -一个非空的属性的列表，指定此化合物名称的语法。查看属性内容的类描述。
    
    异常
    
    InvalidNameException如果“N”违反规定的 syntax语法。
- 方法详细信息
  - toString
```
public String toString()
```
    生成此复合名的字符串表示形式，使用复合名的语法规则。类描述中描述的语法规则。一个空的组件由一个空字符串表示。由此产生的字符串表示形式可以通过使用相同的语法性质的compoundname构造函数来创建一个新的等效复合名称。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    这个复合名的非空字符串表示。
  - equals
```
public boolean equals(Object obj)
```
    确定目标语法等于该化合物名称。如果obj是无效的或不compoundname，返回false。两个化合物的名称是相等的，如果每个组件中的一个是“相等”的相应的组件在另一个。
    平等也被定义在这个复合名称的语法方面。对compoundname默认的实现使用的语法性质jndi.syntax.ignorecase和jndi.syntax.trimblanks比较两成分平等。如果忽略了情况，则两个具有相同字符序列的字符串，但不同的情况下被认为是相等的。如果空白被修剪，导致和尾随空白被忽略的目的的比较。
    
    两个复合名称必须有相同数量的组件。
    
    实现注释：目前两个复合名称的语法属性不是比较的。他们可能在未来。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj -比较可能的空对象。
    
    结果
    
    如果obj等于该化合物的名字真，否则为假。
    
    另请参见：
    
    compareTo(java.lang.Object obj)
  - hashCode
```
public int hashCode()
```
    计算该复合名的哈希代码。散列码是笔的散列码的“规范化”这一化合物名称的单个组件形式。每个组件是“规范化”根据化合物名称的语法在哈希码的计算。一个不区分大小写的名称，例如，一个名字的大写字母形式具有相同的哈希码为小写等效。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    表示此名称的哈希代码int。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - clone
```
public Object clone()
```
    创建此复合名的副本。这个复合名称的组件的更改不会影响新的副本，反之亦然。克隆和这个复合名共享相同的语法。
    
    Specified by:
    
    clone 接口 Name
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    此复合名的非空副本。
    
    另请参见：
    
    Cloneable
  - compareTo
```
public int compareTo(Object obj)
```
    这compoundname与指定对象按顺序比较。返回一个负整数、零或一个正整数，因为这个名称小于、等于或大于给定的对象。
    如果对象是无效的或不compoundname实例，抛出ClassCastException。
    
    看到两化合物名称相等意味着什么equals()。如果两个复合名相等，则返回0。
    
    复合名的排序依赖于复合名称的语法。默认情况下，他们跟辞书规则字符串比较的扩展，这适用于复合名称的所有成分，个人成分比较受jndi.syntax.ignorecase和jndi.syntax.trimblanks性质相同，它们是如何影响equals()。如果该化合物的名称是“字典”小于obj，返回一个负数。如果该化合物的名称是“字典”大于obj，正数返回。
    
    实现注释：目前两个复合名的语法属性在检查顺序时没有比较。他们可能在未来。
    
    Specified by:
    
    compareTo 接口 Comparable<Object>
    
    Specified by:
    
    compareTo 接口 Name
    
    参数
    
    obj -非null对象比较。
    
    结果
    
    一个负整数，零，或一个正整数，因为这个名称小于，等于或大于给定的对象。
    
    异常
    
    ClassCastException如果obj是不compoundname。
    
    另请参见：
    
    equals(java.lang.Object)
  - 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为空或没有一个复合名，则返回假。
    实现注释：目前在做比较时不使用n的语法属性。他们可能在未来。
    
    Specified by:
    
    startsWith 接口 Name
    
    参数
    
    n -可能的空化合物名称检查。
    
    结果
    
    如果一个compoundname N是该化合物的名称前缀真，否则为假。
  - endsWith
```
public boolean endsWith(Name n)
```
    确定复合名是否是该复合名的后缀。一个复合的名字“N”是一个后缀，如果它等于getsuffix（size()，size()）——换句话说，这种化合物名称以“N”。如果n为空或没有一个复合名，则返回假。
    实现注释：目前在做比较时不使用n的语法属性。他们可能在未来。
    
    Specified by:
    
    endsWith 接口 Name
    
    参数
    
    n -可能的空化合物名称检查。
    
    结果
    
    如果一个compoundname N是该化合物的名称后缀真，否则为假。
  - addAll
```
public Name addAll(Name suffix)
            throws InvalidNameException
```
    添加一个复合名称的组件-以-到这个复合名称的结尾。
    实现说明：目前后缀的语法属性没有使用或检查。他们可能在未来。
    
    Specified by:
    
    addAll 接口 Name
    
    参数
    
    suffix -非零组件添加。
    
    结果
    
    更新compoundname，不是一个新的。不能为空。
    
    异常
    
    InvalidNameException如果后缀不是化合物名称，或者如果组件添加违反本化合物名称的语法（例如超过元件数）。
  - addAll
```
public Name addAll(int posn,
                   Name n)
            throws InvalidNameException
```
    在这个复合名称中添加一个复合名称的组件-在一个指定的位置。在第一个新组件的索引或之后的这个复合名称的组件被上移（远离索引0）以适应新的组件。
    实现说明：目前后缀的语法属性没有使用或检查。他们可能在未来。
    
    Specified by:
    
    addAll 接口 Name
    
    参数
    
    n -非零组件添加。
    
    posn -这个名字的索引添加新组件。必须在范围[ 0 ]，size()。
    
    结果
    
    更新compoundname，不是一个新的。不能为空。
    
    异常
    
    ArrayIndexOutOfBoundsException如果位置是在指定范围内。
    
    InvalidNameException如果n不是化合物名称，或者如果组件添加违反本化合物名称的语法（例如超过元件数）。
  - add
```
public Name add(String comp)
         throws InvalidNameException
```
    添加一个单一组件到这个复合名称的结尾。
    
    Specified by:
    
    add 接口 Name
    
    参数
    
    comp -非零组件添加。
    
    结果
    
    更新compoundname，不是一个新的。不能为空。
    
    异常
    
    InvalidNameException如果加入公司最后的名字会违反化合物名称的语法。
  - add
```
public Name add(int posn,
                String comp)
         throws InvalidNameException
```
    在该复合名称中在指定位置添加一个单一组件。在新组件的索引或之后这个复合名称的组件由一个（远离索引0）转移以适应新的组件。
    
    Specified by:
    
    add 接口 Name
    
    参数
    
    comp -非零组件添加。
    
    posn -的索引添加新组件。必须在范围[ 0 ]，size()。
    
    结果
    
    更新compoundname，不是一个新的。不能为空。
    
    异常
    
    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 CompoundName

化合物名称语法

多线程访问

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

impl

mySyntax

Constructor Detail

CompoundName

CompoundName

方法详细信息

toString

equals

hashCode

clone

compareTo

size

isEmpty

getAll

get

getPrefix

getSuffix

startsWith

endsWith

addAll

addAll

add

add

remove