java.net

Класс IDN

java.lang. Объект

java.net. IDN

public final class IDN
extends Object

Обеспечивает методы, чтобы преобразовать интернационализировавшие доменные имена (IDNs) между нормальным представлением Unicode и ASCII Совместимое Кодирование (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. Это - ошибка, если они не удовлетворяют требования.

Этими флагами может быть логически OR'ed вместе.

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

С тех пор:

1.6

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	ALLOW_UNASSIGNED Флаг, чтобы позволить обрабатывать неприсвоенных кодовых точек
static int	USE_STD3_ASCII_RULES Флаг, чтобы включить проверку против STD 3 правила ASCII

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

Методы

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

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

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 (input, 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, только работает на единственной метке. Этот метод может обработать и метку и все доменное имя, предполагая, что метки на доменное имя всегда разделяются точками. Следующие символы распознаются как точки: \u002E (точка), \u3002 (идеографическая точка), \uFF0E (полноширинная точка), и \uFF61 (точка идеограммы полуширины).

Параметры:

input - строка, которая будет обработана

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

Возвраты:

преобразованный String

toUnicode

public static String toUnicode(String input)

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

Этот метод удобства работает как будто, вызывая дубликат с двумя параметрами следующим образом:

toUnicode (input, 0);

Параметры:

input - строка, которая будет обработана

Возвраты:

преобразованный String