好的，我给你整理一个关于 使用 json-lib 库实现 JSON 字符串和 Java 对象互转 的详细教程，包括依赖引入、基本用法示例、常见问题和注意事项。

1. 什么是 json-lib

json-lib 是一个老牌 Java JSON 处理库，可以方便地在 Java 对象和 JSON 字符串之间互转。
虽然现在更流行的库有 Jackson、Gson，但 json-lib 依然在一些遗留项目中使用。

2. 引入依赖

Maven 依赖

<dependency>
    <groupId>net.sf.json-lib</groupId>
    <artifactId>json-lib</artifactId>
    <version>2.4</version>
    <classifier>jdk15</classifier>
</dependency>

注意

json-lib 依赖以下库，需确保也引入：

  • commons-lang
  • commons-beanutils
  • commons-collections
  • commons-logging

3. 核心类

  • JSONObject — 代表 JSON 对象
  • JSONArray — 代表 JSON 数组
  • JsonConfig — 配置序列化/反序列化行为

4. Java 对象转 JSON 字符串

示例代码

假设有个简单的 Java 类：

public class User {
    private String name;
    private int age;

    // getter/setter
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }
}

转换示例：

import net.sf.json.JSONObject;

public class JsonLibDemo {
    public static void main(String[] args) {
        User user = new User();
        user.setName("小明");
        user.setAge(18);

        JSONObject json = JSONObject.fromObject(user);
        String jsonString = json.toString();

        System.out.println(jsonString);
    }
}

输出：

{"age":18,"name":"小明"}

5. JSON 字符串转 Java 对象

import net.sf.json.JSONObject;

public class JsonLibDemo {
    public static void main(String[] args) {
        String jsonString = "{\"age\":18,\"name\":\"小明\"}";

        JSONObject json = JSONObject.fromObject(jsonString);
        User user = (User) JSONObject.toBean(json, User.class);

        System.out.println(user.getName()); // 小明
        System.out.println(user.getAge());  // 18
    }
}

6. 处理集合类

Java 集合转 JSONArray

import net.sf.json.JSONArray;
import java.util.ArrayList;
import java.util.List;

List<User> userList = new ArrayList<>();
userList.add(user1);
userList.add(user2);

JSONArray jsonArray = JSONArray.fromObject(userList);
System.out.println(jsonArray.toString());

JSONArray 转 List

JSONArray jsonArray = JSONArray.fromObject(jsonString);
List<User> users = (List<User>) JSONArray.toCollection(jsonArray, User.class);

7. 注意事项

  • 日期处理
    默认日期格式会被序列化为时间戳，可以使用 JsonConfig 自定义日期格式。
  • 循环引用
    如果对象间存在循环引用，json-lib 可能会报错。
  • 性能
    json-lib 较老，性能和兼容性不如 Jackson 和 Gson。

8. 代码示例（含日期格式化）

import net.sf.json.JSONObject;
import net.sf.json.JsonConfig;
import net.sf.json.util.CycleDetectionStrategy;

import java.text.SimpleDateFormat;
import java.util.Date;

public class JsonLibDateDemo {
    public static void main(String[] args) {
        JsonConfig jsonConfig = new JsonConfig();
        jsonConfig.setCycleDetectionStrategy(CycleDetectionStrategy.LENIENT);
        jsonConfig.registerJsonValueProcessor(Date.class, (value, jsonConfig1) -> {
            if (value == null) return "";
            SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            return sdf.format(value);
        });

        MyBean bean = new MyBean();
        bean.setDate(new Date());

        JSONObject json = JSONObject.fromObject(bean, jsonConfig);
        System.out.println(json.toString());
    }
}

class MyBean {
    private Date date;
    public Date getDate() { return date; }
    public void setDate(Date date) { this.date = date; }
}