Rdn (Платформа Java SE 7)

java.lang. Объект
- javax.naming.ldap. Rdn

Все Реализованные Интерфейсы:

Сериализуемый, Сопоставимый <Объект>
```
public class Rdn
extends Object
implements Serializable, Comparable<Object>
```
Этот класс представляет относительное отличительное имя, или RDN, который является компонентом отличительного имени как определено RFC 2253. Примером RDN является "OU=Sales+CN=J.Smith". В этом примере RDN состоят из многократных пар типа/значения атрибута. RDN анализируется как описано в описании класса для LdapName.
Класс Rdn представляет RDN как отображения типа/значения атрибута, которые могут быть просмотрены, используя Attributes. Кроме того, это содержит методы удобства, которые позволяют легкое извлечение типа и значения, когда Rdn состоят из единственной пары типа/значения, которая является, как это появляется в типичном использовании. Это также содержит методы помощника, которые позволяют выходить бесформатного значения атрибута и невыходить значения, отформатированного согласно синтаксису выхода, определенному в RFC2253. Для методов, которые берут или возвращают значение атрибута как Объект, значением является любой Строка (в неоставленной форме) или байтовый массив.
Rdn должным образом проанализирует весь допустимый RDNs, но не пытается обнаружить все возможные нарушения, анализируя недопустимый RDNs. Это "щедро" в принятии недопустимого RDNs. "Законность" имени определяется в конечном счете, когда она предоставляется серверу LDAP, который может принять или отклонить имя, основанное на факторах, таких как его соображения информации и функциональной совместимости схемы.
Следующий пример кода показывает, как создать Rdn, используя конструктора, который берет тип и значение как параметры:
```
      Rdn rdn = new Rdn("cn", "Juicy, Fruit");
      System.out.println(rdn.toString());
 
```
Последняя строка напечатает cn=Juicy\, Fruit. unescapeValue() метод может использоваться, чтобы невыйти из оставленной запятой, приводящей к исходному значению "Juicy, Fruit". escapeValue() метод добавляет escape, назад предшествующий запятой.
Этот класс может инстанцировать строковое представление RDN, определенного в RFC 2253 как показано в следующем примере кода:
```
      Rdn rdn = new Rdn("cn=Juicy\\, Fruit");
      System.out.println(rdn.toString());
 
```
Последняя строка напечатает cn=Juicy\, Fruit.
Параллельный многопоточный доступ только для чтения экземпляра Rdn не должен синхронизироваться.
Если не указано иное, поведение передачи нулевого параметра конструктору или методу в этом классе заставит NullPointerException быть брошенным.
С тех пор:

1.5

См. Также:
Сериализированная Форма

Сводка конструктора

Конструкторы
Конструктор и Описание
`Rdn(Attributes attrSet)` Создает Rdn из данного набора атрибута.
`Rdn(Rdn rdn)` Создает Rdn из данного `rdn`.
`Rdn(String rdnString)` Создает Rdn из данной строки.
`Rdn(String type, Object value)` Создает Rdn из данного типа атрибута и значения.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`int`	`compareTo(Object obj)` Сравнивает этот Rdn с указанным Объектом для порядка.
`boolean`	`equals(Object obj)` Сравнивает указанный Объект с этим Rdn для равенства.
`static String`	`escapeValue(Object val)` Учитывая значение атрибута, возвращает строку, которой оставляют согласно правилам, определенным в RFC 2253.
`Строка`	`getType()` Получает один из типа этого Рдн.
`Объект`	`getValue()` Получает одно из значения этого Рдн.
`int`	`hashCode()` Возвращает хэш-код этого RDN.
`int`	`size()` Получает число пар типа/значения атрибута в этом Rdn.
`Атрибуты`	`toAttributes()` Получает `Attributes` представление отображений типа/значения содержится в этом Rdn.
`Строка`	`toString()` Возвраты этот Rdn как строка, представленная в формате, определенном RFC 2253 и, описали в описании класса для `LdapName`.
`static Object`	`unescapeValue(String val)` Учитывая строку значения атрибута, форматированную согласно правилам, определенным в RFC 2253, возвращает восстановленное после форматирования значение.

Методы java.lang унаследованный от класса. Объект
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - Rdn
```
public Rdn(Attributes attrSet)
    throws InvalidNameException
```
    Создает Rdn из данного набора атрибута. См. Attributes.
    Строковые значения атрибута не являются interpretted как 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 из данного типа атрибута и значения. Строковые значения атрибута не являются interpretted как RFC 2253 отформатированные строки RDN. Таким образом, значения используются буквально (не проанализированный) и, как предполагают, неоставляются.
    
    Параметры:
    type - Ненулевая и непустая строка приписывает тип.
    value - Ненулевое и непустое значение атрибута.
    
    Броски:
    
    InvalidNameException - Если тип/значение не может использоваться, чтобы создать допустимый RDN.
    См. Также:
    toString()
- Деталь метода
  - getValue
```
public Object getValue()
```
    Получает одно из значения этого Рдн. Это - метод удобства для того, чтобы получить значение, когда RDN содержит единственный тип и построение карты ценности, которое является общим использованием RDN.
    Для многозначного RDN этот метод возвращает значение, соответствующее типу, возвращенному getType() метод.
    
    Возвраты:
    Значение ненеопределенного атрибута.
  - getType
```
public String getType()
```
    Получает один из типа этого Рдн. Это - метод удобства для того, чтобы получить тип, когда RDN содержит единственный тип и построение карты ценности, которое является общим использованием RDN.
    Для многозначного RDN у пар типа/значения нет никакого определенного порядка, определенного на них. В этом случае этот метод возвращает тип одной из пар типа/значения. getValue() метод возвращает значение, соответствующее типу, возвращенному этим методом.
    
    Возвраты:
    Тип ненеопределенного атрибута.
  - toString
```
public String toString()
```
    Возвраты этот Rdn как строка, представленная в формате, определенном RFC 2253 и, описали в описании класса для LdapName.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    Строковое представление Rdn.
  - compareTo
```
public int compareTo(Object obj)
```
    Сравнивает этот Rdn с указанным Объектом для порядка. Возвращает отрицательное целое число, нуль, или положительное целое число, поскольку этот Rdn является меньше чем, равный, или больше чем данный Объект.
    Если obj является нулем или не экземпляром Rdn, ClassCastException бросается.
    Тип атрибута и пары значения RDNs выстраиваются в линию друг против друга и сравниваются лексикографически. Порядок компонентов в многозначном Rdns (таких как "ou=Sales+cn=Bob") не является существенным.
    
    Определенный:
    
    compareTo в интерфейсе Comparable<Object>
    
    Параметры:
    obj - Ненулевой объект сравниться с.
    
    Возвраты:
    Отрицательное целое число, нуль, или положительное целое число как этот Rdn являются меньше чем, равный, или больше чем данный Объект.
    
    Броски:
    
    ClassCastException - если obj является нулем или не Rdn.
  - равняется
```
public boolean equals(Object obj)
```
    Сравнивает указанный Объект с этим Rdn для равенства. Возвращает true, если данным объектом является также Rdn, и два Rdns представляют тот же самый тип атрибута и оценивают отображения. Порядок компонентов в многозначном Rdns (таких как "ou=Sales+cn=Bob") не является существенным.
    Введите и оцените соответствие equalilty, делается как указано ниже:
    - Типы сравниваются для равенства с их игнорируемым регистром.
    - Строковые значения с различным но эквивалентным использованием заключения в кавычки, выхода, или UTF8-hex-encoding считают равными. Регистр значений игнорируется во время сравнения.
    Если obj является нулем или не экземпляром Rdn, false возвращается.
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    obj - объект, который будет сравнен для равенства с этим Rdn.
    
    Возвраты:
    истина, если указанный объект равен этому Rdn.
    См. Также:
    hashCode()
  - хэш-код
```
public int hashCode()
```
    Возвращает хэш-код этого RDN. У двух RDNs, которые равны (согласно равняется методу) будет тот же самый хэш-код.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    Интервал, представляющий хэш-код этого Rdn.
    См. Также:
    equals(java.lang.Object)
  - toAttributes
```
public Attributes toAttributes()
```
    Получает Attributes представление отображений типа/значения содержится в этом Rdn.
    
    Возвраты:
    Ненеопределенные атрибуты, содержащие отображения типа/значения этого Rdn.
  - размер
```
public int size()
```
    Получает число пар типа/значения атрибута в этом Rdn.
    
    Возвраты:
    Неотрицательное число пар типа/значения в этом Rdn.
  - escapeValue
```
public static String escapeValue(Object val)
```
    Учитывая значение атрибута, возвращает строку, которой оставляют согласно правилам, определенным в RFC 2253.
    Например, если val, "Предъявляют иск, Grabbit и Runn", оставленное значение, возвращенное этим методом, "Предъявляют иск \, Grabbit и Runn".
    Строковое значение представляется как Строка и двоичное значение как байтовый массив.
    
    Параметры:
    val - Ненулевой объект, которого оставят.
    
    Возвраты:
    Оставленное строковое значение.
    
    Броски:
    
    ClassCastException - если val, не Строка или байтовый массив.
  - unescapeValue
```
public static Object unescapeValue(String val)
```
    Учитывая строку значения атрибута, форматированную согласно правилам, определенным в RFC 2253, возвращает восстановленное после форматирования значение. Escape и кавычки сняты, и шестнадцатерично закодированы, UTF-8 преобразовывается в эквивалентные символы UTF-16. Возвращает строковое значение как Строку, и двоичное значение как байтовый массив.
    Юридические и недопустимые значения определяются в RFC 2253. Этот метод щедр в принятии значений и не ловит все недопустимые значения. Поэтому, передача в недопустимом значении не могла бы обязательно инициировать IllegalArgumentException.
    
    Параметры:
    val - Непустая строка, которой неоставят.
    
    Возвраты:
    Неоставленное значение.
    
    Броски:
    
    IllegalArgumentException - Когда Недопустимое значение обеспечивается.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс Rdn

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

Rdn

Rdn

Rdn

Rdn

Деталь метода

getValue

getType

toString

compareTo

равняется

хэш-код

toAttributes

размер

escapeValue

unescapeValue