Rdn (Java Platform SE 8 )

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

All Implemented Interfaces:

Serializable Comparable Object >，<
```
public class Rdn
extends Object
implements Serializable, Comparable<Object>
```
这类代表一个相对可分辨名称或RDN，这是一个组件的可分辨名称所指定的 RFC 2253。一个RDN的一个例子是“欧=销售+ CN = j.smith”。在这个例子中，RDN由多个属性/值对。RDN是解析为在类描述为 LdapName。
RDN类代表一个RDN属性类型/值的映射，它可以被视为使用Attributes。此外，它包含的方便方法，允许的类型和值容易检索时的RDN由单一类型/值对，这正是它出现在一个典型的使用。它还含有辅助方法允许的未格式化的属性值和非转义逃逸的价值根据语法中定义的格式rfc2253逃逸。方法以返回属性值为一个对象，该值是一个字符串（在非转义形式）或字节数组。

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

下面的代码示例演示如何使用需要的类型和值作为参数的构造函数构造一个RDN：
```
RDN RDN =新的RDN（“CN”、“Juicy果”）；系统。出来。println（RDN。tostring()）；
```
最后一行打印 cn=Juicy\, Fruit， unescapeValue()方法可用于unescape逃跑的逗号导致原有价值 "Juicy, Fruit"。的 escapeValue()方法加逃回前面的逗号。
这个类可以通过在RFC 2253，如下面的代码示例所示的RDN定义字符串表示形式实例化：
```
RDN RDN =新的RDN（CN =多汁\\，果”）；系统。出来。println（RDN。tostring()）；
```
最后一行打印 cn=Juicy\, Fruit
并发多线程只读访问的Rdn实例不需要同步。

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

一点五

另请参见：

Serialized Form

构造方法摘要

构造方法
Constructor and Description
`Rdn(Attributes attrSet)` 构建了由给定的属性设置一个RDN。
`Rdn(Rdn rdn)` 构建了从给定的 `rdn` RDN。
`Rdn(String rdnString)` 构建了从给定字符串的RDN。
`Rdn(String type, Object value)` 构建了从给定的属性的类型和值的RDN。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`int`	`compareTo(Object obj)` 该RDN与指定对象按顺序比较。
`boolean`	`equals(Object obj)` 指定对象与RDN平等的比较。
`static String`	`escapeValue(Object val)` 给定一个属性的值，返回一个字符串中指定了根据 RFC 2253规则。
`String`	`getType()` 检索一本Rdn的类型。
`Object`	`getValue()` 检索一本Rdn的价值。
`int`	`hashCode()` 返回该RDN散列码。
`int`	`size()` 检索该RDN属性/值对的数目。
`Attributes`	`toAttributes()` 检索包含在该RDN的类型/值映射的 `Attributes`观。
`String`	`toString()` 作为一个字符串的 RFC 2253在 `LdapName`类描述定义的格式表示返回该RDN。
`static Object`	`unescapeValue(String val)` 根据指定的规则 RFC 2253给定属性值的字符串格式化，返回unformated价值。

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

- Constructor Detail
  - Rdn
```
public Rdn(Attributes attrSet)
    throws InvalidNameException
```
    构建了由给定的属性设置一个RDN。看到 Attributes。
    字符串属性值不解释为RFC 2253 RDN字符串格式化。即值使用字面（不解析），假定是转义。
    
    参数
    
    attrSet -非空非空属性包含类型/值的映射。
    
    异常
    
    InvalidNameException -如果 attrSet内容不能被用来构建一个有效的RDN。
  - Rdn
```
public Rdn(String rdnString)
    throws InvalidNameException
```
    构建了从给定字符串的RDN。此构造函数接受一个字符串格式化根据定义在 RFC 2253在 LdapName类描述规则。
    
    参数
    
    rdnString -非空非空rfc2253格式化字符串。
    
    异常
    
    InvalidNameException -如果在rdnstring解析出现语法错误。
  - Rdn
```
public Rdn(Rdn rdn)
```
    构建了从给定的 rdn RDN。该 rdn内容简单地复制到新创建的RDN。
    
    参数
    
    rdn -非空的RDN被复制。
  - Rdn
```
public Rdn(String type,
           Object value)
    throws InvalidNameException
```
    构建了从给定的属性的类型和值的RDN。字符串属性值不解释为 RFC 2253 RDN字符串格式化。即值使用字面（不解析），假定是转义。
    
    参数
    
    type -非空非空字符串的属性类型。
    
    value -非空非空的属性值。
    
    异常
    
    InvalidNameException如果类型/值不能被用来构建一个有效的RDN。
    
    另请参见：
    
    toString()
- 方法详细信息
  - getValue
```
public Object getValue()
```
    检索一本Rdn的价值。这是一个获取价值的便利方法，当RDN包含一个单一的类型和值的映射，这是常见的RDN的用法。
    一个多值RDN，此方法返回的类型的getType()方法返回相应的值。
    
    结果
    
    非空属性值。
  - getType
```
public String getType()
```
    检索一本Rdn的类型。这是一个获取型方便的方法，当RDN包含一个单一的类型和值的映射，这是常见的RDN的用法。
    一个多值RDN，类型/值对没有特定的顺序上定义。在这种情况下，这种方法返回类型/值对的类型之一。getValue()方法返回的类型相对应的该方法返回的值。
    
    结果
    
    非空属性类型。
  - toString
```
public String toString()
```
    作为一个字符串的 RFC 2253在 LdapName类描述定义的格式表示返回该RDN。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    RDN的字符串表示形式的。
  - compareTo
```
public int compareTo(Object obj)
```
    该RDN与指定对象按顺序比较。返回一个负整数，零，或一个正整数，这Rdn是小于，等于，或大于给定的对象。
    如果obj为空或不含药的实例，抛出ClassCastException。
    
    属性的类型和值对排队RDNS互相比较字典。在多值Rdns组件的顺序（如“欧=销售+ CN =鲍伯”）是不重要的。
    
    Specified by:
    
    compareTo 接口 Comparable<Object>
    
    参数
    
    obj -非null对象比较。
    
    结果
    
    一个负整数，零，或一个正整数，这Rdn是小于，等于，或大于给定的对象。
    
    异常
    
    ClassCastException如果obj为空或不是RDN。
  - equals
```
public boolean equals(Object obj)
```
    指定对象与RDN平等的比较。如果给定的对象也是一个RDN和两RDN时返回true，表示同一属性的类型和值的映射。在多值Rdns组件的顺序（如“欧=销售+ CN =鲍伯”）是不重要的。
    类型和值相等的匹配做如下：
    - 的类型进行比较，以平等与他们的情况下忽略。
    - 不同但等效使用引用，转义字符串值，或为十六进制编码都是相同的。在比较中忽略值的情况下。
    如果obj为空或不含药的实例，则返回FALSE。
    重写：
    
    equals 方法重写，继承类 Object
    
    参数
    
    obj对象进行比较与RDN平等。
    
    结果
    
    如果指定的对象是否等于该RDN。
    
    另请参见：
    
    hashCode()
  - hashCode
```
public int hashCode()
```
    返回该RDN散列码。两RDNS相等（根据equals方法）将具有相同的哈希代码。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    代表该RDN散列码int。
    
    另请参见：
    
    equals(java.lang.Object)
  - toAttributes
```
public Attributes toAttributes()
```
    检索包含在该RDN的类型/值映射的 Attributes观。
    
    结果
    
    非空属性包含该RDN的类型/值的映射。
  - size
```
public int size()
```
    检索该RDN属性/值对的数目。
    
    结果
    
    非负数的类型/值对该RDN。
  - escapeValue
```
public static String escapeValue(Object val)
```
    给定一个属性的值，返回一个字符串中指定了根据 RFC 2253规则。
    例如，如果val”苏、Grabbit和运行”，逃跑的该方法返回的值是“苏、参与和运行”。
    
    一个字符串值表示为一个字符串和一个字节数组的二进制值。
    
    参数
    
    val -非空对象是逃跑。
    
    结果
    
    字符串值。
    
    异常
    
    ClassCastException如果val的值不是一个字符串或字节数组。
  - unescapeValue
```
public static Object unescapeValue(String val)
```
    根据指定的规则 RFC 2253给定属性值的字符串格式化，返回unformated价值。逃避和报价是剥夺，和十六进制编码UTF-8转换为等价的UTF-16字符。返回一个字符串值作为字符串，和一个二进制值作为一个字节数组。
    合法的和非法的值是在RFC 2253中定义的。这种方法是慷慨的接受价值观，不捕捉所有的非法价值。因此，通过在一个非法的价值并不必然引发IllegalArgumentException。
    
    参数
    
    val -非空字符串被转义。
    
    结果
    
    保留的价值。
    
    异常
    
    IllegalArgumentException -当一个非法值设置。

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 Rdn

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

Rdn

Rdn

Rdn

Rdn

方法详细信息

getValue

getType

toString

compareTo

equals

hashCode

toAttributes

size

escapeValue

unescapeValue