如何用aspJSON快速处理JSON数据：经典ASP开发者的终极指南 🚀

aspJSON 是一款专为经典ASP（Active Server Pages）设计的高效JSON解析与生成工具，让老旧ASP项目也能轻松对接现代JavaScript MV*框架。通过简单直观的API，开发者可快速实现JSON数据的创建、修改、序列化与数据库记录转换，无需复杂配置即可提升后端数据交互能力。

📂 项目核心文件解析：认识你的工具箱

aspJSON项目采用极简目录结构，核心功能高度集中，便于快速上手与集成：

🔑 核心功能文件：jsonObject.class.asp

作为项目的灵魂文件，jsonObject.class.asp 封装了所有JSON处理逻辑，包括：

• JSON对象/数组操作：Add/Remove/Change等方法实现数据增删改查
• 序列化与解析：Serialize()生成JSON字符串，Parse()解析JSON文本
• 数据库集成：LoadRecordset()直接转换ADODB.Recordset为JSON格式

✅ 许可协议：LICENCE.txt

采用MIT开源许可协议，允许商业与非商业项目免费使用、修改和分发，只需保留原始版权声明。

📝 测试与示例：test.asp

包含完整功能测试用例，可直接运行查看实际效果，快速理解API使用场景。

🚀 3步快速上手：从安装到输出第一个JSON

1️⃣ 环境准备：设置LCID（必做步骤！）

使用前需配置ASP应用的区域设置标识符（LCID），三种方式任选其一：

' 方式1：页面声明（作用于整个页面）
<%@ LCID=1046 %> 

' 方式2：Session级设置（作用于所有页面）
Session.LCID = 1046 

' 方式3：Response级设置（作用于后续代码）
Response.LCID = 1046 ' 1046=巴西葡萄牙语，根据需求替换

2️⃣ 引入类文件并实例化

通过ASP include指令引入核心类，然后创建JSON对象实例：

<!--#include file="jsonObject.class.asp"-->
<%
set JSON = New JSONobject ' 创建JSON对象实例
set JSONarr = New JSONarray ' 创建JSON数组实例（如需操作数组）
%>

3️⃣ 基本操作示例：创建并输出JSON

' 添加属性
JSON.Add "title", "aspJSON教程"
JSON.Add "version", 3.9
JSON.Add "features", Array("轻量", "快速", "易用")

' 输出JSON字符串
JSON.Write() ' 直接输出到Response
' 或获取字符串用于后续处理
Dim jsonStr: jsonStr = JSON.Serialize()
%>

💡 实用功能全解析：解锁高级用法

📊 数据库记录转JSON：一行代码搞定

无需手动遍历Recordset，直接转换查询结果为JSON：

' 假设已创建ADODB.Recordset对象rs
JSON.LoadRecordset rs ' 转换为对象形式：{"data":[{"id":1,...},...]}
JSONarr.LoadRecordset rs ' 转换为数组形式：[{"id":1,...},...]

' 自定义根属性名称（默认是"data"）
JSON.defaultPropertyName = "products"
JSON.Write() ' 输出：{"products":[{"id":1,...},...]}

🔄 数组操作：创建与遍历JSON数组

' 创建数组并添加元素
JSONarr.Push "苹果"
JSONarr.Push "香蕉"
JSONarr.Push JSON ' 可嵌套JSON对象

' 遍历数组元素
For Each item In JSONarr.items
  If TypeName(item) = "JSONobject" Then
    item.Write() ' 输出嵌套对象
  Else
    Response.Write item ' 输出基本类型
  End If
Next

🔧 常见问题解决：避坑指南

Q：为什么中文出现乱码？

A：确保LCID设置正确，建议使用UTF-8编码页面：Response.CodePage = 65001

Q：如何处理复杂嵌套结构？

A：支持无限层级嵌套，通过.操作符或索引访问深层属性：

' 访问嵌套对象属性
Response.Write JSON("user")("address")("city")

' 访问数组元素
Response.Write JSONarr(2) ' 获取第三个元素

📈 性能优化小贴士

1. 减少对象创建：复用JSON实例而非频繁创建新对象
2. 批量操作优先：使用LoadRecordset而非循环Add
3. 及时释放资源：操作完成后设置set JSON = Nothing

📄 项目许可与贡献

aspJSON采用MIT许可协议，允许自由使用和修改。项目源码托管地址：
git clone https://gitcode.com/gh_mirrors/as/aspJSON

无论是维护 legacy 系统还是开发新的ASP应用，aspJSON都能让JSON处理变得简单高效。立即尝试，为你的ASP项目注入现代数据交互能力吧！✨