compact3

javax.naming

Interface Name

All Superinterfaces:

Cloneable， Comparable < Object >， Serializable

所有已知实现类：

CompositeName， CompoundName， LdapName

public interface Name
extends Cloneable, Serializable, Comparable<Object>

的 Name接口代表一个通用的名字--一个有序序列元件。它可以是一个复合的名字（名字跨越多个命名空间），或一个复合的名字（名字是个人层次命名系统内使用）。

可以有不同的实现Name；例如，复合材料的名称，网址，或指定命名空间的复合名字。

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

此接口中的方法没有接受为参数的有效值，该参数是一个名称或一个名称组件。同样，返回一个名称或名称组件的方法永远不会返回空。

一个Name实例可能不同步的并发多线程访问，访问如果不是只读的。

从以下版本开始：

一点三

Field Summary

Fields

Modifier and Type	Field and Description
static long	serialVersionUID 设置为表示与类的前一个版本的序列化兼容性的类的指纹。

方法摘要

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) 将此名称与另一个名称进行比较。
boolean	endsWith(Name n) 确定这个名称是否以指定的后缀结束。
String	get(int posn) 检索此名称的一个组件。
Enumeration<String>	getAll() 检索此名称的组件作为字符串的枚举。
Name	getPrefix(int posn) 创建一个由该名称的组件的前缀组成的名称。
Name	getSuffix(int posn) 创建一个由该名称中的组件的后缀组成的名称。
boolean	isEmpty() 确定此名称是否为空。
Object	remove(int posn) 从这个名称中删除一个组件。
int	size() 返回这个名称中的组件的数量。
boolean	startsWith(Name n) 确定此名称是否以指定的前缀开始。

Field Detail

serialVersionUID

static final long serialVersionUID

设置为表示与类的前一个版本的序列化兼容性的类的指纹。

另请参见：

Constant Field Values

方法详细信息

clone

Object clone()

生成此名称的新副本。此名称的组件的后续更改不会影响新的副本，反之亦然。

结果

此名称的副本

另请参见：

Object.clone()

compareTo

int compareTo(Object obj)

将此名称与另一个名称进行比较。返回一个负整数、零或一个正整数，因为这个名称小于、等于或大于给定的名称。

与Object.equals()，命令名称的概念取决于实现该接口的类。例如，排序可以根据名称组成的字典序。具体属性的名称，如它如何对待的情况下，可能会影响排序。在一般情况下，两个不同类别的名称可能无法进行比较。

Specified by:

compareTo 接口 Comparable<Object>

参数

obj -非null对象比较。

结果

一个负整数，零，或一个正整数，因为这个名称是小于，等于或大于给定的名称

异常

ClassCastException如果obj是不 Name一型可能与这个名字比较

另请参见：

Comparable.compareTo(Object)

size

int size()

返回这个名称中的组件的数量。

结果

这个名称中的组件的数量

isEmpty

boolean isEmpty()

确定此名称是否为空。一个空名称是一个零组件。

结果

如果这个名称为空，则为假

getAll

Enumeration<String> getAll()

检索此名称的组件作为字符串的枚举。对这个名称的更新的枚举的影响是不确定的。如果名称具有零组件，则返回一个空（非空）枚举。

结果

枚举这个名称的组件，每一个字符串

get

String get(int posn)

检索此名称的一个组件。

参数

posn - 0的构件检索索引。必须在范围[ 0，size()）。

结果

在索引位置的组件

异常

ArrayIndexOutOfBoundsException如果位置是在指定范围内

getPrefix

Name getPrefix(int posn)

创建一个由该名称的组件的前缀组成的名称。此名称的后续更改不会影响返回的名称，反之亦然。

参数

posn - 0指数的成分停止。必须在范围[ 0 ]，size()。

结果

一个名字组成的成分范围内的[ 0个指标，普森）。

异常

ArrayIndexOutOfBoundsException如果位置是在指定范围内

getSuffix

Name getSuffix(int posn)

创建一个由该名称中的组件的后缀组成的名称。此名称的后续更改不影响返回的名称，反之亦然。

参数

posn - 0开始索引处的组件开始。必须在范围[ 0 ]，size()。

结果

一个名字组成的成分范围内的[输入指标，size()）。如果输入等于size()，空叫回来。

异常

ArrayIndexOutOfBoundsException如果位置是在指定范围内

startsWith

boolean startsWith(Name n)

确定此名称是否以指定的前缀开始。一名 n是前缀如果它等于 getPrefix(n.size())。

参数

n -名称检查

结果

如果 n是前缀这个名字真，否则为假

endsWith

boolean endsWith(Name n)

确定这个名称是否以指定的后缀结束。一名 n是后缀，如果它等于 getSuffix(size()-n.size())。

参数

n -名称检查

结果

如果 n是后缀这个名字真，否则为假

addAll

Name addAll(Name suffix)
     throws InvalidNameException

添加一个名称的组件-以-到这个名称的结尾。

参数

suffix -添加组件

结果

更新的名称（不是一个新的）

异常

InvalidNameException -如果 suffix不是有效名称，或者如果组件的添加会违反这个名字的语法规则

addAll

Name addAll(int posn,
            Name n)
     throws InvalidNameException

在这个名称中添加一个名称的组件-在一个指定的位置。此名称的组件在第一个新组件的索引或之后被上移（远离0）以适应新的组件。

参数

n -添加组件

posn -这个名字的索引添加新组件。必须在范围[ 0 ]，size()。

结果

更新的名称（不是一个新的）

异常

ArrayIndexOutOfBoundsException如果位置是在指定范围内

InvalidNameException -如果 n不是有效名称，或者如果组件的添加会违反这个名字的语法规则

add

Name add(String comp)
  throws InvalidNameException

在这个名称的结尾添加一个单一组件。

参数

comp -添加组件

结果

更新的名称（不是一个新的）

异常

InvalidNameException如果添加 comp会违反这个名字的语法规则

add

Name add(int posn,
         String comp)
  throws InvalidNameException

在这个名称中在指定位置添加一个单一组件。此名称的组件在新组件的索引后或之后由一个（远离索引0）转移以适应新的组件。

参数

comp -添加组件

posn -的索引添加新组件。必须在范围[ 0 ]，size()。

结果

更新的名称（不是一个新的）

异常

ArrayIndexOutOfBoundsException如果位置是在指定范围内

InvalidNameException如果添加 comp会违反这个名字的语法规则

remove

Object remove(int posn)
       throws InvalidNameException

从这个名称中删除一个组件。在指定位置上的此名称的组件被删除。具有大于此位置的索引的组件被一个向下移动（向索引0）。

参数

posn -组件删除索引。必须在范围[ 0，size()）。

结果

组件删除（字符串）

异常

ArrayIndexOutOfBoundsException如果位置是在指定范围内

InvalidNameException如果删除组件会违反语法规则的名称