java怎么把list转为json

www.xservx.com|蜀ICP备2026035467号-3

⚡ List转JSON基础概念

在Java开发中,将List集合转换为JSON格式是前后端交互、数据存储及API开发中的高频操作。JSON作为一种轻量级数据交换格式,具有结构清晰、解析高效、跨平台兼容性强等优势,成为现代Web应用的事实标准。而List作为Java中最常用的集合类型之一,承载着大量业务数据,因此掌握高效的List→JSON转换技术至关重要。

从技术本质看,List转JSON的过程涉及对象序列化:将内存中的Java对象图转换为符合JSON语法规范的字符串结构。此过程需处理数据类型映射、循环引用检测、空值处理、日期格式化等关键环节,稍有不慎即可能导致数据丢失、格式错误或性能瓶颈。

主流Java JSON库均提供List→JSON的原生支持,但实现机制与性能表现差异显著:

选择合适方案需综合考量项目需求、性能指标、安全规范及团队技术栈。本文将深入剖析三大主流方案的实现原理、操作细节及实战技巧,助您构建高效可靠的JSON转换层。

⚙️ Gson方案详解

Gson是Google推出的开源JSON处理库,核心设计理念是“简单易用、类型安全、性能均衡”。其Gson类提供toJson()方法直接支持List转JSON,配合JsonParser可实现灵活的JSON操作。

基础用法

引入依赖(Maven):

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.10.1</version>
</dependency>

示例代码:

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.util.Arrays;
import java.util.List;
public class GsonListToJson {
    public static void main(String[] args) {
        List names = Arrays.asList("张三", "李四", "王五");
        Gson gson = new Gson();
        // 直接转换
        String json = gson.toJson(names);
        System.out.println(json); // ["张三","李四","王五"]
        // 转换为带缩进的格式
        Gson prettyGson = new GsonBuilder().setPrettyPrinting().create();
        System.out.println(prettyGson.toJson(names));
        // [
        //   "张三",
        //   "李四",
        //   "王五"
        // ]
    }
}

对象列表转换

处理自定义对象时,Gson自动识别字段并序列化:

import com.google.gson.Gson;
import java.util.ArrayList;
import java.util.List;
class User {
    private String name;
    private int age;
    public User(String name, int age) {
        this.name = name;
        this.age = age;
    }
    // getter/setter省略
}
public class GsonObjectList {
    public static void main(String[] args) {
        List users = new ArrayList<>();
        users.add(new User("张三", 25));
        users.add(new User("李四", 30));
        Gson gson = new Gson();
        String json = gson.toJson(users);
        System.out.println(json);
        // [{"name":"张三","age":25},{"name":"李四","age":30}]
    }
}

泛型处理技巧

由于Java泛型擦除机制,直接使用gson.toJson(list)会丢失泛型信息,导致JSON结构不完整。需借助TypeToken显式指定泛型类型:

import com.google.gson.reflect.TypeToken;
import com.google.gson.Gson;
import java.lang.reflect.Type;
import java.util.List;
// 错误示例(泛型丢失)
String json1 = gson.toJson(userList); // 只保留类名字段
// 正确方式
Type listType = new TypeToken>(){}.getType();
String json2 = gson.toJson(userList, listType); // 完整序列化

定制序列化行为

Gson支持通过GsonBuilder配置序列化策略:

完整示例:

Gson gson = new GsonBuilder()
    .setDateFormat("yyyy-MM-dd HH:mm:ss")
    .serializeNulls()
    .setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES)
    .create();

⚙️ Jackson方案详解

Jackson是Java生态中最成熟的JSON处理框架,以高性能、高扩展性著称,是Spring Boot默认的JSON库。其核心组件包括ObjectMapper(核心API)、JsonNode(树模型)及Streaming API(流式处理)。

基础转换

Maven依赖:

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>

核心操作:

import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Arrays;
import java.util.List;
public class JacksonListToJson {
    public static void main(String[] args) throws Exception {
        ObjectMapper mapper = new ObjectMapper();
        List names = Arrays.asList("张三", "李四", "王五");
        // 简单转换
        String json = mapper.writeValueAsString(names);
        System.out.println(json); // ["张三","李四","王五"]
        // 写入文件
        mapper.writeValue(new File("users.json"), names);
        // 带格式输出
        String prettyJson = mapper.writerWithDefaultPrettyPrinter()
                                  .writeValueAsString(names);
        System.out.println(prettyJson);
    }
}

对象列表处理

Jackson对自定义对象支持完善,自动识别getter方法:

import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.ArrayList;
import java.util.List;
class Person {
    private String name;
    private int age;
    // getter/setter/constructor
    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }
    public String getName() { return name; }
    public int getAge() { return age; }
}
public class JacksonObjectList {
    public static void main(String[] args) throws Exception {
        ObjectMapper mapper = new ObjectMapper();
        List people = new ArrayList<>();
        people.add(new Person("张三", 25));
        people.add(new Person("李四", 30));
        String json = mapper.writeValueAsString(people);
        System.out.println(json);
        // [{"name":"张三","age":25},{"name":"李四","age":30}]
    }
}

高级配置

Jackson提供丰富的配置选项,适用于复杂业务场景:

配置示例:

ObjectMapper mapper = new ObjectMapper();
mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));
mapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);
// 注解方式(推荐)
class Product {
    private String name;
    @JsonIgnore
    private String internalCode;
}

性能优化技巧

在高并发场景下,建议复用ObjectMapper实例(线程安全),避免重复创建:

// 全局单例
public class JsonMapper {
    private static final ObjectMapper mapper = new ObjectMapper();
    public static String toJson(Object obj) {
        try {
            return mapper.writeValueAsString(obj);
        } catch (JsonProcessingException e) {
            throw new RuntimeException(e);
        }
    }
}

⚙️ Fastjson方案详解

Fastjson是阿里开源的高性能JSON库,曾以“世界最快JSON库”闻名,支持JSON与Java对象互转、JSON到XML转换等。尽管早期版本存在安全漏洞(如反序列化漏洞),但自2.0版本起已全面重构,修复关键问题并提升性能。

基础用法

Maven依赖(2.0版本):

<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.43</version>
</dependency>

核心API:

import com.alibaba.fastjson2.JSON;
import java.util.Arrays;
import java.util.List;
public class FastjsonListToJson {
    public static void main(String[] args) {
        List names = Arrays.asList("张三", "李四", "王五");
        // 简单转换
        String json = JSON.toJSONString(names);
        System.out.println(json); // ["张三","李四","王五"]
        // 带缩进输出
        String prettyJson = JSON.toJSONString(names, true);
        System.out.println(prettyJson);
        // 对象列表
        List users = Arrays.asList(
            new User("张三", 25),
            new User("李四", 30)
        );
        String userJson = JSON.toJSONString(users);
        System.out.println(userJson);
    }
}

定制序列化

Fastjson支持多种序列化配置:

示例代码:

class Item {
    @JSONField(name = "item_name")
    private String name;
    @JSONField(format = "yyyy-MM-dd HH:mm:ss")
    private Date createTime;
}
String json = JSON.toJSONString(item,
    JSONWriter.Feature.PrettyFormat,
    JSONWriter.Feature.WriteClassName);

安全配置

为防止反序列化漏洞,建议启用白名单校验:

import com.alibaba.fastjson2.parser.Feature;
import com.alibaba.fastjson2.JSON;
// 启用安全模式
JSON.parseObject(json, Object.class, Feature.SupportAutoType);
// 白名单校验
String[] safeClasses = {"java.util.ArrayList", "com.example.User"};
JSON.parseObject(json, Object.class, Feature.SupportAutoType,
    new SafeConsumer<>(safeClasses));

⚡ 方案对比与选型指南

特性 Gson Jackson Fastjson
性能(单线程) 中等 高 极高
内存占用 低 中等 低
API复杂度 简单 中等 简单
泛型支持 优秀(TypeToken) 优秀(TypeReference) 良好(Class参数)
注解丰富度 中等 高 中等
社区活跃度 稳定 极高 中等
安全记录 良好 良好 曾有漏洞(2.0修复)

选型建议

性能测试参考(10万次List转JSON):

库 时间(ms) 内存(MB)
Gson 850 45
Jackson 620 58
Fastjson 2.0 380 32

⚡ 常见问题与解决方案

循环引用问题

当List中对象存在相互引用(如User→Address→User),序列化时会陷入无限递归:

class User {
    private String name;
    private Address address; // 地址引用用户
}
class Address {
    private String street;
    private User owner; // 用户引用地址
}

解决方案:

空List处理

当List为空时,部分库返回[],部分返回null,需统一处理:

// 统一返回空数组而非null
String json = gson.toJson(list != null ? list : new ArrayList<>());

日期格式不一致

默认序列化Long类型时间戳,前端解析困难:

// Gson
Gson gson = new GsonBuilder()
    .setDateFormat("yyyy-MM-dd HH:mm:ss")
    .create();
// Jackson
mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));
// Fastjson
JSON.toJSONStringWithDateFormat(obj, "yyyy-MM-dd HH:mm:ss");

特殊字符转义

含HTML标签或Unicode字符时需禁用转义:

Gson gson = new GsonBuilder()
    .disableHtmlEscaping()
    .create();
// Jackson
mapper.enable(JsonGenerator.Feature.ESCAPE_NON_ASCII);

⚡ 实战案例:电商订单列表JSON生成

业务场景

用户订单列表需包含:订单号、商品名称、价格、创建时间、状态,状态包含:待付款/已付款/已发货/已完成

数据模型设计

class OrderItem {
    private String orderNo;
    private String productName;
    private BigDecimal price;
    private Date createTime;
    private OrderStatus status;
    // 构造方法、getter/setter
}
enum OrderStatus {
    PENDING_PAYMENT,
    PAID,
    SHIPPED,
    COMPLETED
}

完整实现代码

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import java.math.BigDecimal;
import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.util.ArrayList;
import java.util.List;
public class OrderJsonGenerator {
    public static void main(String[] args) throws Exception {
        ObjectMapper mapper = new ObjectMapper();
        mapper.registerModule(new JavaTimeModule());
        mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
        List orders = new ArrayList<>();
        orders.add(new OrderItem("ORD20231001", "无线鼠标", new BigDecimal("59.90"),
            LocalDateTime.now().minusDays(2), OrderStatus.PAID));
        orders.add(new OrderItem("ORD20231002", "机械键盘", new BigDecimal("499.00"),
            LocalDateTime.now().minusDays(1), OrderStatus.SHIPPED));
        // 序列化为JSON
        String json = mapper.writeValueAsString(orders);
        System.out.println(json);
        // 输出结果:
        // [
        //   {
        //     "orderNo": "ORD20231001",
        //     "productName": "无线鼠标",
        //     "price": 59.90,
        //     "createTime": "2023-10-01T14:30:00",
        //     "status": "PAID"
        //   },
        //   {
        //     "orderNo": "ORD20231002",
        //     "productName": "机械键盘",
        //     "price": 499.00,
        //     "createTime": "2023-10-02T09:15:00",
        //     "status": "SHIPPED"
        //   }
        // ]
    }
}

优化建议

⚡ 网友们还关心的周边问题