fastjson怎么把list转json

Fastjson中List转JSON的完整指南

在Java开发中,将List集合转换为JSON字符串是一个常见的需求，特别是在前后端数据交互、API接口开发等场景，Fastjson作为阿里巴巴开源的高性能JSON库，提供了简单易用的API来实现List到JSON的转换，本文将详细介绍如何使用Fastjson将List转换为JSON字符串，包括基本用法、常见场景及注意事项。

Fastjson简介

Fastjson是一个Java语言编写的高性能功能完备的JSON库,它由阿里巴巴开发并开源，Fastjson具有以下特点：

• 速度快：性能优异，解析和生成JSON的速度非常快
• 功能全：支持JSON与Java对象的相互转换
• 使用简单：API设计简洁易用
• 支持复杂对象：可以处理嵌套对象、集合、泛型等复杂结构

基本用法：List转JSON字符串

添加Fastjson依赖

确保你的项目中已经添加了Fastjson的依赖,如果你使用Maven，可以在pom.xml中添加：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.83</version> <!-- 建议使用最新稳定版本 -->
</dependency>

简单List转JSON

对于最简单的List集合,转换非常直接：

import com.alibaba.fastjson.JSON;
import java.util.Arrays;
import java.util.List;
public class ListToJsonExample {
    public static void main(String[] args) {
        // 创建一个简单的List
        List<String> stringList = Arrays.asList("apple", "banana", "orange");
        // 将List转换为JSON字符串
        String jsonString = JSON.toJSONString(stringList);
        System.out.println(jsonString);
        // 输出: ["apple","banana","orange"]
    }
}

包含自定义对象的List转JSON

当List中包含自定义对象时,Fastjson会自动将对象属性转换为JSON键值对：

import com.alibaba.fastjson.JSON;
import java.util.ArrayList;
import java.util.List;
class User {
    private String name;
    private int age;
    // 构造方法、getter和setter省略...
    public User(String name, int age) {
        this.name = name;
        this.age = age;
    }
    public String getName() {
        return name;
    }
    public int getAge() {
        return age;
    }
}
public class ObjectListToJsonExample {
    public static void main(String[] args) {
        // 创建包含User对象的List
        List<User> userList = new ArrayList<>();
        userList.add(new User("张三", 25));
        userList.add(new User("李四", 30));
        // 将List转换为JSON字符串
        String jsonString = JSON.toJSONString(userList);
        System.out.println(jsonString);
        // 输出: [{"age":25,"name":"张三"},{"age":30,"name":"李四"}]
    }
}

高级用法与场景

格式化输出（美化JSON）

默认情况下,Fastjson输出的JSON是压缩格式的，如果需要格式化的（美化）输出，可以使用以下方法：

String prettyJson = JSON.toJSONString(userList, true);
System.out.println(prettyJson);
/*
输出:
[
    {
        "age": 25,
        "name": "张三"
    },
    {
        "age": 30,
        "name": "李四"
    }
]
*/

处理复杂嵌套结构

Fastjson可以轻松处理复杂的嵌套结构,如List中包含Map或其他List：

import com.alibaba.fastjson.JSON;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class NestedListToJsonExample {
    public static void main(String[] args) {
        // 创建包含嵌套结构的List
        List<Object> complexList = new ArrayList<>();
        // 添加简单字符串
        complexList.add("simple string");
        // 添加Map
        Map<String, Object> map = new HashMap<>();
        map.put("key1", "value1");
        map.put("key2", 123);
        complexList.add(map);
        // 添加另一个List
        List<Integer> numbers = Arrays.asList(1, 2, 3, 4, 5);
        complexList.add(numbers);
        // 转换为JSON
        String jsonString = JSON.toJSONString(complexList);
        System.out.println(jsonString);
        // 输出: ["simple string",{"key1":"value1","key2":123},[1,2,3,4,5]]
    }
}

使用注解控制序列化

Fastjson提供了多种注解来控制JSON序列化的行为：

import com.alibaba.fastjson.annotation.JSONField;
import java.util.List;
class UserWithAnnotation {
    @JSONField(name = "username") // 指定JSON中的字段名
    private String name;
    @JSONField(serialize = false) // 不序列化该字段
    private String password;
    @JSONField(format = "yyyy-MM-dd") // 格式化日期字段
    private Date birthDate;
    // 其他代码...
}

处理循环引用

当对象图中存在循环引用时,Fastjson默认会抛出异常，可以通过配置来处理循环引用：

import com.alibaba.fastjson.serializer.SerializerFeature;
String jsonString = JSON.toJSONString(userList, SerializerFeature.DisableCircularReferenceDetect);

注意事项

1. 版本选择：建议使用Fastjson的最新稳定版本，以获得更好的性能和安全性，注意Fastjson 1.2.80及以下版本存在已知的安全漏洞。

2. 性能考虑：对于大量数据的转换，Fastjson的性能表现优异，但仍需注意内存使用情况。

3. 日期处理：默认情况下，Date对象会被转换为时间戳，可以通过自定义日期格式来改变输出格式。

4. null值处理：默认情况下，Fastjson会序列化null值，可以通过配置来忽略null值：

String jsonString = JSON.toJSONString(userList, SerializerFeature.WriteMapNullValue);

5. 类型安全：在反序列化时，确保目标类型与JSON数据结构匹配，否则可能抛出异常。

Fastjson提供了简单而强大的API来实现List到JSON的转换,无论是简单的字符串List，还是包含复杂对象的嵌套结构，Fastjson都能高效处理，通过合理使用其提供的配置选项和注解，可以灵活控制JSON输出的格式和行为，在实际开发中，建议根据具体需求选择合适的序列化配置，并注意版本安全更新。

Fastjson的List转JSON技巧,将有助于提高Java应用中数据处理的效率和可靠性，特别是在需要与前端或其他系统进行JSON数据交互的场景中。