各位在代码海洋里捡贝壳的探险家们！今天我们要打开一个尘封的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>
避坑指南：
-
如果Maven报错，请先检查自己是否穿越到了正确的时间线（JDK1.5环境）
-
找不到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曾是一代枭雄，但如今：
-
性能警告：转换速度堪比树懒打哈欠（比Jackson慢5-10倍）
-
安全警报：漏洞多得像瑞士奶酪（CVE清单能写满一页A4纸）
-
维护状态：官方最后一次更新时，iPhone还没诞生
替代方案推荐：
-
怀旧党：Google的Gson（2008年发布，勉强算近代史）
-
效率狂：Jackson（速度王者，Spring官方CP）
-
冒险家：Fastjson（速度怪兽，但需小心安全补丁）
考古学家结语：
用JSON-lib就像开老爷车——
偶尔兜风很酷，天天通勤想哭
（除非你想在面试时炫耀：“我连JSON-lib都搞过！”）
