Java类的泛型集合转换成JSON对象的实现与示例代码

在使用 ExtJS 进行前端开发时，前后端数据交互几乎离不开 JSON 格式。这个工具类未来或许也能帮到你——它能够将 Java 中的泛型集合直接转换为 JSON，省去手动拼接的麻烦。下面先来看核心代码。

ConvertJsonUtils.java

package com.sunweb.util.jsonfactory;

import ja va.util.List;

import com.sunweb.util.jsonfactory.jsontools.JSONArray;
import com.sunweb.util.jsonfactory.jsontools.JSONException;
import com.sunweb.util.jsonfactory.jsontools.JSONObject;

/**
 * @title 公共json数据格式转换
 * @author 贺彬
 */
public class ConvertJsonUtils {

    public ConvertJsonUtils() {
        super();
    }

    /**
     * 功能：将泛型集合转换成分页json数据
     * 
     * @param list
     *            泛型集合
     * @param countList
     *            数据集合的总行数
     * @return 分页json数据
     */
    public static String ConvertListToPageJson(List list, int countList) {
        // 新建一个json数组
        JSONArray jsonArray = new JSONArray();
        // 新建一个json对象
        JSONObject jsonObject = null;
        // 遍历泛型集合
        for (Object object : list) {
            jsonObject = new JSONObject(object);
            jsonArray.put(jsonObject);
        }
        // 转换数据格式
        String json = jsonArray.toString();
        // 拼接字符串
        StringBuffer sb = new StringBuffer();
        sb.append("{"totalCount":");
        sb.append(countList);
        sb.append(","rows":");
        sb.append(json);
        sb.append("}");
        String jsonString = sb.toString();
        return jsonString;
    }
    /**
     * 功能：将泛型集合转换成分页json数据
     * 
     * @param list
     *            泛型集合
     * @param countList
     *            数据集合的总行数
     * @return 分页json数据
     */
    public static String ConvertListToPageJson(List list){
        // 新建一个json数组
        JSONArray jsonArray = new JSONArray();
        // 新建一个json对象
        JSONObject jsonObject = null;
        // 遍历泛型集合
        for (Object object : list) {
            jsonObject = new JSONObject(object);
            jsonArray.put(jsonObject);
        }
        // 转换数据格式
        String json = jsonArray.toString();
        // 拼接字符串
        JSONObject jn = new JSONObject();
        try {
            jn.put("records", jsonArray);
        } catch (JSONException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
        return jn.toString();
    }

}

这里提供了两个重载方法：一个支持分页，返回包含 totalCount 和 rows 的结构；另一个只返回 records。具体选用哪个，取决于前端框架的需求。例如 ExtJS 的 Grid 通常需要分页数据，此时应使用带总数参数的版本；若仅做列表展示，无分页的版本则更加简洁。

Test.java —— 快速验证转换效果

package com.sunweb.util.jsonfactory;

import ja va.util.ArrayList;
import ja va.util.List;

public class Test {

    /**
     * @param args
     */
    public static void main(String[] args) {
        List list = new ArrayList(); //创建一个泛型的list集合
        Student stu = null;
        for(int i=0;i<20;i++){
            stu = new Student();
            stu.setId(i);
            stu.setName("贺兵"+i);
            //模拟有20个对象的list集合
            list.add(stu);
        }
        //现在将集合转成json不分页
        String json1 = ConvertJsonUtils.ConvertListToPageJson(list);
        System.out.println(json1);
        //分页，总数20条
        String json2 = ConvertJsonUtils.ConvertListToPageJson(list, 20);
        System.out.println(json2);
    }

}

运行 main 方法后，控制台会输出两个 JSON 字符串。第一个是纯数组格式，第二个是带有 totalCount 和 rows 的包装结构，正好满足前端分页组件的格式要求。

Student.java —— 一个简单的 POJO 示例

package com.sunweb.util.jsonfactory;

public class Student {
    private int id;
    private String name;
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
}

这个类仅演示了两个字段，实际项目中你可以替换为自己的实体类。只要属性提供 getter 方法，JSON 工具就能自动解析。核心思路并不复杂：利用 JSONObject 构造器直接传入对象，再组装成 JSONArray，最后拼接分页信息。代码量虽小，但在日常开发中非常实用。