OkHttp IDNA 映射表生成模块深度解析从 Unicode 原始数据到紧凑运行时表的构建工具链【免费下载链接】okhttpA meticulous HTTP client for the JVM, Android, and GraalVM.项目地址: https://gitcode.com/gh_mirrors/okh/okhttp导读本文聚焦 OkHttp 仓库中的okhttp-idna-mapping-table模块这是一个用于构建 IDNA国际化域名映射表的构建期支持工具其产物被 OkHttp 主模块在编译时消费用于生成面向 JVM、Android 与 GraalVM 的紧凑 IDNA 映射表运行时实现。读完本文你将掌握该模块在 OkHttp 整体架构中的定位、IdnaMappingTable.txt原始数据的解析格式、从简单映射表到三段式紧凑二进制表的压缩算法细节以及它如何通过 Gradle 任务接入 OkHttp 主模块的构建流程。模块定位一个不参与运行时执行的构建工具官方 README 对该模块的定位只有两句话却包含了关键信息This module contains supporting tools for building the IDNA mapping table. It is not required for runtime IDN mappings.即该模块包含构建 IDNA 映射表的支持工具运行时 IDN 映射并不依赖它。这明确了两个事实该模块是一个构建期build-time代码生成器不进入 OkHttp 的运行时发布物运行时真正执行的 IDN 映射逻辑在 OkHttp 主模块中由构建期生成的代码提供数据支撑。从构建配置可以印证这一点。settings.gradle.kts 中通过include(:okhttp-idna-mapping-table)将其纳入多模块工程而 okhttp/build.gradle.kts 中则定义了一个名为generateIdnaMappingTable的JavaExec任务val generateIdnaMappingTableConfiguration configurations.create(generateIdnaMappingTableConfiguration) dependencies { generateIdnaMappingTableConfiguration(projects.okhttpIdnaMappingTable) } val generateIdnaMappingTable tasks.registerJavaExec(generateIdnaMappingTable) { val idnaOutput layout.buildDirectory.dir(generated/sources/idnaMappingTable) outputs.dir(idnaOutput) mainClass.set(okhttp3.internal.idn.GenerateIdnaMappingTableCode) args(idnaOutput.get()) classpath generateIdnaMappingTableConfiguration }也就是说OkHttp 主模块在编译时通过JavaExec调用该模块的main函数入口类为okhttp3.internal.idn.GenerateIdnaMappingTableCode把生成的IdnaMappingTableInstance.kt写入build/generated/sources/idnaMappingTable目录再作为生成源码参与主模块编译。整个链路是构建期工具 → 生成紧凑表源码 → 编译进运行时。模块结构一览该模块规模很小源码组织非常清晰okhttp-idna-mapping-table/ ├── README.md └── src/ ├── main/ │ ├── kotlin/okhttp3/internal/idn/ │ │ ├── GenerateIdnaMappingTableCode.kt # 入口读取资源、生成 Kotlin 文件 │ │ ├── IdnaMappingTableData.kt # 生成产物的数据容器 │ │ ├── MappedRange.kt # 压缩后 range 的五种编码形态 │ │ ├── MappingTables.kt # 核心压缩算法 │ │ └── SimpleIdnaMappingTable.kt # 原始表解析器可读性优先 │ └── resources/okhttp3/internal/idna/ │ └── IdnaMappingTable.txt # Unicode 官方 UTS #46 数据 └── test/ └── kotlin/okhttp3/internal/idn/ └── MappingTablesTest.kt # 压缩算法单元测试其中IdnaMappingTable.txt是模块内置的原始数据资源共 9026 行头注释标明 Unicode IDNA Compatible Preprocessing for UTS #46, Version: 15.1.0日期 2023-08-10版权归 Unicode 所有也是整个生成链路的数据源头。输入数据读懂IdnaMappingTable.txtSimpleIdnaMappingTable.kt的文档注释SimpleIdnaMappingTable.kt详细解释了原始文件的格式注释行空行或以#开头的行行尾也可有注释全部被忽略普通行分号分隔的字段第一字段单个十六进制码点如0041或码点区间如0030..0039第二字段映射类型如valid、mapped含映射目标的行随后是十六进制码点序列如0031 2044 0034其余数据一律忽略。对照原始文件内容IdnaMappingTable.txt可以直观理解0000..002C ; disallowed_STD3_valid # 1.1 control-0000..COMMA 002D..002E ; valid # 1.1 HYPHEN-MINUS..FULL STOP 002F ; disallowed_STD3_valid # 1.1 SOLIDUS 0030..0039 ; valid # 1.1 DIGIT ZERO..DIGIT NINE 0041 ; mapped ; 0061 # 1.1 LATIN CAPITAL LETTER A例如0041 ; mapped ; 0061表示码点U0041大写 A映射到U0061小写 a。readPlainTextIdnaMappingTable()SimpleIdnaMappingTable.kt实现了解析它利用 Okio 的BufferedSource.select()按定界符.、空格、;、#、换行切分读取十六进制码点、可选的范围上界、映射类型以及映射目标序列最终产出SimpleIdnaMappingTable内部是一份按码点排序的Mapping列表。值得注意的语义选择见类注释 SimpleIdnaMappingTable.kt采用非过渡式non-transitional处理即保留偏差deviation字符STD3 规则配置为UseSTD3ASCIIRulesfalse因此允许_等字符。解析器将原始类型归类为七种常量SimpleIdnaMappingTable.ktTYPE_DEVIATION、TYPE_DISALLOWED、TYPE_DISALLOWED_STD3_MAPPED、TYPE_DISALLOWED_STD3_VALID、TYPE_IGNORED、TYPE_MAPPED、TYPE_VALID。生成入口从数据到 Kotlin 源码GenerateIdnaMappingTableCode.kt 的main函数是生成流程的起点fun main(vararg args: String) { val data loadIdnaMappingTableData() val file generateMappingTableFile(data) file.writeTo(File(args[0])) }流程为三步loadIdnaMappingTableData()从 classpath 资源/okhttp3/internal/idna/IdnaMappingTable.txt读取文本用readPlainTextIdnaMappingTable()解析为SimpleIdnaMappingTable再调用buildIdnaMappingTableData()压缩为紧凑三字符串结构generateMappingTableFile(data)借助KotlinPoet生成名为IdnaMappingTableInstance的 Kotlin 文件其中定义internal val IDNA_MAPPING_TABLE: IdnaMappingTable IdnaMappingTable( sections ..., ranges ..., mappings , )写盘写入args[0]指定的输出目录对应 Gradle 任务中的idnaOutput。IdnaMappingTableDataIdnaMappingTableData.kt就是承载这三段字符串sections、ranges、mappings的“食谱”容器。生成器还通过escapeDataString()GenerateIdnaMappingTableCode.kt对包含 NUL、BEL、DEL 及、$、\、·等特殊字符的字节做\uXXXX转义避免字符串字面量非法也省去运行时的trimMargin()开销。核心压缩算法如何把 90KB 文本压成三串 ASCII压缩的核心实现在 MappingTables.kt 的buildIdnaMappingTableData()。整个压缩分四步第一步合并相邻区间mergeAdjacentRanges()MappingTables.kt把相邻、类型相同、且映射目标相同的 Mapping 合并为一个更大区间同时canonicalizeType()MappingTables.kt做类型归一化disallowed_STD3_mapped并入mappeddeviation与disallowed_STD3_valid并入valid。测试simplifyCombinesMultipleMappings、simplifyCombinesCanonicalEquivalent验证了0x0233..0x0239三段valid被合并为一段见 MappingTablesTest.kt而映射目标不同的大写字母A→a、B→b不会被合并simplifyDoesNotCombineWhenMappedTargetsAreDifferent。第二步按 128 码点的 Section 切分withoutSectionSpans()MappingTables.kt把跨 Section 的区间拆开确保每个映射完全落在一个 Section 内。测试withSectionStartsSplits展示0x40000..0x40180被拆成0x40000..0x4007f、0x40080..0x400ff、0x40100..0x4017f、0x40180..0x40180四段。第三步为每个区间选择最紧凑的编码形态MappedRangeMappedRange.kt定义了五种区间形态sections()MappingTables.kt按以下优先级选择Constantignoredb1119、validb1120、disallowedb1121三种定值InlineDelta单码点映射到单码点、且差值绝对值 ≤0x3FFFF2^18-1时优先采用inlineDeltaOrNull()MappingTables.kt负责判定如U0041→U0061差值 0x20 即可用 3 字节表示Inline1映射目标为单字节b1122/123视目标字节高位而定Inline2映射目标为双字节b1124~127两个目标字节的高位组合决定具体值External映射目标超过两个字节时写入 mappings 池b1 记录长度≤63b2b3记录池内偏移。随后mergeAdjacentDeltaMappedRanges()MappingTables.kt再把相邻且差值相同的InlineDelta合并为单个条目连续区间共享同一差值。测试mergeAdjacentDeltaMappedRangesWithMultipleDeltas验证了三个差值为 5 的相邻 Delta 被压成一个。第四步序列化为三个缓冲区最终sections、ranges、mappings三串数据的格式在运行时表中有权威说明见下节Section 索引每项 4 字节2 字节前缀 2 字节范围偏移Ranges 数据每项 4 字节b0 起始码点 b1 决策 b2/b3 补充External 映射目标做字符串池去重相同的目标复用同一偏移。由于 b1 等字段刻意避开0x80位最终 sections 与 ranges 是纯 ASCII 字符串可直接作为 Kotlin 字符串字面量高效存储与索引。运行时消费方生成表的真实形态生成出的IdnaMappingTableInstance.kt被 OkHttp 主模块消费运行时类型为 IdnaMappingTable其文件头注释完整定义了三种数据的编码规范SectionsSection 索引约 1,240 字节每个码点被拆成 14 位前缀 7 位后缀同前缀的 128 个码点构成一个 Section每项 4 字节b0b1s7 (b0 14) (b1 7)是 Section 前缀省略某 Section 表示其 ranges 与前一节完全相同b2b3s2 (b2 9) (b3 2)是 ranges 数据偏移因 4 字节对齐而左移 2 位Ranges约 32,612 字节每项 4 字节b0~b3b0 是区间起始码点低 7 位区间终点通过下一条目起始位置推断b1 决定映射语义——0..63表示映射目标长度为 b1、偏移为b2b364..79/80..95表示负/正码点增量增量 (b10xF)14 | b27 | b3119/120/121分别表示 ignored/valid/disallowed122~127表示 1~2 字节的内联映射b2a b20x80、b3a b30x80用于表示含高位的字节Mappings约 4,719 字节UTF-8 字符池供b2b3索引可重叠。运行时查询在IdnaMappingTable.map(codePoint, sink)IdnaMappingTable.kt中完成先用findSectionsIndex()按码点高 14 位二分查找 Section再用findRangesOffset()按低 7 位在 Section 的 ranges 区间内二分查找条目最后按 b1 的语义写出映射结果。二分查找使用通用实现binarySearch()IdnaMappingTable.kt未命中时返回(-1 - insertionPoint)由调用方回退到前一条目。这与生成侧MappedRange的 b1 取值119/120/121/122~127、64~95 区间完全一一对应是“生成器—运行时”严格对偶的明证。该运行时实现与生成工具中的SimpleIdnaMappingTable.map()SimpleIdnaMappingTable.kt保持相同的映射语义ignored不输出、mapped写映射目标、valid/deviation原样输出、disallowed输出并返回false。两者一为可读性优先的“参考实现”一为紧凑化的“运行时实现”共同构成 IDN 映射的两面。测试验证压缩算法正确性的保障MappingTablesTest.kt 使用 assertk 与 JUnit 5 对压缩的每个环节做了针对性验证区间合并simplifyCombinesMultipleMappings、simplifyCombinesCanonicalEquivalent含类型归一化、simplifyDoesNotCombineWhenMappedTargetsAreDifferentSection 切分withSectionStartsSplits、withSectionStartAlreadySplitDelta 合并mergeAdjacentDeltaMappedRangesWithMultipleDeltas、mergeAdjacentDeltaMappedRangesWithDifferentSizedDeltasDelta 编码判定inlineDeltaOrNullValid正负差值、inlineDeltaOrNullMultipleSourceCodePoints多源码点不可用、inlineDeltaOrNullMultipleMappedToCodePoints多目标不可用、inlineDeltaOrNullMaxCodepointDelta2^18-1为上限2^18超限返回 null。这些测试覆盖了压缩算法的主要边界条件为生成器的正确性提供了可回归的保障。总结okhttp-idna-mapping-table是 OkHttp 仓库中一个典型而精炼的“构建期代码生成器”模块它以 Unicode 官方 UTS #46 的IdnaMappingTable.txt15.1.0为输入经过区间合并、Section 切分、五种编码形态选择与字符串池去重等压缩步骤产出约 38KB 的紧凑 ASCII 字符串源码并通过generateIdnaMappingTableGradle 任务在编译期注入 OkHttp 主模块最终由IdnaMappingTable以二分查找方式在运行时高效执行 IDN 码点映射。该模块本身不参与运行时却是 OkHttp 国际化域名处理能力的数据工厂理解它有助于读者把握 OkHttp IDN 功能的完整数据链路与压缩设计思想。延伸阅读模块入口与生成逻辑GenerateIdnaMappingTableCode.kt压缩算法主体MappingTables.kt原始表解析器SimpleIdnaMappingTable.kt运行时紧凑表IdnaMappingTable.kt压缩算法测试MappingTablesTest.kt生成任务接入配置okhttp/build.gradle.kts【免费下载链接】okhttpA meticulous HTTP client for the JVM, Android, and GraalVM.项目地址: https://gitcode.com/gh_mirrors/okh/okhttp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OkHttp IDNA 映射表生成模块深度解析：从 Unicode 原始数据到紧凑运行时表的构建工具链
OkHttp IDNA 映射表生成模块深度解析从 Unicode 原始数据到紧凑运行时表的构建工具链【免费下载链接】okhttpA meticulous HTTP client for the JVM, Android, and GraalVM.项目地址: https://gitcode.com/gh_mirrors/okh/okhttp导读本文聚焦 OkHttp 仓库中的okhttp-idna-mapping-table模块这是一个用于构建 IDNA国际化域名映射表的构建期支持工具其产物被 OkHttp 主模块在编译时消费用于生成面向 JVM、Android 与 GraalVM 的紧凑 IDNA 映射表运行时实现。读完本文你将掌握该模块在 OkHttp 整体架构中的定位、IdnaMappingTable.txt原始数据的解析格式、从简单映射表到三段式紧凑二进制表的压缩算法细节以及它如何通过 Gradle 任务接入 OkHttp 主模块的构建流程。模块定位一个不参与运行时执行的构建工具官方 README 对该模块的定位只有两句话却包含了关键信息This module contains supporting tools for building the IDNA mapping table. It is not required for runtime IDN mappings.即该模块包含构建 IDNA 映射表的支持工具运行时 IDN 映射并不依赖它。这明确了两个事实该模块是一个构建期build-time代码生成器不进入 OkHttp 的运行时发布物运行时真正执行的 IDN 映射逻辑在 OkHttp 主模块中由构建期生成的代码提供数据支撑。从构建配置可以印证这一点。settings.gradle.kts 中通过include(:okhttp-idna-mapping-table)将其纳入多模块工程而 okhttp/build.gradle.kts 中则定义了一个名为generateIdnaMappingTable的JavaExec任务val generateIdnaMappingTableConfiguration configurations.create(generateIdnaMappingTableConfiguration) dependencies { generateIdnaMappingTableConfiguration(projects.okhttpIdnaMappingTable) } val generateIdnaMappingTable tasks.registerJavaExec(generateIdnaMappingTable) { val idnaOutput layout.buildDirectory.dir(generated/sources/idnaMappingTable) outputs.dir(idnaOutput) mainClass.set(okhttp3.internal.idn.GenerateIdnaMappingTableCode) args(idnaOutput.get()) classpath generateIdnaMappingTableConfiguration }也就是说OkHttp 主模块在编译时通过JavaExec调用该模块的main函数入口类为okhttp3.internal.idn.GenerateIdnaMappingTableCode把生成的IdnaMappingTableInstance.kt写入build/generated/sources/idnaMappingTable目录再作为生成源码参与主模块编译。整个链路是构建期工具 → 生成紧凑表源码 → 编译进运行时。模块结构一览该模块规模很小源码组织非常清晰okhttp-idna-mapping-table/ ├── README.md └── src/ ├── main/ │ ├── kotlin/okhttp3/internal/idn/ │ │ ├── GenerateIdnaMappingTableCode.kt # 入口读取资源、生成 Kotlin 文件 │ │ ├── IdnaMappingTableData.kt # 生成产物的数据容器 │ │ ├── MappedRange.kt # 压缩后 range 的五种编码形态 │ │ ├── MappingTables.kt # 核心压缩算法 │ │ └── SimpleIdnaMappingTable.kt # 原始表解析器可读性优先 │ └── resources/okhttp3/internal/idna/ │ └── IdnaMappingTable.txt # Unicode 官方 UTS #46 数据 └── test/ └── kotlin/okhttp3/internal/idn/ └── MappingTablesTest.kt # 压缩算法单元测试其中IdnaMappingTable.txt是模块内置的原始数据资源共 9026 行头注释标明 Unicode IDNA Compatible Preprocessing for UTS #46, Version: 15.1.0日期 2023-08-10版权归 Unicode 所有也是整个生成链路的数据源头。输入数据读懂IdnaMappingTable.txtSimpleIdnaMappingTable.kt的文档注释SimpleIdnaMappingTable.kt详细解释了原始文件的格式注释行空行或以#开头的行行尾也可有注释全部被忽略普通行分号分隔的字段第一字段单个十六进制码点如0041或码点区间如0030..0039第二字段映射类型如valid、mapped含映射目标的行随后是十六进制码点序列如0031 2044 0034其余数据一律忽略。对照原始文件内容IdnaMappingTable.txt可以直观理解0000..002C ; disallowed_STD3_valid # 1.1 control-0000..COMMA 002D..002E ; valid # 1.1 HYPHEN-MINUS..FULL STOP 002F ; disallowed_STD3_valid # 1.1 SOLIDUS 0030..0039 ; valid # 1.1 DIGIT ZERO..DIGIT NINE 0041 ; mapped ; 0061 # 1.1 LATIN CAPITAL LETTER A例如0041 ; mapped ; 0061表示码点U0041大写 A映射到U0061小写 a。readPlainTextIdnaMappingTable()SimpleIdnaMappingTable.kt实现了解析它利用 Okio 的BufferedSource.select()按定界符.、空格、;、#、换行切分读取十六进制码点、可选的范围上界、映射类型以及映射目标序列最终产出SimpleIdnaMappingTable内部是一份按码点排序的Mapping列表。值得注意的语义选择见类注释 SimpleIdnaMappingTable.kt采用非过渡式non-transitional处理即保留偏差deviation字符STD3 规则配置为UseSTD3ASCIIRulesfalse因此允许_等字符。解析器将原始类型归类为七种常量SimpleIdnaMappingTable.ktTYPE_DEVIATION、TYPE_DISALLOWED、TYPE_DISALLOWED_STD3_MAPPED、TYPE_DISALLOWED_STD3_VALID、TYPE_IGNORED、TYPE_MAPPED、TYPE_VALID。生成入口从数据到 Kotlin 源码GenerateIdnaMappingTableCode.kt 的main函数是生成流程的起点fun main(vararg args: String) { val data loadIdnaMappingTableData() val file generateMappingTableFile(data) file.writeTo(File(args[0])) }流程为三步loadIdnaMappingTableData()从 classpath 资源/okhttp3/internal/idna/IdnaMappingTable.txt读取文本用readPlainTextIdnaMappingTable()解析为SimpleIdnaMappingTable再调用buildIdnaMappingTableData()压缩为紧凑三字符串结构generateMappingTableFile(data)借助KotlinPoet生成名为IdnaMappingTableInstance的 Kotlin 文件其中定义internal val IDNA_MAPPING_TABLE: IdnaMappingTable IdnaMappingTable( sections ..., ranges ..., mappings , )写盘写入args[0]指定的输出目录对应 Gradle 任务中的idnaOutput。IdnaMappingTableDataIdnaMappingTableData.kt就是承载这三段字符串sections、ranges、mappings的“食谱”容器。生成器还通过escapeDataString()GenerateIdnaMappingTableCode.kt对包含 NUL、BEL、DEL 及、$、\、·等特殊字符的字节做\uXXXX转义避免字符串字面量非法也省去运行时的trimMargin()开销。核心压缩算法如何把 90KB 文本压成三串 ASCII压缩的核心实现在 MappingTables.kt 的buildIdnaMappingTableData()。整个压缩分四步第一步合并相邻区间mergeAdjacentRanges()MappingTables.kt把相邻、类型相同、且映射目标相同的 Mapping 合并为一个更大区间同时canonicalizeType()MappingTables.kt做类型归一化disallowed_STD3_mapped并入mappeddeviation与disallowed_STD3_valid并入valid。测试simplifyCombinesMultipleMappings、simplifyCombinesCanonicalEquivalent验证了0x0233..0x0239三段valid被合并为一段见 MappingTablesTest.kt而映射目标不同的大写字母A→a、B→b不会被合并simplifyDoesNotCombineWhenMappedTargetsAreDifferent。第二步按 128 码点的 Section 切分withoutSectionSpans()MappingTables.kt把跨 Section 的区间拆开确保每个映射完全落在一个 Section 内。测试withSectionStartsSplits展示0x40000..0x40180被拆成0x40000..0x4007f、0x40080..0x400ff、0x40100..0x4017f、0x40180..0x40180四段。第三步为每个区间选择最紧凑的编码形态MappedRangeMappedRange.kt定义了五种区间形态sections()MappingTables.kt按以下优先级选择Constantignoredb1119、validb1120、disallowedb1121三种定值InlineDelta单码点映射到单码点、且差值绝对值 ≤0x3FFFF2^18-1时优先采用inlineDeltaOrNull()MappingTables.kt负责判定如U0041→U0061差值 0x20 即可用 3 字节表示Inline1映射目标为单字节b1122/123视目标字节高位而定Inline2映射目标为双字节b1124~127两个目标字节的高位组合决定具体值External映射目标超过两个字节时写入 mappings 池b1 记录长度≤63b2b3记录池内偏移。随后mergeAdjacentDeltaMappedRanges()MappingTables.kt再把相邻且差值相同的InlineDelta合并为单个条目连续区间共享同一差值。测试mergeAdjacentDeltaMappedRangesWithMultipleDeltas验证了三个差值为 5 的相邻 Delta 被压成一个。第四步序列化为三个缓冲区最终sections、ranges、mappings三串数据的格式在运行时表中有权威说明见下节Section 索引每项 4 字节2 字节前缀 2 字节范围偏移Ranges 数据每项 4 字节b0 起始码点 b1 决策 b2/b3 补充External 映射目标做字符串池去重相同的目标复用同一偏移。由于 b1 等字段刻意避开0x80位最终 sections 与 ranges 是纯 ASCII 字符串可直接作为 Kotlin 字符串字面量高效存储与索引。运行时消费方生成表的真实形态生成出的IdnaMappingTableInstance.kt被 OkHttp 主模块消费运行时类型为 IdnaMappingTable其文件头注释完整定义了三种数据的编码规范SectionsSection 索引约 1,240 字节每个码点被拆成 14 位前缀 7 位后缀同前缀的 128 个码点构成一个 Section每项 4 字节b0b1s7 (b0 14) (b1 7)是 Section 前缀省略某 Section 表示其 ranges 与前一节完全相同b2b3s2 (b2 9) (b3 2)是 ranges 数据偏移因 4 字节对齐而左移 2 位Ranges约 32,612 字节每项 4 字节b0~b3b0 是区间起始码点低 7 位区间终点通过下一条目起始位置推断b1 决定映射语义——0..63表示映射目标长度为 b1、偏移为b2b364..79/80..95表示负/正码点增量增量 (b10xF)14 | b27 | b3119/120/121分别表示 ignored/valid/disallowed122~127表示 1~2 字节的内联映射b2a b20x80、b3a b30x80用于表示含高位的字节Mappings约 4,719 字节UTF-8 字符池供b2b3索引可重叠。运行时查询在IdnaMappingTable.map(codePoint, sink)IdnaMappingTable.kt中完成先用findSectionsIndex()按码点高 14 位二分查找 Section再用findRangesOffset()按低 7 位在 Section 的 ranges 区间内二分查找条目最后按 b1 的语义写出映射结果。二分查找使用通用实现binarySearch()IdnaMappingTable.kt未命中时返回(-1 - insertionPoint)由调用方回退到前一条目。这与生成侧MappedRange的 b1 取值119/120/121/122~127、64~95 区间完全一一对应是“生成器—运行时”严格对偶的明证。该运行时实现与生成工具中的SimpleIdnaMappingTable.map()SimpleIdnaMappingTable.kt保持相同的映射语义ignored不输出、mapped写映射目标、valid/deviation原样输出、disallowed输出并返回false。两者一为可读性优先的“参考实现”一为紧凑化的“运行时实现”共同构成 IDN 映射的两面。测试验证压缩算法正确性的保障MappingTablesTest.kt 使用 assertk 与 JUnit 5 对压缩的每个环节做了针对性验证区间合并simplifyCombinesMultipleMappings、simplifyCombinesCanonicalEquivalent含类型归一化、simplifyDoesNotCombineWhenMappedTargetsAreDifferentSection 切分withSectionStartsSplits、withSectionStartAlreadySplitDelta 合并mergeAdjacentDeltaMappedRangesWithMultipleDeltas、mergeAdjacentDeltaMappedRangesWithDifferentSizedDeltasDelta 编码判定inlineDeltaOrNullValid正负差值、inlineDeltaOrNullMultipleSourceCodePoints多源码点不可用、inlineDeltaOrNullMultipleMappedToCodePoints多目标不可用、inlineDeltaOrNullMaxCodepointDelta2^18-1为上限2^18超限返回 null。这些测试覆盖了压缩算法的主要边界条件为生成器的正确性提供了可回归的保障。总结okhttp-idna-mapping-table是 OkHttp 仓库中一个典型而精炼的“构建期代码生成器”模块它以 Unicode 官方 UTS #46 的IdnaMappingTable.txt15.1.0为输入经过区间合并、Section 切分、五种编码形态选择与字符串池去重等压缩步骤产出约 38KB 的紧凑 ASCII 字符串源码并通过generateIdnaMappingTableGradle 任务在编译期注入 OkHttp 主模块最终由IdnaMappingTable以二分查找方式在运行时高效执行 IDN 码点映射。该模块本身不参与运行时却是 OkHttp 国际化域名处理能力的数据工厂理解它有助于读者把握 OkHttp IDN 功能的完整数据链路与压缩设计思想。延伸阅读模块入口与生成逻辑GenerateIdnaMappingTableCode.kt压缩算法主体MappingTables.kt原始表解析器SimpleIdnaMappingTable.kt运行时紧凑表IdnaMappingTable.kt压缩算法测试MappingTablesTest.kt生成任务接入配置okhttp/build.gradle.kts【免费下载链接】okhttpA meticulous HTTP client for the JVM, Android, and GraalVM.项目地址: https://gitcode.com/gh_mirrors/okh/okhttp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考