Класс 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. Для методов, которые принимают или возвращают значение атрибута как Object, значение является либо строкой (в необработанном виде), либо массивом байтов.

Rdn правильно проанализирует все допустимые RDN, но не пытается обнаружить все возможные нарушения при анализе недопустимых RDN. Он "щедр" в принятии недопустимых RDN. "Допустимость" имени определяется в конечном итоге при передаче его на сервер LDAP, который может принять или отклонить имя на основе таких факторов, как информация о схеме и соображения по межсетевому взаимодействию.

Следующий пример кода демонстрирует, как создать Rdn, используя конструктор, который принимает тип и значение в качестве аргументов:

Rdn rdn = new Rdn("cn", "Juicy, Fruit");
      System.out.println(rdn.toString());

Последняя строка выведет cn=Juicy\, Fruit. Метод unescapeValue() может быть использован для разбора экранированной запятой, что приводит к исходному значению "Juicy, Fruit". Метод escapeValue() добавляет экранирование, предшествующее запятой.

Этот класс может быть создан по строковому представлению RDN, определённому в RFC 2253, как показано в следующем примере кода:

Rdn rdn = new Rdn("cn=Juicy\\, Fruit");
      System.out.println(rdn.toString());

Последняя строка выведет cn=Juicy\, Fruit.

Одновременный многопоточный доступ для чтения только к экземпляру Rdn не требует синхронизации.

Если не указано иное, поведение передачи null аргумента в конструктор или метод в этом классе вызовет NullPointerException.