compact1, compact2, compact3

javax.net.ssl

Класс SNIHostName

java.lang. Объект

javax.net.ssl. SNIServerName

javax.net.ssl. SNIHostName

public final class SNIHostName
extends SNIServerName

Экземпляры этого class представляют имя сервера типа host_name в Индикации Имени сервера (SNI) расширение.

Как описано в разделе 3, "Индикация Имени сервера", из Расширений TLS (RFC 6066), "Имя узла" содержит полностью определенное имя узла DNS сервера, как понято под клиентом. Закодированное значение имени сервера имени узла представляется как строка байтов, используя кодирование ASCII без запаздывающей точки. Это позволяет поддержку Интернационализировавших Доменных имен (IDN) с помощью A-меток (Совместимое с ASCII Кодирование (ACE) форма допустимой строки Интернационализировавших Доменных имен для Приложений (IDNA)) определенный в RFC 5890.

Отметьте это SNIHostName объекты являются неизменными.

С тех пор:

1.8

См. Также:

SNIServerName, StandardConstants.SNI_HOST_NAME

Сводка конструктора

Конструкторы

Конструктор и Описание
SNIHostName(byte[] encoded) Создает SNIHostName использование указанного закодированного значения.
SNIHostName(String hostname) Создает SNIHostName использование указанного имени узла.

Сводка метода

Модификатор и Тип	Метод и Описание
static SNIMatcher	createSNIMatcher(String regex) Создает SNIMatcher объект для SNIHostNames.
boolean	equals(Object other) Сравнивает это имя сервера с указанным объектом.
Строка	getAsciiName() Возвраты StandardCharsets.US_ASCII- совместимое имя узла этого SNIHostName объект.
int	hashCode() Возвращает значение хэш-кода для этого SNIHostName.
Строка	toString() Возвращает строковое представление объекта, включая имя узла DNS в этом SNIHostName объект.

Методы, наследованные от class javax.net.ssl. SNIServerName

getEncoded, getType

Методы, наследованные от class java.lang. Объект

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Деталь конструктора

SNIHostName

public SNIHostName(String hostname)

Создает SNIHostName использование указанного имени узла.

Отметьте, что на RFC 6066, закодированное значение имени сервера имени узла StandardCharsets.US_ASCII- совместимый. В этом методе, hostname может быть удобное для пользователя Интернационализировавшее Доменное имя (IDN). IDN.toASCII(String, int) используется, чтобы осуществить ограничения на символы ASCII в именах узлов (см. RFC 3490, RFC 1122, RFC 1123), и преобразуйте hostname в ASCII Совместимое Кодирование (ACE), как:

     IDN.toASCII(hostname, IDN.USE_STD3_ASCII_RULES);
 

hostname параметр недопустим если это:

• hostname пусто,
• hostname концы с запаздывающей точкой,
• hostname не допустимое Интернационализировавшее Доменное имя (IDN), совместимый со спецификацией RFC 3490.

Параметры:

hostname - имя узла этого имени сервера

Броски:

NullPointerException - если hostname null

IllegalArgumentException - если hostname недопустимо

SNIHostName

public SNIHostName(byte[] encoded)

Создает SNIHostName использование указанного закодированного значения.

Этот метод обычно используется, чтобы проанализировать закодированное значение имени в требуемом расширении SNI.

На RFC 6066 закодированное значение имени имени узла StandardCharsets.US_ASCII- совместимый. Однако, в предыдущей версии расширения SNI (RFC 4366), закодированное имя узла представляется как строка байтов, используя кодирование UTF-8. С целью допуска версии этот метод признает что набор символов encoded параметр может быть StandardCharsets.UTF_8, так же как StandardCharsets.US_ASCII. IDN.toASCII(String) используется, чтобы преобразовать encoded параметр в ASCII Совместимое Кодирование (ACE) имя узла.

Строго рекомендуется, чтобы этот конструктор только использовался, чтобы проанализировать закодированное значение имени в требуемом расширении SNI. Иначе, чтобы выполнить RFC 6066, пожалуйста, всегда используйте StandardCharsets.US_ASCII- совместимый набор символов и осуществляет ограничения на символы ASCII в именах узлов (см. RFC 3490, RFC 1122, RFC 1123) для encoded параметр, или использование SNIHostName(String) вместо этого.

encoded параметр недопустим если это:

• encoded пусто,
• encoded концы с запаздывающей точкой,
• encoded не кодируется в StandardCharsets.US_ASCII или StandardCharsets.UTF_8- совместимый набор символов,
• encoded не допустимое Интернационализировавшее Доменное имя (IDN), совместимый со спецификацией RFC 3490.

Отметьте что encoded байтовый массив клонируется, чтобы защитить от последующей модификации.

Параметры:

encoded - закодированное имя узла этого имени сервера

Броски:

NullPointerException - если encoded null

IllegalArgumentException - если encoded недопустимо

Деталь метода

getAsciiName

public String getAsciiName()

Возвраты StandardCharsets.US_ASCII- совместимое имя узла этого SNIHostName объект.

Отметьте, что на RFC 6066 возвращенное имя узла может быть интернационализировавшим доменным именем, которое содержит A-метки. См. RFC 5890 для получения дополнительной информации о подробной спецификации A-метки.

Возвраты:

StandardCharsets.US_ASCII- совместимое имя узла этого SNIHostName объект

равняется

public boolean equals(Object other)

Сравнивает это имя сервера с указанным объектом.

На RFC 6066 имена узлов DNS являются нечувствительными к регистру. Два имен узлов сервера равны, если, и только если, у них есть тот же самый тип имени, и имена узлов, равны в независимом от случая сравнении.

Переопределения:

equals в class SNIServerName

Параметры:

other - другое имя сервера возражает, чтобы сравниться с.

Возвраты:

истина, если, и только если, other считается равным этому экземпляру

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Возвращает значение хэш-кода для этого SNIHostName.

Значение хэш-кода сгенерировано, используя нечувствительное к регистру имя узла этого SNIHostName.

Переопределения:

hashCode в class SNIServerName

Возвраты:

значение хэш-кода для этого SNIHostName.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Возвращает строковое представление объекта, включая имя узла DNS в этом SNIHostName объект.

Точные детали представления являются неуказанными и подлежат изменению, но следующее может быть расценено как типичное:

     "type=host_name (0), value= <hostname>"
 

" <Имя узла>" представление ASCII имени узла, которое может содержать A-метки. Например, возвращенное значение псевдо имени узла может быть похожим:

     "type=host_name (0), value=www.example.com"
 

или

     "type=host_name (0), value=xn--fsqu00a.xn--0zwm56d"
 

Пожалуйста, ОТМЕТЬТЕ, что точные детали представления являются неуказанными и подлежат изменению.

Переопределения:

toString в class SNIServerName

Возвраты:

строковое представление объекта.

createSNIMatcher

public static SNIMatcher createSNIMatcher(String regex)

Создает SNIMatcher объект для SNIHostNames.

Этот метод может использоваться сервером, чтобы проверить приемлемое SNIHostNames. Например,

     SNIMatcher matcher =
         SNIHostName.createSNIMatcher("www\\.example\\.com");
 

примет имя узла "www.example.com".

     SNIMatcher matcher =
         SNIHostName.createSNIMatcher("www\\.example\\.(com|org)");
 

примет имена узлов "www.example.com" и "www.example.org".

Параметры:

regex - образец регулярного выражения, представляющий имя (ена) узла, чтобы соответствовать

Броски:

NullPointerException - если regex null

PatternSyntaxException - если синтаксис регулярного выражения недопустим