|
|||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | ||||||||
javax.naming
接口 Name
- 所有超级接口：
- Cloneable, Comparable<Object>, Serializable
- 所有已知实现类：
- CompositeName, CompoundName, LdapName
-
public interface Name
- extends Cloneable, Serializable, Comparable<Object>
Name 接口表示一个一般名称，即一个有序的组件序列。该名称可以是一个复合名称（跨多个名称空间的名称），或是一个组合名称（在各个分层的命名系统中使用的名称）。
可以有不同的 Name 实现；例如，复合名称、URL 或特定于名称空间的组合名称。
名称的组件都已编号。带 N 个组件的名称的索引在 0 到 N（但不包括 N）的范围内变动。可将该范围写为 [0,N)。最重要的组件位于索引 0 处。空名称没有组件。
此接口中的所有方法都不接收 null 作为一个参数（名称和名称组件）的有效值。同样，返回名称或名称组件的方法绝不会返回 null。
Name 的实例在不是只读访问时无法与并发多线程访问同步。
- 从以下版本开始：
- 1.3
| 字段摘要 | |
|---|---|
static long |
serialVersionUID 为指示与以前的类版本序列化兼容而设置的类指纹。 |
| 方法摘要 | |
|---|---|
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) 确定此名称是否从某一指定前缀开始。 |
| 字段详细信息 |
|---|
serialVersionUID
static final long serialVersionUID
-
为指示与以前的类版本序列化兼容而设置的类指纹。
- 另请参见：
- 常量字段值
| 方法详细信息 |
|---|
clone
Object clone()
- 生成此名称的新副本。对此名称的组件进行的后续更改不会影响新副本，反之亦然。
-
-
- 返回：
- 此名称的副本
- 另请参见：
-
Object.clone()
compareTo
int compareTo(Object obj)
-
比较此名称与另一个名称的顺序。根据此名称小于、等于还是大于给定名称分别返回负整数、零或正整数。
对于 Object.equals()，名称排序的概念取决于实现此接口的类。例如，该排序可能基于名称组件的字典顺序进行。该名称的特定属性（比如对待大小写的方式）可能影响排序。通常，无法比较两个不同类的名称。
-
- 指定者：
-
接口
Comparable<Object>中的compareTo
-
- 参数：
-
obj- 要与之比较的非 null 对象。 - 返回：
- 根据此名称小于、等于还是大于给定名称分别返回负整数、零或正整数
- 抛出：
-
ClassCastException- 如果 obj 不是一个可以与此名称进行比较的类型的 Name - 另请参见：
-
Comparable.compareTo(Object)
size
int size()
- 返回此名称中的组件数。
-
-
- 返回：
- 此名称中的组件数。
isEmpty
boolean isEmpty()
- 确定此名称是否为空。空名称是没有任何组件的名称。
-
-
- 返回：
- 如果此名称为空，则返回 true，否则返回 false
getAll
Enumeration<String> getAll()
- 以字符串枚举的形式检索此名称的组件。在该枚举上更新此名称的效果是不确定的。如果该名称没有组件，则返回空（非 null）枚举。
-
-
- 返回：
- 此名称的组件所组成的枚举，每个组件都是一个字符串
get
String get(int posn)
- 检索此名称的组件。
-
-
- 参数：
-
posn- 要检索的从 0 开始的组件索引。该索引必须在范围 [0,size()) 内。 - 返回：
- 索引 posn 处的组件
- 抛出：
-
ArrayIndexOutOfBoundsException- 如果 posn 超出指定范围
getPrefix
Name getPrefix(int posn)
- 创建一个名称，其组件由此名称中组件的前缀组成。对此名称进行的后续更改不会影响返回的名称，反之亦然。
-
-
- 参数：
-
posn- 从 0 开始的组件索引，在该索引处停止。该索引必须在范围 [0,size()] 内。 - 返回：
- 由索引范围在 [0,posn) 之间的组件组成的名称。
- 抛出：
-
ArrayIndexOutOfBoundsException- 如果 posn 超出指定范围
