树叶云鸿蒙OS教程:鸿蒙OS IDN

IDN

java.lang.Object

|—java.net.IDN

public final class IDN
extends Object

提供在普通 Unicode 表示和 ASCII 兼容编码 (ACE) 表示之间转换国际化域名 (IDN) 的方法。 国际化域名可以使用整个 Unicode 范围内的字符,而传统域名仅限于 ASCII 字符。 ACE 是一种仅使用 ASCII 字符的 Unicode 字符串编码,可以与只理解传统域名的软件(例如域名系统)一起使用。

国际化域名在 RFC 3490 中定义。RFC 3490 定义了两种操作:ToASCII 和 ToUnicode。 这两个操作使用 Nameprep 算法,它是 Stringprep 的一个配置文件,以及 Punycode 算法来来回转换域名字符串。

上述转换过程的行为可以通过各种标志进行调整:

  • 如果使用 ALLOW_UNASSIGNED 标志,则要转换的域名字符串可以包含在 Unicode 3.2 中未分配的代码点,这是 IDN 转换所基于的 Unicode 版本。 如果未使用该标志,则将此类未分配代码点的存在视为错误。
  • 如果使用 USE_STD3_ASCII_RULES 标志,则对照 RFC 1122 和 RFC 1123 检查 ASCII 字符串。如果它们不符合要求,则会出错。

这些标志可以逻辑或在一起。

安全考虑对于国际化域名支持很重要。 例如,英文域名可能是同形异义词——通过替换非拉丁字母而恶意拼写错误。 Unicode 技术报告 #36 讨论了 IDN 支持的安全问题以及可能的解决方案。 应用程序有责任在使用国际域名时采取足够的安全措施。

字段摘要

修饰符和类型字段描述
static intALLOW_UNASSIGNED允许处理未分配代码点的标志
static intUSE_STD3_ASCII_RULES标记以打开对 STD-3 ASCII 规则的检查

方法总结

修饰符和类型方法描述
static StringtoASCII(String input)将字符串从 Unicode 转换为 ASCII 兼容编码 (ACE),由 RFC 3490 的 ToASCII 操作定义。
static StringtoASCII(String input, int flag)将字符串从 Unicode 转换为 ASCII 兼容编码 (ACE),由 RFC 3490 的 ToASCII 操作定义。
static StringtoUnicode(String input)将字符串从 ASCII 兼容编码 (ACE) 转换为 Unicode,由 RFC 3490 的 ToUnicode 操作定义。
static StringtoUnicode(String input, int flag)将字符串从 ASCII 兼容编码 (ACE) 转换为 Unicode,由 RFC 3490 的 ToUnicode 操作定义。
从类 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),由 RFC 3490 的 ToASCII 操作定义。

ToASCII 操作可能会失败。 如果任何步骤失败,ToASCII 就会失败。 如果 ToASCII 操作失败,将抛出 IllegalArgumentException。 在这种情况下,不应在国际化域名中使用输入字符串。

标签是域名的独立部分。 RFC 3490 中定义的原始 ToASCII 操作仅对单个标签进行操作。 该方法可以处理标签和整个域名,假设域名中的标签总是用点分隔。 以下字符被识别为点:\u002E(句号)、\u3002(表意句号)、\uFF0E(全角句号)和\uFF61(半角表意句号)。 如果将点用作标签分隔符,则此方法还将在输出翻译字符串中将它们全部更改为 \u002E(句号)。

参数:

参数名称参数描述
input要处理的字符串
flag进程标志; 可以是 0 或可能标志的任何逻辑或

返回:

翻译后的字符串

Throws:

Throw名称Throw描述
IllegalArgumentException如果输入字符串不符合 RFC 3490 规范

toASCII

public static String toASCII(String input)

将字符串从 Unicode 转换为 ASCII 兼容编码 (ACE),由 RFC 3490 的 ToASCII 操作定义。

这种方便的方法就像通过调用两个参数对应物一样工作,如下所示:

toASCII(input, 0);

参数:

参数名称参数描述
input要处理的字符串

返回:

翻译后的字符串

Throws:

Throw名称Throw描述
IllegalArgumentException如果输入字符串不符合 RFC 3490 规范

toUnicode

public static String toUnicode(String input, int flag)

将字符串从 ASCII 兼容编码 (ACE) 转换为 Unicode,由 RFC 3490 的 ToUnicode 操作定义。

ToUnicode 永远不会失败。 如果出现任何错误,输入字符串将不加修改地返回。

标签是域名的独立部分。 RFC 3490 中定义的原始 ToUnicode 操作仅对单个标签进行操作。 该方法可以处理标签和整个域名,假设域名中的标签总是用点分隔。 以下字符被识别为点:\u002E(句号)、\u3002(表意句号)、\uFF0E(全角句号)和\uFF61(半角表意句号)。

参数:

参数名称参数描述
input要处理的字符串
flag进程标志; 可以是 0 或可能标志的任何逻辑或

返回:

翻译后的字符串

toUnicode

public static String toUnicode(String input)

将字符串从 ASCII 兼容编码 (ACE) 转换为 Unicode,由 RFC 3490 的 ToUnicode 操作定义。

这种方便的方法就像通过调用两个参数对应物一样工作,如下所示:

toUnicode(input, 0);

参数:

参数名称参数描述
input要处理的字符串

返回:

翻译后的字符串

文章来源网络,作者:运维,如若转载,请注明出处:https://shuyeidc.com/wp/191530.html<

(0)
运维的头像运维
上一篇2025-04-01 04:18
下一篇 2025-04-01 04:20

相关推荐

  • 个人主题怎么制作?

    制作个人主题是一个将个人风格、兴趣或专业领域转化为视觉化或结构化内容的过程,无论是用于个人博客、作品集、社交媒体账号还是品牌形象,核心都是围绕“个人特色”展开,以下从定位、内容规划、视觉设计、技术实现四个维度,详细拆解制作个人主题的完整流程,明确主题定位:找到个人特色的核心主题定位是所有工作的起点,需要先回答……

    2025-11-20
    0
  • 社群营销管理关键是什么?

    社群营销的核心在于通过建立有温度、有价值、有归属感的社群,实现用户留存、转化和品牌传播,其管理需贯穿“目标定位-内容运营-用户互动-数据驱动-风险控制”全流程,以下从五个维度展开详细说明:明确社群定位与目标社群管理的首要任务是精准定位,需明确社群的核心价值(如行业交流、产品使用指导、兴趣分享等)、目标用户画像……

    2025-11-20
    0
  • 香港公司网站备案需要什么材料?

    香港公司进行网站备案是一个涉及多部门协调、流程相对严谨的过程,尤其需兼顾中国内地与香港两地的监管要求,由于香港公司注册地与中国内地不同,其网站若主要服务内地用户或使用内地服务器,需根据服务器位置、网站内容性质等,选择对应的备案路径(如工信部ICP备案或公安备案),以下从备案主体资格、流程步骤、材料准备、注意事项……

    2025-11-20
    0
  • 如何企业上云推广

    企业上云已成为数字化转型的核心战略,但推广过程中需结合行业特性、企业痛点与市场需求,构建系统性、多维度的推广体系,以下从市场定位、策略设计、执行落地及效果优化四个维度,详细拆解企业上云推广的实践路径,精准定位:明确目标企业与核心价值企业上云并非“一刀切”的方案,需先锁定目标客户群体,提炼差异化价值主张,客户分层……

    2025-11-20
    0
  • PS设计搜索框的实用技巧有哪些?

    在PS中设计一个美观且功能性的搜索框需要结合创意构思、视觉设计和用户体验考量,以下从设计思路、制作步骤、细节优化及交互预览等方面详细说明,帮助打造符合需求的搜索框,设计前的规划明确使用场景:根据网站或APP的整体风格确定搜索框的调性,例如极简风适合细线条和纯色,科技感适合渐变和发光效果,电商类则可能需要突出搜索……

    2025-11-20
    0

发表回复

您的邮箱地址不会被公开。必填项已用 * 标注