Класс 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.

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 клонируется для защиты от последующих изменений.

public String getAsciiName()

Возвращает имя хоста, совместимое с StandardCharsets.US_ASCII, этого объекта SNIHostName.

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

public boolean equals(Object other)

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

Согласно RFC 6066, имена хостов DNS нечувствительны к регистру. Два имени сервера-хоста равны, если и только если они имеют одинаковый тип имени и имена равны в сравнении без учёта регистра.

public int hashCode()

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

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

public String toString()

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

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

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

Значение "<hostname>" — это представление имени хоста в формате ASCII, которое может содержать метки A. Например, возвращаемое значение псевдо-имени хоста может выглядеть так:

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

или

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

Обратите ВНИМАНИЕ, что точные детали представления не определены и могут быть изменены.

public static SNIMatcher createSNIMatcher(String regex)

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

Этот метод может быть использован сервером для проверки допустимых SNIHostName. Например,

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

примет имя хоста "www.example.com".

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

примет имена хостов "www.example.com" и "www.example.org".