LdapName (Java Platform SE 8 )

java.lang.Object
- javax.naming.ldap.LdapName

All Implemented Interfaces:

Serializable， Cloneable， Comparable < Object >， Name
```
public class LdapName
extends Object
implements Name
```
这类代表一个可分辨名称所指定的 RFC 2253。一个杰出的名字，或糖尿病肾病，是由组件的有序列表称为相对可分辨名称，或RDNS。一个DN的语法细节描述在RFC 2253。
这类解决了一些含糊不清的RFC 2253中发现如下：
- RFC 2253叶“空白”定义。ASCII空字符（“”）0x20是用它的地方。
- 空格是让两边的'，'，'；'，' = '，和' + '。这些空白是接受但这个代码的产生，并被忽略当比较的名字。
- 属性值的字符串包含“=”或非主导的#特征（转义）接受。
字符串名称传递给LdapName或返回它使用完整的Unicode字符集。他们也可能含有编码为每个字节由一三个字符的子串如“\\ B4为UTF-8字符”。他们不可能，但是，包含编码为每个字节的字符串中的单个字符的UTF-8字符：表示的意义就会暧昧。

LdapName正确解析所有有效的名称，但并不试图检测出所有可能的违法行为无效的名称解析时。它是“慷慨”在接受无效的名称。“有效性”的名字最终确定当它被提供到LDAP服务器，它可以接受或拒绝该名称的基础上，如它的架构信息和互操作性的因素。

当为相等性进行测试时，属性类型，无论是二进制值和字符串值，都是不区分大小写的。不同但等效使用引用，转义字符串值，或为十六进制编码都是相同的。在多值RDNs组件的顺序（如“欧=销售+ CN =鲍伯”）是不重要的。

组件的LDAP名称，即RDNs、编号。n RDNs的范围从0到n-1个LDAP名称指标。此范围可以写为[ 0，n）。最右边的RDN索引是0，和最左边的RDN是指数n。例如，著名的名字：“CN = Steve Kille，O = ISODE有限，C =国标”依次为从0到2编号：{ c =国标，O = ISODE有限，CN = Steve Kille }。一个空的LDAP的名字是一个空的RDN代表名单。

并发多线程只读访问的LdapName实例不需要同步。

除非另有说明，通过空参数这类构造函数或方法的行为将导致一个NullPointerException异常被抛出。
从以下版本开始：

一点五

另请参见：

Serialized Form

构造方法摘要

构造方法
Constructor and Description
`LdapName(List<Rdn> rdns)` 构建了LDAP名称RDN成分解析。
`LdapName(String name)` 从给定的可分辨名称建立一个LDAP的名字。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Name`	`add(int posn, Rdn comp)` 添加到指定的位置在LDAP名称一个RDN。
`Name`	`add(int posn, String comp)` 添加到指定的位置在LDAP名称单组分。
`Name`	`add(Rdn comp)` 增加了一个单一的RDN的LDAP名称结尾。
`Name`	`add(String comp)` 增加了一个单组分的LDAP名称结尾。
`Name`	`addAll(int posn, List<Rdn> suffixRdns)` 添加-订单-在指定的位置在这个名字一个名字的RDNS。
`Name`	`addAll(int posn, Name suffix)` 在这个名称中添加一个名称的组件-在一个指定的位置。
`Name`	`addAll(List<Rdn> suffixRdns)` 添加一个名为--这个名字最后RDNS。
`Name`	`addAll(Name suffix)` 添加一个名称的组件-以-到这个名称的结尾。
`Object`	`clone()` 生成此名称的新副本。
`int`	`compareTo(Object obj)` 这ldapname与指定对象按顺序比较。
`boolean`	`endsWith(List<Rdn> rdns)` 确定指定的RDN序列形式后缀的LDAP名称。
`boolean`	`endsWith(Name n)` 确定此LDAP名称以指定LDAP名称后缀。
`boolean`	`equals(Object obj)` 确定两个LDAP的名字都是平等的。
`String`	`get(int posn)` 检索一个构件的LDAP名称作为字符串。
`Enumeration<String>`	`getAll()` 检索此名称的组件作为字符串的枚举。
`Name`	`getPrefix(int posn)` 创建一个名称，其组成部分包括一个前缀的LDAP名称组件。
`Rdn`	`getRdn(int posn)` 检索此LDAP名称RDN作为RDN。
`List<Rdn>`	`getRdns()` 检索相对著名的名称的列表。
`Name`	`getSuffix(int posn)` 创建一个名称，其组成部分包括一个后缀在LDAP名称组件。
`int`	`hashCode()` 计算此LDAP名称的哈希代码。
`boolean`	`isEmpty()` 确定此LDAP名称是空的。
`Object`	`remove(int posn)` 删除从LDAP的名字的一部分。
`int`	`size()` 在LDAP名称检索组件的数量。
`boolean`	`startsWith(List<Rdn> rdns)` 确定指定的RDN序列形式前缀的LDAP名称。
`boolean`	`startsWith(Name n)` 确定此LDAP名称与指定LDAP名称前缀开始。
`String`	`toString()` 返回的 RFC 2253在类定义的格式描述此LDAP名称的字符串表示形式。

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

- Constructor Detail
  - LdapName
```
public LdapName(String name)
         throws InvalidNameException
```
    从给定的可分辨名称建立一个LDAP的名字。
    
    参数
    
    name -这是一个非空的可分辨名称的格式根据定义的规则 RFC 2253。
    
    异常
    
    InvalidNameException如果语法违反检测。
    
    另请参见：
    
    Rdn.escapeValue(Object value)
  - LdapName
```
public LdapName(List<Rdn> rdns)
```
    构建了LDAP名称RDN成分解析。
    对RDNS列表中的索引如下编号在类描述RDNS。
    
    参数
    
    rdns - Rdns LDAP名称形成非空列表。
- 方法详细信息
  - size
```
public int size()
```
    在LDAP名称检索组件的数量。
    
    Specified by:
    
    size 接口 Name
    
    结果
    
    在LDAP零件名称非负数。
  - isEmpty
```
public boolean isEmpty()
```
    确定此LDAP名称是空的。一个空名称是一个零组件。
    
    Specified by:
    
    isEmpty 接口 Name
    
    结果
    
    如果LDAP名称是空的真，否则为假。
  - getAll
```
public Enumeration<String> getAll()
```
    检索此名称的组件作为字符串的枚举。在这个枚举上的更新对这个名称的影响是不确定的。如果名称具有零组件，则返回一个空（非空）枚举。枚举所返回的组件的顺序与类描述中所描述的顺序相同的顺序相同。
    
    Specified by:
    
    getAll 接口 Name
    
    结果
    
    一个非空的列举的LDAP名称的组件。枚举的每个元素都是类字符串的。
  - get
```
public String get(int posn)
```
    检索一个构件的LDAP名称作为字符串。
    
    Specified by:
    
    get 接口 Name
    
    参数
    
    posn - 0的构件检索索引。必须在范围[ 0，size()）。
    
    结果
    
    在索引位置非零组件。
    
    异常
    
    IndexOutOfBoundsException如果位置是在指定范围内。
  - getRdn
```
public Rdn getRdn(int posn)
```
    检索此LDAP名称RDN作为RDN。
    
    参数
    
    posn - 0的RDN检索索引。必须在范围[ 0，size()）。
    
    结果
    
    在索引位置的非空的RDN。
    
    异常
    
    IndexOutOfBoundsException如果位置是在指定范围内。
  - getPrefix
```
public Name getPrefix(int posn)
```
    创建一个名称，其组成部分包括一个前缀的LDAP名称组件。此名称的后续更改不会影响返回的名称，反之亦然。
    
    Specified by:
    
    getPrefix 接口 Name
    
    参数
    
    posn - 0指数的成分停止。必须在范围[ 0 ]，size()。
    
    结果
    
    包含在范围内的0项指标 LdapName [组件实例，普森）。如果输入为零，一个空的LDAP名称返回。
    
    异常
    
    IndexOutOfBoundsException如果位置是在指定范围内。
  - getSuffix
```
public Name getSuffix(int posn)
```
    创建一个名称，其组成部分包括一个后缀在LDAP名称组件。此名称的后续更改不影响返回的名称，反之亦然。
    
    Specified by:
    
    getSuffix 接口 Name
    
    参数
    
    posn - 0开始索引处的组件开始。必须在范围[ 0 ]，size()。
    
    结果
    
    组成范围内的[输入指标 LdapName组件实例，size()）。如果输入等于size()，空的LDAP名称返回。
    
    异常
    
    IndexOutOfBoundsException如果位置是在指定范围内。
  - startsWith
```
public boolean startsWith(Name n)
```
    确定此LDAP名称与指定LDAP名称前缀开始。一名 n是前缀如果它等于 getPrefix(n.size()) --换句话说这LDAP的名字开始“N”。如果n是无效的或不rfc2253格式化的名称为类中的描述，则返回FALSE。
    
    Specified by:
    
    startsWith 接口 Name
    
    参数
    
    n的LDAP名称检查。
    
    结果
    
    如果 n是前缀的LDAP的名字真，否则为假。
    
    另请参见：
    
    getPrefix(int posn)
  - startsWith
```
public boolean startsWith(List<Rdn> rdns)
```
    确定指定的RDN序列形式前缀的LDAP名称。如果这ldapname至少只要RDN时返回true，并为每一个位置P的范围[ 0，RDNS。size()）组件getrdn（P）比赛RDNS得到（P）。否则返回假。如果RDNS为空，则返回FALSE。
    
    参数
    
    rdns - Rdns检查序列。
    
    结果
    
    如果 rdns表前缀的LDAP名称真，否则为假。
  - endsWith
```
public boolean endsWith(Name n)
```
    确定此LDAP名称以指定LDAP名称后缀。一名 n是后缀，如果它等于 getSuffix(size()-n.size()) --换句话说LDAP名称结尾的“n”。如果n是无效的或不rfc2253格式化的名称为类中的描述，则返回FALSE。
    
    Specified by:
    
    endsWith 接口 Name
    
    参数
    
    n的LDAP名称检查。
    
    结果
    
    如果 n是后缀这个名字真，否则为假。
    
    另请参见：
    
    getSuffix(int posn)
  - endsWith
```
public boolean endsWith(List<Rdn> rdns)
```
    确定指定的RDN序列形式后缀的LDAP名称。如果这ldapname至少只要RDN时返回true，在距离[ size() - RDNS每个位置P。size()，size()）组件getrdn（P）比赛RDNS得到（P）。否则返回假。如果RDNS为空，则返回FALSE。
    
    参数
    
    rdns - Rdns检查序列。
    
    结果
    
    如果 rdns形式后缀LDAP名称真，否则为假。
  - addAll
```
public Name addAll(Name suffix)
            throws InvalidNameException
```
    添加一个名称的组件-以-到这个名称的结尾。
    
    Specified by:
    
    addAll 接口 Name
    
    参数
    
    suffix -非零组件添加。
    
    结果
    
    更新的名称（不是一个新实例）。
    
    异常
    
    InvalidNameException -如果 suffix不是有效的LDAP名称，或者如果组件的添加会违反本LDAP名称的语法规则。
  - addAll
```
public Name addAll(List<Rdn> suffixRdns)
```
    添加一个名为--这个名字最后RDNS。
    
    参数
    
    suffixRdns -非空 Rdns添加后缀。
    
    结果
    
    更新的名称（不是一个新实例）。
  - addAll
```
public Name addAll(int posn,
                   Name suffix)
            throws InvalidNameException
```
    在这个名称中添加一个名称的组件-在一个指定的位置。在索引后，这个LDAP名称组件（如果有）的第一个新组件上移（远离指数0）以容纳新的成分。
    
    Specified by:
    
    addAll 接口 Name
    
    参数
    
    suffix -非零组件添加。
    
    posn -的索引添加新组件。必须在范围[ 0 ]，size()。
    
    结果
    
    更新的名称（不是一个新实例）。
    
    异常
    
    InvalidNameException -如果 suffix不是有效的LDAP名称，或者如果组件的添加会违反本LDAP名称的语法规则。
    
    IndexOutOfBoundsException如果位置是在指定范围内。
  - addAll
```
public Name addAll(int posn,
                   List<Rdn> suffixRdns)
```
    添加-订单-在指定的位置在这个名字一个名字的RDNS。在这之后，指数或LDAP的名字RDNs（如果有的话）的第一个新的RDN转移了（离指数0）以容纳新的RDNS。
    
    参数
    
    suffixRdns -非空 Rdns添加后缀。
    
    posn -的索引添加后缀RDNS。必须在范围[ 0 ]，size()。
    
    结果
    
    更新的名称（不是一个新实例）。
    
    异常
    
    IndexOutOfBoundsException如果位置是在指定范围内。
  - add
```
public Name add(String comp)
         throws InvalidNameException
```
    增加了一个单组分的LDAP名称结尾。
    
    Specified by:
    
    add 接口 Name
    
    参数
    
    comp -非零组件添加。
    
    结果
    
    更新ldapname，不是一个新的实例。不能为空。
    
    异常
    
    InvalidNameException如果加入公司最后的名字会违反名称的语法。
  - add
```
public Name add(Rdn comp)
```
    增加了一个单一的RDN的LDAP名称结尾。
    
    参数
    
    comp -非空的RDN添加。
    
    结果
    
    更新ldapname，不是一个新的实例。不能为空。
  - add
```
public Name add(int posn,
                String comp)
         throws InvalidNameException
```
    添加到指定的位置在LDAP名称单组分。在索引后，这个LDAP名称组件（如果有）的新组件上移一（远离指数0）以容纳新的成分。
    
    Specified by:
    
    add 接口 Name
    
    参数
    
    comp -非零组件添加。
    
    posn -的索引添加新组件。必须在范围[ 0 ]，size()。
    
    结果
    
    更新ldapname，不是一个新的实例。不能为空。
    
    异常
    
    IndexOutOfBoundsException如果位置是在指定范围内。
    
    InvalidNameException如果加入公司的指定位置处将违反名称的语法。
  - add
```
public Name add(int posn,
                Rdn comp)
```
    添加到指定的位置在LDAP名称一个RDN。在这之后，指数或LDAP的名字RDNs（如果有的话）的新型RDN移了一（远离指数0）以容纳新的RDN。
    
    参数
    
    comp -非空的RDN添加。
    
    posn -的索引来添加新的RDN。必须在范围[ 0 ]，size()。
    
    结果
    
    更新ldapname，不是一个新的实例。不能为空。
    
    异常
    
    IndexOutOfBoundsException如果位置是在指定范围内。
  - remove
```
public Object remove(int posn)
              throws InvalidNameException
```
    删除从LDAP的名字的一部分。在指定位置上的此名称的组件被删除。具有大于此位置的索引的组件（如果有的话）被一个向下移动（向索引0）。
    
    Specified by:
    
    remove 接口 Name
    
    参数
    
    posn -组件删除索引。必须在范围[ 0，size()）。
    
    结果
    
    组件删除（字符串）。
    
    异常
    
    IndexOutOfBoundsException如果位置是在指定范围内。
    
    InvalidNameException如果删除组件会违反语法规则的名称。
  - getRdns
```
public List<Rdn> getRdns()
```
    检索相对著名的名称的列表。列表中的内容是不可修改的。对RDN时在返回列表中的索引如下编号RDNS在类描述。如果名称具有零组件，则返回一个空列表。
    
    结果
    
    名称列表，RDNs是类的 Rdn实例。
  - clone
```
public Object clone()
```
    生成此名称的新副本。此名称的组件的后续更改不会影响新的副本，反之亦然。
    
    Specified by:
    
    clone 接口 Name
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    一个副本的LDAP名称。
    
    另请参见：
    
    Cloneable
  - toString
```
public String toString()
```
    返回的 RFC 2253在类定义的格式描述此LDAP名称的字符串表示形式。如果名称具有零组件，则返回一个空字符串。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    ldapname的字符串表示形式。
  - equals
```
public boolean equals(Object obj)
```
    确定两个LDAP的名字都是平等的。如果obj为空或不是一个LDAP名称，返回false。
    如果在一个RDN在其他等于相应的RDN两LDAP的名字是平等的。这意味着既有RDNS数相同，每个RDN的equals()试验在其他名称与对应的RDN返回true。看到一个平等Rdn.equals(Object obj) RDN定义。
    
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj -比较可能的空对象。
    
    结果
    
    如果obj等于此LDAP的名字真，否则为假。
    
    另请参见：
    
    hashCode()
  - compareTo
```
public int compareTo(Object obj)
```
    这ldapname与指定对象按顺序比较。返回一个负整数、零或一个正整数，因为这个名称小于、等于或大于给定的对象。
    如果对象是无效的或不ldapname实例，抛出ClassCastException。
    
    LDAP名称排序如下字符串比较的编纂规则，这种适用于LDAP的名字所有RDNS延伸。所有RDNS排队在指定的顺序和比较字典。看到Rdn.compareTo(Object obj) RDN比较规则。
    
    如果这名字是字典序小于LDAP对象，返回一个负数。如果LDAP的名字是字典序大于obj，正数返回。
    
    Specified by:
    
    compareTo 接口 Comparable<Object>
    
    Specified by:
    
    compareTo 接口 Name
    
    参数
    
    obj -非空ldapname实例比较。
    
    结果
    
    一个负整数，零，或一个正整数，这名字是小于，等于，或大于给定的对象。
    
    异常
    
    ClassCastException如果obj是无效的或不ldapname。
    
    另请参见：
    
    Comparable.compareTo(Object)
  - hashCode
```
public int hashCode()
```
    计算此LDAP名称的哈希代码。散列码是该名个体RDNS的散列码的总和。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    表示此名称的哈希代码int。
    
    另请参见：
    
    equals(java.lang.Object)

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 LdapName

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

LdapName

LdapName

方法详细信息

size

isEmpty

getAll

get

getRdn

getPrefix

getSuffix

startsWith

startsWith

endsWith

endsWith

addAll

addAll

addAll

addAll

add

add

add

add

remove

getRdns

clone

toString

equals

compareTo

hashCode