Класс IDN

java.lang.Object

java.net.IDN

public final class IDN extends Object

Предоставляет методы для преобразования интернационализированных доменных имён (IDN) между обычным представлением Unicode и представлением ASCII Compatible Encoding (ACE). Интернационализированные доменные имена могут использовать символы из всего диапазона Unicode, тогда как традиционные доменные имена ограничены символами ASCII. ACE — это кодировка строк Unicode, которая использует только символы ASCII и может использоваться с программным обеспечением (таким как система доменных имён), которое понимает только традиционные доменные имена.

Интернетационализированные доменные имена определены в RFC 3490. RFC 3490 определяет две операции: ToASCII и ToUnicode. Эти 2 операции используют алгоритм Nameprep, который является профилем алгоритма Stringprep, и алгоритм Punycode для преобразования строки доменного имени в обе стороны.

Поведение указанного процесса преобразования может быть скорректировано различными флагами:

Если используется флаг ALLOW_UNASSIGNED, строка доменного имени, подлежащая преобразованию, может содержать кодовые точки, не назначенные в Unicode 3.2, который является версией Unicode, на которой основано преобразование IDN. Если флаг не используется, наличие таких неназначенных кодовых точек рассматривается как ошибка.
Если используется флаг USE_STD3_ASCII_RULES, строки ASCII проверяются на соответствие RFC 1122 и RFC 1123. Если они не соответствуют требованиям, это ошибка.

Эти флаги могут быть логически объединены.

Важное значение имеет вопрос безопасности в отношении поддержки интернационализированных доменных имён. Например, английские доменные имена могут быть гомографически — злонамеренно неправильно написаны путём замены латинских символов на другие. Технический отчёт Unicode #36 также рассматривает вопросы безопасности поддержки IDN и возможные решения. Приложения несут ответственность за принятие надлежащих мер безопасности при использовании интернационализированных доменных имён.

Since:

1.6

Внешние спецификации

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`ALLOW_UNASSIGNED`	Флаг для разрешения обработки неназначенных кодовых точек
`static final int`	`USE_STD3_ASCII_RULES`	Флаг для включения проверки по правилам ASCII STD-3

Краткое описание методов

Модификатор и тип	Метод	Описание
`static String`	`toASCII(String input)`	Преобразует строку из Unicode в ASCII Compatible Encoding (ACE), как определено операцией ToASCII в RFC 3490.
`static String`	`toASCII(String input, int flag)`	Преобразует строку из Unicode в ASCII Compatible Encoding (ACE), как определено операцией ToASCII в RFC 3490.
`static String`	`toUnicode(String input)`	Преобразует строку из ASCII Compatible Encoding (ACE) в Unicode, как определено операцией ToUnicode в RFC 3490.
`static String`	`toUnicode(String input, int flag)`	Преобразует строку из ASCII Compatible Encoding (ACE) в Unicode, как определено операцией ToUnicode в RFC 3490.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

ALLOW_UNASSIGNED

public static final int ALLOW_UNASSIGNED

Флаг для разрешения обработки неназначенных кодовых точек

См. также:

USE_STD3_ASCII_RULES

public static final int USE_STD3_ASCII_RULES

Флаг для включения проверки по правилам STD-3 ASCII

См. также:

Подробное описание методов

toASCII

public static String toASCII(String input, int flag)

Преобразует строку из Unicode в ASCII-совместимое кодирование (ACE), как определено операцией ToASCII в RFC 3490.

Операция ToASCII может завершиться ошибкой. ToASCII завершается ошибкой, если любой шаг операции завершается ошибкой. Если операция ToASCII завершится ошибкой, будет выброшено исключение IllegalArgumentException. В этом случае входная строка не должна использоваться в международном доменном имени.

Метка — это отдельная часть доменного имени. Исходная операция ToASCII, как определено в RFC 3490, работает только с одной меткой. Этот метод может обрабатывать как метки, так и целые доменные имена, предполагая, что метки в доменном имени всегда разделены точками. Следующие символы распознаются как точки: \u002E (точка), \u3002 (идеографическая точка), \uFF0E (полная точка ширины), и \uFF61 (полуширинная идеографическая точка). Если точки используются в качестве разделителей меток, этот метод также изменяет все точки на \u002E (точку) в выходной преобразованной строке.

Параметры:

input - обрабатываемая строка

flag - флаг обработки; может быть 0 или любое логическое ИЛИ возможных флагов

Возвращает:

преобразованную String

Выбрасывает:

IllegalArgumentException - если входная строка не соответствует спецификации RFC 3490

Внешние спецификации

toASCII

public static String toASCII(String input)

Преобразует строку из Unicode в ASCII-совместимое кодирование (ACE), как определено операцией ToASCII в RFC 3490.

Этот удобный метод работает так, как если бы он вызывал двухаргументный аналог следующим образом:

toASCII(вход, 0);

Параметры:

input - обрабатываемая строка

Возвращает:

преобразованную String

Выбрасывает:

IllegalArgumentException - если входная строка не соответствует спецификации RFC 3490

Внешние спецификации

toUnicode

public static String toUnicode(String input, int flag)

Преобразует строку из ASCII-совместимого кодирования (ACE) в Unicode, как определено операцией ToUnicode в RFC 3490.

ToUnicode никогда не завершается ошибкой. В случае любой ошибки входная строка возвращается без изменений.

Метка — это отдельная часть доменного имени. Исходная операция ToUnicode, как определено в RFC 3490, работает только с одной меткой. Этот метод может обрабатывать как метки, так и целые доменные имена, предполагая, что метки в доменном имени всегда разделены точками.

Параметры:

input - обрабатываемая строка

flag - флаг обработки; может быть 0 или любое логическое ИЛИ возможных флагов

Возвращает:

преобразованную String

Внешние спецификации

toUnicode

public static String toUnicode(String input)

Преобразует строку из ASCII-совместимого кодирования (ACE) в Unicode, как определено операцией ToUnicode в RFC 3490.

Этот удобный метод работает так, как если бы он вызывал двухаргументный аналог следующим образом:

toUnicode(вход, 0);

Параметры:

input - обрабатываемая строка

Возвращает:

преобразованную String

Внешние спецификации

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/net/IDN.html