阿里json怎么把对象转成json

阿里巴巴FastJSON：轻松实现Java对象与JSON字符串的转换

在现代Java开发中,JSON（JavaScript Object Notation）已成为数据交换的事实标准，无论是与前端进行数据交互，还是调用第三方API，我们都需要频繁地在Java对象和JSON字符串之间进行转换，阿里巴巴开源的FastJSON库，以其简洁的API和高效的性能，成为了广大开发者的首选工具之一，本文将详细介绍如何使用FastJSON将一个Java对象转换成JSON字符串。

准备工作：添加FastJSON依赖

在使用FastJSON之前,首先需要将它的依赖添加到你的项目中，如果你使用的是Maven项目，请在pom.xml文件中添加以下依赖：

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

如果你使用的是Gradle,则在build.gradle文件中添加：

implementation 'com.alibaba:fastjson:1.2.83'

添加完依赖后,你的项目就可以使用FastJSON强大的功能了。

核心方法：JSON.toJSONString()

FastJSON将对象转换为JSON字符串的核心方法是 com.alibaba.fastjson.JSON 类中的静态方法 toJSONString()，这个方法非常智能，能够处理绝大多数常见的Java对象。

该方法的基本签名如下：

public static String toJSONString(Object object);

它接收一个Java对象作为参数,并返回一个JSON格式的字符串。

实战演练：对象转JSON

下面我们通过几个常见的场景来演示如何使用toJSONString()。

场景1：转换简单的POJO（普通Java对象）

假设我们有一个用户信息类User，我们想将它转换为JSON字符串。

定义JavaBean：

public class User {
    private String name;
    private int age;
    private String email;
    // 构造方法、Getter和Setter是必须的
    public User() {}
    public User(String name, int age, String email) {
        this.name = name;
        this.age = age;
        this.email = email;
    }
    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; }
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
    // 重写toString()方法，方便在控制台打印对象内容
    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                ", email='" + email + '\'' +
                '}';
    }
}

进行转换：

import com.alibaba.fastjson.JSON;
public class Main {
    public static void main(String[] args) {
        // 1. 创建一个User对象
        User user = new User("张三", 30, "zhangsan@example.com");
        // 2. 使用JSON.toJSONString()方法将对象转换为JSON字符串
        String jsonString = JSON.toJSONString(user);
        // 3. 输出结果
        System.out.println(jsonString);
    }
}

运行结果：

{"age":30,"email":"zhangsan@example.com","name":"张三"}

可以看到,FastJSON自动将User对象的属性名作为JSON的键，属性值作为对应的值，并生成了一个格式规范的JSON字符串。

场景2：转换包含集合的复杂对象

现实应用中,对象之间常常包含关联关系，一个Department（部门）对象可能包含一个List<User>（员工列表）。

定义复杂JavaBean：

import java.util.List;
public class Department {
    private String departmentName;
    private List<User> employees;
    // 构造方法、Getter和Setter
    public Department() {}
    public Department(String departmentName, List<User> employees) {
        this.departmentName = departmentName;
        this.employees = employees;
    }
    public String getDepartmentName() { return departmentName; }
    public void setDepartmentName(String departmentName) { this.departmentName = departmentName; }
    public List<User> getEmployees() { return employees; }
    public void setEmployees(List<User> employees) { this.employees = employees; }
}

进行转换：

import com.alibaba.fastjson.JSON;
import java.util.Arrays;
import java.util.List;
public class Main {
    public static void main(String[] args) {
        // 1. 创建用户列表
        List<User> employees = Arrays.asList(
            new User("张三", 30, "zhangsan@example.com"),
            new User("李四", 28, "lisi@example.com")
        );
        // 2. 创建部门对象，并将用户列表赋值给它
        Department department = new Department("研发部", employees);
        // 3. 将整个部门对象转换为JSON字符串
        String jsonString = JSON.toJSONString(department);
        // 4. 输出结果
        System.out.println(jsonString);
    }
}

运行结果：

{"departmentName":"研发部","employees":[{"age":30,"email":"zhangsan@example.com","name":"张三"},{"age":28,"email":"lisi@example.com","name":"李四"}]}

FastJSON能够递归地处理对象内部的集合和对象,将整个复杂的对象树完美地转换成一个嵌套的JSON结构。

场景3：格式化输出（美化JSON）

默认情况下,toJSONString()生成的JSON字符串是压缩在一行的，不包含任何多余的空格或换行，这在网络传输中可以节省带宽，但在调试或日志记录时，可读性较差，FastJSON提供了重载方法，可以轻松实现JSON的格式化输出。

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.serializer.SerializerFeature;
public class Main {
    public static void main(String[] args) {
        User user = new User("张三", 30, "zhangsan@example.com");
        // 使用 SerializerFeature.PrettyFormat 来美化输出
        String prettyJsonString = JSON.toJSONString(user, SerializerFeature.PrettyFormat);
        System.out.println(prettyJsonString);
    }
}

运行结果（美化后）：

{
    "age":30,
    "email":"zhangsan@example.com",
    "name":"张三"
}

这样,输出的JSON字符串就变得非常清晰易读。SerializerFeature是一个枚举类，提供了多种配置选项，例如WriteMapNullValue（输出值为null的属性）等，你可以根据需要灵活选用。

高级配置与注意事项

1. 日期格式化：默认情况下，Date对象会被转换为一个时间戳数字，如果你希望以特定的格式（如yyyy-MM-dd HH:mm:ss）输出日期，可以使用DateFormat功能。

   String dateJsonString = JSON.toJSONString(user, SerializerFeature.WriteDateUseDateFormat);
   // 或者指定自定义格式
   String dateFormatJsonString = JSON.toJSONStringWithDateFormat(user, "yyyy-MM-dd", SerializerFeature.WriteDateUseDateFormat);

2. 循环引用：如果对象之间存在循环引用（A对象包含B，B对象又包含A），直接转换会导致栈溢出，FastJSON默认会检测循环引用并处理，你通常无需担心。

3. 安全性：FastJSON的早期版本存在一些已知的安全漏洞。强烈建议始终使用最新稳定版本，并关注官方的安全公告。

通过本文的介绍,相信你已经了使用阿里巴巴FastJSON将Java对象转换为JSON字符串的核心方法，其核心API JSON.toJSONString() 非常简洁强大，能够处理从简单POJO到复杂嵌套对象的各种场景，结合SerializerFeature，你还可以轻松实现格式化输出、日期格式化等高级功能，FastJSON，将极大地提升你在处理JSON数据时的开发效率。