Класс 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 содержит как минимум 2 цифры:

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. Допустимо иметь 2 разных ключевых слова, отображающиеся на один и тот же OID.

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

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 из потока, содержащего имя в кодировке 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. Возвращаемая строка — это строка Юникода, полученная при декодировании этого представления 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, как описано в стандарте Юникода и UAX #15

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

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

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

Этот метод возвращает строки в формате, как указано в getName(String), а также выводит дополнительные ключевые слова типа атрибута для ИД, которые имеют записи в oidMap параметре. Записи ИД в параметре oidMap имеют приоритет над стандартными ИД, распознаваемыми getName(String). Неправильно указанные ИД игнорируются; однако если ИД в имени сопоставляется с неправильно указанным ключевым словом, бросается исключение 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 и если соответствующие канонические строковые представления (полученные через метод getName(X500Principal.CANONICAL) ) этого объекта и o равны.

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

public int hashCode()

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

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