Класс 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 с нескольких потоков для чтения и только для чтения не требует синхронизации.

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