Класс 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. Для получения дополнительной информации о спецификации меток A см. RFC 5890.

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".