Класс X500Principal

public static final String RFC1779

Строковый формат различительных имён RFC 1779.

public static final String RFC2253

Строковый формат различительных имён RFC 2253.

public static final String CANONICAL

Канонический строковый формат различительных имён.

public X500Principal(String name)

Создаёт X500Principal из строкового представления различительного имени X.500 (например: «CN=Duke, OU=JavaSoft, O=Sun Microsystems, C=US»). Различительное имя должно быть задано в соответствии с грамматикой, определённой в RFC 1779 или RFC 2253 (допустим любой из этих форматов).

Этот конструктор распознаёт ключевые слова типов атрибутов, определённые в RFC 1779 и RFC 2253 (и перечисленные в getName(String format)), а также ключевые слова T, DNQ или DNQUALIFIER, SURNAME, GIVENNAME, INITIALS, GENERATION, EMAILADDRESS и SERIALNUMBER, чьи идентификаторы объектов (OID) определены в RFC 5280. Любой другой тип атрибута должен быть задан в виде OID.

Эта реализация применяет более строгий синтаксис OID, чем определён в RFC 1779 и 2253. В ней используется более корректный синтаксис, определённый в RFC 4512, согласно которому OID должны содержать не менее двух цифр:

numericoid = number 1*( DOT number )

public X500Principal(String name, Map<String,String> keywordMap)

Создаёт X500Principal из строкового представления различительного имени X.500 (например: «CN=Duke, OU=JavaSoft, O=Sun Microsystems, C=US»). Различительное имя должно быть задано в соответствии с грамматикой, определённой в RFC 1779 или RFC 2253 (допустим любой из этих форматов).

Этот конструктор распознаёт ключевые слова типов атрибутов, указанные в X500Principal(String), а также дополнительные ключевые слова, записи для которых присутствуют в параметре keywordMap. Записи ключевых слов в keywordMap имеют приоритет над ключевыми словами по умолчанию, распознаваемыми X500Principal(String). Ключевые слова ДОЛЖНЫ быть указаны прописными буквами, иначе они будут проигнорированы. Неправильно заданные ключевые слова игнорируются; однако если ключевое слово в имени сопоставлено с неправильно заданным идентификатором объекта (OID), выбрасывается IllegalArgumentException. Разрешается использовать два разных ключевых слова, сопоставленных с одним и тем же OID.

Эта реализация применяет более строгий синтаксис OID, чем определён в RFC 1779 и 2253. В ней используется более корректный синтаксис, определённый в RFC 4512, согласно которому OID должны содержать не менее двух цифр:

numericoid = number 1*( DOT number )

public X500Principal(byte[] name)

Создаёт X500Principal из различительного имени в кодировке ASN.1 DER. Обозначение ASN.1 для этой структуры выглядит следующим образом.

Name ::= CHOICE {
  RDNSequence }

RDNSequence ::= SEQUENCE OF RelativeDistinguishedName

RelativeDistinguishedName ::=
  SET SIZE (1 .. MAX) OF AttributeTypeAndValue

AttributeTypeAndValue ::= SEQUENCE {
  type     AttributeType,
  value    AttributeValue }

AttributeType ::= OBJECT IDENTIFIER

AttributeValue ::= ANY DEFINED BY AttributeType
....
DirectoryString ::= CHOICE {
      teletexString           TeletexString (SIZE (1..MAX)),
      printableString         PrintableString (SIZE (1..MAX)),
      universalString         UniversalString (SIZE (1..MAX)),
      utf8String              UTF8String (SIZE (1.. MAX)),
      bmpString               BMPString (SIZE (1..MAX)) }

public X500Principal(InputStream is)

Создаёт X500Principal из InputStream, содержащего различительное имя в кодировке ASN.1 DER. Обозначение ASN.1 для этой структуры приведено в документации к X500Principal(byte[] name).

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

public String getName()

Возвращает строковое представление различительного имени X.500 в формате, определённом в RFC 2253.

Этот метод эквивалентен вызову getName(X500Principal.RFC2253).

public String getName(String format)

Возвращает строковое представление различительного имени X.500 в указанном формате. Допустимые значения формата: «RFC1779», «RFC2253» и «CANONICAL» (без учёта регистра).

Если в качестве формата указано «RFC1779», этот метод выводит ключевые слова типов атрибутов, определённые в RFC 1779 (CN, L, ST, O, OU, C, STREET). Все остальные типы атрибутов выводятся в виде OID.

Если в качестве формата указано «RFC2253», этот метод выводит ключевые слова типов атрибутов, определённые в RFC 2253 (CN, L, ST, O, OU, C, STREET, DC, UID). Все остальные типы атрибутов выводятся в виде OID. При строгом толковании RFC 2253 определяет только строковое представление UTF-8. Строка, возвращаемая этим методом, — это строка Unicode, полученная декодированием данного представления UTF-8.

Если в качестве формата указано «CANONICAL», этот метод возвращает строковое представление, соответствующее RFC 2253, со следующими дополнительными канонизациями:

1. Ведущие нули удаляются из типов атрибутов, закодированных в виде десятичных OID с точками
2. Значения атрибутов DirectoryString типа PrintableString и UTF8String не выводятся в шестнадцатеричном формате
3. Значения атрибутов DirectoryString типов, отличных от PrintableString и UTF8String, выводятся в шестнадцатеричном формате
4. Начальные и конечные пробельные символы удаляются из не шестнадцатеричных значений атрибутов (если только значение не состоит целиком из пробельных символов)
5. Внутренние последовательности из одного или нескольких пробельных символов заменяются одним пробелом в не шестнадцатеричных значениях атрибутов
6. Относительные различительные имена, содержащие более одного утверждения значения атрибута (AVA), выводятся в следующем порядке: сначала AVA со стандартными ключевыми словами в алфавитном порядке, затем AVA с ключевыми словами OID в числовом порядке.
7. В значениях атрибутов экранируются только символы, которые согласно разделу 2.4 RFC 2253 должны экранироваться (перед ними добавляется обратная косая черта)
8. Всё имя переводится в верхний регистр с помощью String.toUpperCase(Locale.US)
9. Всё имя переводится в нижний регистр с помощью String.toLowerCase(Locale.US)
10. В завершение имя нормализуется с использованием формы нормализации KD, описанной в стандарте Unicode и UAX #15

В будущем могут появиться дополнительные стандартные форматы.

public String getName(String format, Map<String,String> oidMap)

Возвращает строковое представление различительного имени X.500 в указанном формате. Допустимые значения формата: «RFC1779» и «RFC2253» (без учёта регистра). Значение «CANONICAL» недопустимо, и будет выброшено IllegalArgumentException.

Этот метод возвращает строки в формате, указанном в getName(String), а также выводит дополнительные ключевые слова типов атрибутов для OID, записи которых имеются в параметре oidMap. Записи OID в oidMap имеют приоритет над OID по умолчанию, распознаваемыми getName(String). Неправильно заданные OID игнорируются; однако если OID в имени сопоставлен с неправильно заданным ключевым словом, выбрасывается IllegalArgumentException.

В будущем могут появиться дополнительные стандартные форматы.

Предупреждение: дополнительные ключевые слова типов атрибутов могут не распознаваться другими реализациями; поэтому не используйте этот метод, если не уверены, что другие реализации распознают эти ключевые слова.

public byte[] getEncoded()

Возвращает различительное имя в кодировке ASN.1 DER. Обозначение ASN.1 для этой структуры приведено в документации к X500Principal(byte[] name).

Обратите внимание: возвращаемый массив байтов клонируется для защиты от последующих изменений.

public String toString()

Возвращает удобное для пользователя строковое представление этого X500Principal.

public boolean equals(Object o)

Сравнивает указанный Object с этим X500Principal на равенство.

В частности, этот метод возвращает true, если Object o является X500Principal и канонические строковые представления этого объекта и o (полученные с помощью метода getName(X500Principal.CANONICAL)) равны.

Эта реализация соответствует требованиям RFC 5280.

public int hashCode()

Возвращает хеш-код этого X500Principal.

Хеш-код вычисляется следующим образом: getName(X500Principal.CANONICAL).hashCode()