ZJSON1.6[易语言源码]

ZJSON1.6易语言源码概述
ZJSON v1.6 是一次具有里程碑意义的重大架构升级，性能迎来巨大提升。在延续 v1.5 “纯汇编底层驱动、高吞吐、零内存冗余”的设计哲学基础上，v1.6 重点解决了高并发多线程场景下的重入竞争问题，重构了底层哈希索引拓扑，并原生引入了全汇编数据压缩/解压引擎（GZIP/ZLIB/Deflate）、全汇编正则表达式引擎、对象与数组多模式排序以及 Python 风格负数索引，彻底摆脱外部依赖，打造兼具极致性能与工业级稳定性的易语言 JSON 模块。

一、 核心架构重构与底层机制演进
1. 同步锁模型重构：由 SRWLock 全面迁移至 Win32 临界区 (CriticalSection)
背景与痛点：v1.5 采用基于 Windows API 的 SRWLock（读写锁），并通过手动记录线程 ID 与嵌套计数模拟递归写锁，在复杂高并发环境、读锁向写锁切换或异常析构时易产生死锁与竞争状态。
架构升级：
v1.6 彻底废弃 SRWLock 模拟实现，将对象级同步机制重构为标准的 Win32 CRITICAL_SECTION 临界区对象（固定分配 24 字节结构），由系统内核调度器原生支持线程重入。
封装统一的汇编跳板 Asm_Lock_Op，直接承接 EnterCriticalSection 与 LeaveCriticalSection，平抑锁调用开销，彻底杜绝多线程环境下的崩溃与死锁隐患。
2. 哈希表拓扑重构：绝对指针升级为相对偏移寻址 + 动态平滑 Rehash
相对偏移寻址：
v1.5 哈希桶直接记录缓冲区的绝对物理内存指针。当底层缓冲区因写入扩容触发重分配（realloc）后，所有绝对指针即刻失效，必须强制全量重建哈希索引。
v1.6 哈希节点改用相对于缓冲区基址 m_BufPtr 的 相对偏移量（Relative Offset） 记录。当缓冲区扩容地址迁移时，哈希节点记录的相对偏移依然保持绝对有效，极大降低了脏索引触发频率。
动态自动扩容 (Auto Rehash)：
新增底层子程序 哈希表_自动扩容 与汇编级 Asm_HashMap_Rehash。
当节点内存池达到负载阈值时，哈希表自动倍增桶数（最大支持 1,048,576 桶）并原位重哈希，避免哈希冲突剧增导致的性能降级。
3. 复合路径高速查询缓存 (Path Cache)
在原有点对点数组索引缓存（m_QC_Slots）基础上，v1.6 新增了 128 槽位的复合路径高速查询缓存（m_PC_Slots，16KB 专用物理槽）。
结合 Asm_PathCache_Get 与 Asm_PathCache_Put，深度嵌套路径（如 a.b.c[2].d）在首次检索后直接命中缓存偏移，避免重复执行路径词法分割与线性扫描。
4. 零堆分配截断技术 (Zero-Allocation In-Place Truncation)
痛点消除：以往在处理字符串提取、Hex/Base64 编解码或 JSON 紧凑输出时，频繁调用易语言核心库的 取文本左边 或 取字节集左边，会产生海量微小内存块的堆申请与释放。
底层实现：
新增汇编级 Asm_截断文本：直接在目标字符串末尾写入 终止符。
新增汇编级 Asm_截断字节集：直接修改易语言字节集结构头部的长度字段（[pBin – 4] = new_len），无需重新申请堆空间，内存分配开销降至极限。
二、 全新功能与扩展模块
1. 纯汇编数据压缩 / 解压引擎 (GZIP / ZLIB / Deflate)
无需携带任何第三方 DLL（如 zlibwapi.dll），完全由底层 x86 汇编独立实现：

编码_数据解压 (参_压缩数据)：
自动识别输入数据头：智能区分 GZIP（Magic: 0x1F8B08）、ZLIB（Header: 0x789C）及 Raw Deflate 裸流。
具备 GZIP 尾部 ISIZE 自动预估与容量动态重试扩张机制，支持解压超大载荷。
编码_数据压缩 (参_原始数据, 参_压缩格式)：
支持指定格式写出：1 = GZIP（包含 10 字节标准头、Deflate 压缩块、CRC32 校验码与原始长度尾部），2 = Raw Deflate，3 = ZLIB（包含 Adler32 校验）。
底层支持：内置高效 LZ77 哈希链匹配与定态/动态 Huffman 树构建汇编子程序（Asm_DeflateDecompress、Asm_DeflateCompress、Asm_Calc_CRC32、Asm_Calc_Adler32）。
2. 纯汇编通用正则表达式引擎
脱离系统 VBScript 正则对象与 PCRE.dll，在模块内封装全汇编正则匹配器：

核心方法：
正则_匹配：快速检测文本是否命中规则。
正则_提取：提取首个匹配到的子字符串。
正则_提取_位置：传回 1-based 匹配起始位置与字节长度。
正则_提取_所有：批量提取全部命中项至文本数组。
正则_分割：以正则为分隔符切分文本为字符串数组。
正则_替换 / 正则_替换_文本：就地节点写回或返回替换后文本。
语法支持：
锚点匹配：^、$
元字符与字符类：.、d、D、w、W、s、S、 、
、
集合与排除：[…]、[^…]、字符区间 a-z
量词：贪婪与非贪婪 *、*?、+、+?、?、??、{n}、{n,}、{n,m}、{n,m}?
模式修饰：支持忽略大小写修饰符 (?i)
3. 工业级 JSON 排序引擎 (Sort Engine)
对象_排序：
支持按键名进行字典序排序（A-Z 升序 / Z-A 降序）。
支持设置是否区分大小写。
支持 递归排序 参数，一键对多层深度嵌套的所有子对象展开递归整理。
数组_排序：
支持标量数组（字符串、数值）自身排序。
支持对象数组按内部指定键名（如 users[].age）提取字段排序。
支持字符字典序与 64 位双精度浮点数值大小（Double）比较模式。
底层机制：基于 Asm_Sort_Entries 原生汇编快速排序（Quicksort）与两路指针内存重排，排序过程无额外字符串冗余创建。
4. Python 风格负数索引 (Negative Indexing)
全面支持负数下标：-1 表示末尾最后一个元素，-2 表示倒数第二个元素，以此类推。
覆盖全部数组接口与路径解析引擎：
取数组成员_文本(…, -1)
取数组成员_整数(…, -1)
数组_置成员_*(…, -1, …)
数组_删除成员(…, -1)
路径字符串原生支持，如 “items[-1].title”。
5. 路径语法与动态建树增强
追加语法：支持直接使用 arr[] 或 arr[+] 自动在数组末尾追加元素，无需预先查询数组长度。
缺失树自动推导：_智能构建缺失树 升级，当中间路径跨越未初始化的节点时，自动智能判定容器类型（对象 {} 或数组 []），并完成结构补齐。
原位复用优化：当覆写的值长度小于原有节点与后方空白的总容量时，采用原地覆写并在尾部填充空格，避免触发全量内存搬移。
6. 新增工具型 API
是否为空：安全探测当前容器是否为空（支持 {}、[] 及空对象）。
编码_UTF8指针到ANSI：直接接收裸内存物理指针与长度进行 ANSI 转码，消除中转字节集开销。
三、 底层指令集与性能调优
单遍扫描属性探测 (Asm_Scan_Key_Attributes)：
将“计算 ROL7 哈希值”、“探测是否纯 ASCII”以及“检测是否包含点号/中括号复合路径”三道原本分散的循环逻辑合而为一，在一次内存遍历中同时产出三大元数据，显著降低热点路径开销。
核心字符串函数汇编重写：
彻底移除了对易语言核心支持库基础字符串函数的依赖，改由汇编直接接管：
取文本长度：集成 4 字节对其的 PAGE-SAFE 零字符探测算法。
寻找文本：针对短文本与长文本采用优化扫描步进。
文本比较：纯汇编大小写折叠与字节比对。
SSE2 矢量化扩充：
扩充 Asm_JSON_Minify、Asm_Count_Spaces 与 Asm_Skip_Whitespace 的 128 位 XMM 向量匹配指令，对连续空格、换行符（
,
, ）实行 16 字节并发吞吐。
四、 v1.5 与 v1.6 核心特性差异对照表
维度 / 特性 ZJSON v1.5 ZJSON v1.6
线程安全机制 SRWLock 读写锁（手动记录 ThreadID 与递归层数） Win32 CRITICAL_SECTION 临界区（系统内核原生递归支持）
哈希索引寻址 绝对物理内存指针（扩容后必失效） 缓冲区相对偏移量（Relative Offset，扩容依然有效）
哈希扩容机制 固定分配，超限全量重建 动态自动平滑 Rehash（支持倍增扩容至 104W 桶）
复合路径缓存 仅支持简单数组下标智能缓存（m_QC_Slots） 增加 128 槽 16KB 复合路径高速缓存（m_PC_Slots）
数据压缩 / 解压 无（需外部模块或扩展支持库） 全汇编内置：GZIP / ZLIB / Raw Deflate 极速编解码
正则表达式支持 无 全汇编内置：支持贪婪/非贪婪、字符集、(?i) 等全套语法
JSON 排序能力 无 全汇编内置：支持对象键名字典序重排、数组多字段/数值排序
负数索引支持 不支持（传入负数返回异常或越界） 原生完整支持（如 -1 取末项，覆盖所有方法与路径）
路径追加语法 不支持 支持 arr[]、arr[+] 自动追加
字符串截断机制 调用易语言核心库 取文本左边 / 取字节集左边 重新堆分配 汇编级原位修改长度头 / 终止符，零堆分配
基础文本处理 易语言核心支持库 API 全量重写为纯汇编指令（取文本长度、寻找文本、文本比较）
空容器检测 依赖判断 取成员数() ＝ 0 新增专有公开接口 是否为空()
五、 升级迁移指南与注意事项
多线程并发调用注意：
v1.6 的同步锁由读写锁转为互斥临界区，彻底解决了多线程写入崩溃与死锁隐患。原有的调用逻辑无需任何修改，底层已自动适配。
数组越界行为变更：
在读取数组元素时，负数已被赋予特定语义（-1 代表最后一项）。若以往业务逻辑中存在传入未初始化负数变量的情况，请注意核对传参。
接口向前兼容性：
v1.6 保持了所有公开方法名、参数顺序与返回类型的向下兼容，直接替换模块即可无缝编译升级。

【模块简介】
ZJSON 是一款专为高并发与海量数据场景打造的工业级 JSON 解析与构建引擎。通过对 x86 汇编的深度重构与底层内存架构的颠覆性创新，它成功打破了 32 位环境的物理桎梏。以常态稳定 600~720MB/s 的解析吞吐量和近 500 万次 Ops/s 的读写极速，正式将易语言的 JSON 处理能力推入全球顶尖梯队（跻身 T1 级别，性能直接比肩 C++ 工业标杆 RapidJSON，远超 V8 引擎与 Go 原生库，更是对易语言常规第三方模块形成了几十倍的降维打击）。它不仅是一台跑分无敌的“性能怪兽”，更在极客级别的底层中，融入了如同 JavaScript 般丝滑的现代化开发体验。

【核心技术特性】
汇编级降维打击与惰性扁平流
全面抛弃传统臃肿的 DOM 多叉树结构！数据在物理内存中保持连续紧凑的扁平字节流，依托纯 FASM 汇编指令与 SSE2 向量化进行 16 字节并发比对与高速寻址。深度整合裸内存原位截断技术（In-place Truncation），在紧凑写出、文本提取与编码转换时直接重写内存边界标识，杜绝海量微小内存块的频繁申请与碎片化；对大型数组与子节点支持零拷贝（Zero-Copy）裸指针级直接映射，彻底消除中间字符串构建开销。

极致并发：内核级临界区调度
全面接入 Win32 原生 CRITICAL_SECTION 临界区机制，由 Windows 系统内核调度器原生接管线程所有权判定与可重入递归管理。配合专属极简汇编调用跳板（Asm_Lock_Op），彻底消除锁层状态冗余。在多线程狂暴交叉读写、乱序抹除的极端并发压测场景下，依然保证哈希精准、逻辑安全、死锁率为 0。

突破性的 O(1) 内存复用与双层高速缓存
独创“预留空洞”与“Ghost Node (软删除)”机制，95% 的节点更新直接在物理内存中原地覆盖覆写。构建双层查询缓存加速体系：内置线程独立的智能游标缓存（m_QC_Slots），大型数组顺序递增或随机追加直接跳跃寻址，将传统 $O(N^2)$ 遍历暴力降维至 $O(1)$；同时开辟专用的 128 槽复合路径高速缓存（m_PC_Slots），多级深层嵌套路径首次访问后自动建立物理偏移绑定，二次读取直接秒开。

JS 级自愈结构补全与 Python 风格负数索引
写 JSON 从未如此优雅！自带智能路径编译器，只需简单一句 KV.置文本 (“data.users[0].profile.age”, “18”)，引擎即可无视数组越界与父节点缺失，安全、自动、一次性补齐中间所有缺失的对象 {} 或数组 [] 容器，实现“点哪创哪”。同时全面原生支持 Python 风格的负数倒序索引（-1 提取末项，-2 提取倒数第二项），支持 arr[]、arr[+] 尾部盲追加语法，彻底告别繁琐的前置成员数查询。

原生纯汇编通用正则与全格式数据流压缩
彻底脱离外部 DLL（免去 zlibwapi.dll 等动态库依赖）与系统脚本对象：

内置全汇编压缩引擎：原生集成了纯汇编 LZ77、Huffman 树编解码与硬件级 CRC32 / Adler32 校验，支持自动识别并极速压缩/解压 GZIP、ZLIB 与 Raw Deflate 二进制流。
内置全汇编轻量正则引擎：直接在底层实现纯汇编模式匹配，完整支持贪婪/非贪婪量词（*, +, ?, {n,m}, *? 等）、边界锚点（^, $）、预定义字符集（d, w, s 等）、字符区间 […] 与 (?i) 忽略大小写指令，提供匹配、提取、拆分与节点原位替换能力。
原生全汇编双模式极速排序引擎
内置纯汇编双向划分快速排序（Asm_Sort_Entries），排序过程无需创建任何冗余字符串堆对象：

对象键名排序：支持对单层或深层嵌套子对象（递归排序模式）按键名字典序（升序/降序，支持忽略大小写）一键物理重排。
数组多维度排序：支持常规文本/数值数组的原位重排，更支持对象数组按内部指定任意字段提取排序，支持文本字典序与 64 位双精度浮点数值（IEEE-754 Double）大小比较。
全自动无缝智能转码
底层集成纯汇编 SIMD 级 ASCII 探测，利用 128 位寄存器瞬间探测数据高位。纯英文内容实施裸内存直通传输，非 ASCII 字符则在 ANSI (GBK)、标准 UTF-8 以及 Unicode (UTF-16LE) 之间进行纳秒级、无感知的双向无损转码，原生支持复杂 Emoji 代理对的完整还原。