JSON-lib考古现场：在2025年打开赛博古董店的奇妙冒险

各位在代码海洋里捡贝壳的探险家们！今天我们要打开一个尘封的Java古董箱——JSON-lib！这货可是2003年的老宝贝，比在座很多程序员的工龄还大！准备好穿越回Web 1.0时代，感受XML统治时期的余晖了吗？ 🕰️

---

第一章：古董店开箱——配置篇

Step1 导入上古依赖（需要先找时光机）

<!-- 需要先召唤神龙才能下载的依赖 -->  
<dependency>  
    <groupId>net.sf.json-lib</groupId>  
    <artifactId>json-lib</artifactId>  
    <version>2.4</version>  
    <classifier>jdk15</classifier> <!-- 注意！这行是魔法咒语 -->  
</dependency>  

<!-- 必须搭配的时空伴侣 -->  
<dependency>  
    <groupId>net.sf.ezmorph</groupId>  
    <artifactId>ezmorph</artifactId>  
    <version>1.0.6</version> <!-- 2005年出土文物 -->  
</dependency>  

避坑指南：

1. 如果Maven报错，请先检查自己是否穿越到了正确的时间线（JDK1.5环境）
2. 找不到jar包？试试在旧电脑回收站里翻找2008年的本地仓库备份

---

第二章：基础炼金术——对象转JSON

案例1：普通JavaBean转换

User user = new User("张三", 25);  
JSONObject json = JSONObject.fromObject(user);  
System.out.println(json.toString());  
// 输出：{"age":25,"name":"张三"}  
// 惊喜！字段顺序随机，像抽盲盒一样刺激！  

案例2：集合转换（可能触发时空乱流）

List<User> users = Arrays.asList(new User("李四"), new User("王五"));  
JSONArray jsonArray = JSONArray.fromObject(users);  
// 输出：[{"name":"李四"},{"name":"王五"}]  
// 注意！如果List为空，可能召唤出NullPointerException恶魔  

---

第三章：黑魔法防御课——高级配置

秘技1：日期格式封印术

JsonConfig config = new JsonConfig();  
config.registerJsonValueProcessor(Date.class, new DateJsonValueProcessor("yyyy-MM-dd"));  

JSONObject json = JSONObject.fromObject(new Order(), config);  
// 输出：{"createTime":"2023-08-15"}  
// 警告！如果忘记设置时区，日期可能漂移到火星时间  

秘技2：防循环引用结界

config.setCycleDetectionStrategy(CycleDetectionStrategy.LENIENT);  
// 效果：  
// 当对象A引用B，B引用A时  
// 输出：{"ref":"...递归太深已自毁..."}  

---

第四章：逆向召唤阵——JSON转对象

咒语示例：

String jsonStr = "{\"name\":\"赵六\",\"age\":18}";  
JSONObject jsonObject = JSONObject.fromObject(jsonStr);  
User user = (User) JSONObject.toBean(jsonObject, User.class);  
// 注意事项：  
// 1. 如果字段不匹配，你会得到一个半成品对象（属性随机丢失）  
// 2. 需要准备一个无参构造函数，否则会触发上古异常  

高危实验（集合转换）

String jsonArrayStr = "[{\"name\":\"钱七\"},{\"name\":\"孙八\"}]";  
JSONArray jsonArray = JSONArray.fromObject(jsonArrayStr);  
List<User> users = JSONArray.toList(jsonArray, User.class);  
// 可能出现的副作用：  
// 1. 泛型擦除导致ClassCastException  
// 2. 需要手动处理嵌套集合（建议佩戴类型安全护符）  

---

第五章：古董维护指南——常见灵异事件

灵异现象1：玄学日期解析

输入：{"date":"2023-08-15"}  
输出：Java对象中的date字段变成公元前2023年  
原因：默认使用神秘日期格式MM/dd/yyyy  
解法：献祭一个DateJsonValueProcessor给JsonConfig  

灵异现象2：神秘字段丢失

现象：对象里的boolean isVIP字段消失  
原因：get方法名叫isVIP()但set方法叫setVIP()  
解法：在字段前跳一支祭祀舞（或者统一方法名）  

灵异现象3：永动机异常

异常信息：java.lang.StackOverflowError  
原因：对象循环引用 + 忘记设置CycleDetectionStrategy  
解法：在代码前撒盐驱魔（或者换Jackson）  

---

终章：来自2023年的友情提醒

虽然JSON-lib曾是一代枭雄，但如今：

1. 性能警告：转换速度堪比树懒打哈欠（比Jackson慢5-10倍）
2. 安全警报：漏洞多得像瑞士奶酪（CVE清单能写满一页A4纸）
3. 维护状态：官方最后一次更新时，iPhone还没诞生

替代方案推荐：

• 怀旧党：Google的Gson（2008年发布，勉强算近代史）
• 效率狂：Jackson（速度王者，Spring官方CP）
• 冒险家：Fastjson（速度怪兽，但需小心安全补丁）

---

考古学家结语：
用JSON-lib就像开老爷车——
偶尔兜风很酷，天天通勤想哭
（除非你想在面试时炫耀：“我连JSON-lib都搞过！”）