compact1, compact2, compact3

java.net

Class IDN

java.lang.Object

java.net.IDN

public final class IDN
extends Object

提供将国际化域名（IDN）方法正常的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 -恶意拼错的非拉丁字母取代。Unicode Technical Report #36讨论支持IDN的安全问题以及可能的解决方案。应用程序负责在使用国际域名时采取适当的安全措施。

从以下版本开始：

一点六

Field Summary

Fields

Modifier and Type	Field and Description
static int	ALLOW_UNASSIGNED 允许指定的代码点处理标识
static int	USE_STD3_ASCII_RULES 把对ASCII规则STD-3检查标志

方法摘要

Modifier and Type	Method and Description
static String	toASCII(String input) 将一个字符串从Unicode字符的ASCII兼容编码（ACE），由 RFC 3490的toascii操作定义。
static String	toASCII(String input, int flag) 将一个字符串从Unicode字符的ASCII兼容编码（ACE），由 RFC 3490的toascii操作定义。
static String	toUnicode(String input) 翻译成ASCII兼容的编码为Unicode字符串（ACE），由 RFC 3490的tounicode操作定义。
static String	toUnicode(String input, int flag) 翻译成ASCII兼容的编码为Unicode字符串（ACE），由 RFC 3490的tounicode操作定义。

Methods inherited from class java.lang.Object

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

Field Detail

ALLOW_UNASSIGNED

public static final int ALLOW_UNASSIGNED

允许指定的代码点处理标识

另请参见：

Constant Field Values

USE_STD3_ASCII_RULES

public static final int USE_STD3_ASCII_RULES

把对ASCII规则STD-3检查标志

另请参见：

Constant Field Values

方法详细信息

toASCII

public static String toASCII(String input,
                             int flag)

将一个字符串从Unicode字符的ASCII兼容编码（ACE），由 RFC 3490的toascii操作定义。

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），由 RFC 3490的toascii操作定义。

这种方便的方法的工作原理，如果通过调用两个参数对应如下：

toASCII(input, 0);

参数

input -待处理的字符串

结果

翻译 String

异常

IllegalArgumentException -如果输入字符串不符合RFC 3490规范

toUnicode

public static String toUnicode(String input,
                               int flag)

翻译成ASCII兼容的编码为Unicode字符串（ACE），由 RFC 3490的tounicode

tounicode永不失败。在任何错误的情况下，输入字符串返回未修改的。

标签是域名的一个单独的部分。原tounicode操作，RFC 3490中定义的，只有运行在一个单一的标签。这种方法可以处理两个标签和整个域名，假设标签在一个域名总是分开的点。下面的文字是公认的点：\ u002e（句号），\ u3002（表意的句号），\ uff0e（全角的句号），和uff61（半角表意的句号）。

操作定义。

参数

input -待处理的字符串

flag过程标志；可以是0或任何逻辑的或可能的旗帜

结果

翻译 String

toUnicode

public static String toUnicode(String input)

翻译成ASCII兼容的编码为Unicode字符串（ACE），由 RFC 3490的tounicode操作定义。

这种方便的方法的工作原理，如果通过调用两个参数对应如下：

toUnicode(input, 0);

参数

input -待处理的字符串

结果

翻译 String