Класс 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 корректно проанализирует все допустимые 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.