Класс SNIHostName

public SNIHostName(String hostname)

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

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

    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. Для преобразования аргумента encoded в имя узла в ASCII-совместимой кодировке (ACE) используется IDN.toASCII(String).

Настоятельно рекомендуется использовать этот конструктор только для разбора закодированного значения имени в запрошенном расширении 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».