Fastjson2 全面使用指南（Java后端开发者版）

最新推荐文章于 2025-11-24 16:00:00 发布
原创 最新推荐文章于 2025-11-24 16:00:00 发布 · 1k 阅读 · 13 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#java #开发语言

Fastjson2 全面使用指南（Java后端开发者版）

一、基础使用

1. Parse JSON into JSONObject

import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONObject;

public class JSONObjectExample {
    public static void main(String[] args) {
        // 定义JSON字符串
        String jsonStr = "{\"name\":\"张三\", \"age\": 30, \"isStudent\": false}";
        
        // 将JSON字符串解析为JSONObject对象
        JSONObject jsonObject = JSON.parseObject(jsonStr);  // 直接解析为JSONObject类型 
        
        // 获取字段值
        String name = jsonObject.getString("name");  // 返回"张三"
        int age = jsonObject.getInteger("age");      // 返回30
        boolean isStudent = jsonObject.getBoolean("isStudent"); // 返回false
        
        System.out.println("姓名: " + name);
        System.out.println("年龄: " + age);
        System.out.println("是否学生: " + isStudent);
    }
}

2. Parse JSON into JSONArray

import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONArray;

public class JSONArrayExample {
    public static void main(String[] args) {
        // 定义JSON数组字符串
        String jsonArrayStr = "[{\"name\":\"张三\",\"age\":30}, {\"name\":\"李四\",\"age\":25}]";
        
        // 将JSON字符串解析为JSONArray对象
        JSONArray jsonArray = JSON.parseArray(jsonArrayStr);  // 直接解析为JSONArray类型 
        
        // 遍历数组
        for (int i = 0; i < jsonArray.size(); i++) {
            JSONObject item = jsonArray.getJSONObject(i);  // 获取每个JSON对象
            String name = item.getString("name");
            int age = item.getInteger("age");
            System.out.println("第" + (i+1) + "个用户: " + name + ", 年龄: " + age);
        }
    }
}

3. Parse JSON into a Java Object

import com.alibaba.fastjson2.JSON;

class Student {
    private String name;
    private int age;
    private boolean isStudent;
    
    // getter/setter方法（Lombok可简化）
    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 boolean isStudent() { return isStudent; }
    public void setStudent(boolean student) { isStudent = student; }
}

public class JavaObjectParseExample {
    public static void main(String[] args) {
        String jsonStr = "{\"name\":\"王五\", \"age\": 22, \"isStudent\": true}";
        
        // 将JSON字符串解析为Student对象
        Student student = JSON.parseObject(jsonStr, Student.class);  // 指定目标类类型 
        
        System.out.println("学生姓名: " + student.getName());
        System.out.println("年龄: " + student.getAge());
        System.out.println("是否学生: " + student.isStudent());
    }
}

4. Serialization Java Object to JSON

import com.alibaba.fastjson2.JSON;

public class ObjectToJsonExample {
    public static void main(String[] args) {
        Student student = new Student();
        student.setName("赵六");
        student.setAge(24);
        student.setStudent(true);
        
        // 将Java对象序列化为JSON字符串
        String jsonStr = JSON.toJSONString(student);  // 默认格式化输出 
        
        System.out.println("序列化后的JSON: " + jsonStr);
        // 输出: {"name":"赵六","age":24,"isStudent":true}
    }
}

5. Use JSONObject, JSONArray

import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONArray;
import com.alibaba.fastjson2.JSONObject;

public class JSONObjectArrayUsage {
    public static void main(String[] args) {
        // 创建JSONObject
        JSONObject user = new JSONObject();
        user.put("name", "张三");
        user.put("age", 30);
        user.put("address", new JSONObject().put("city", "北京").put("street", "中关村"));
        
        // 创建JSONArray
        JSONArray hobbies = new JSONArray();
        hobbies.add("篮球");
        hobbies.add("编程");
        hobbies.add("旅行");
        
        // 添加到JSONObject
        user.put("hobbies", hobbies);
        
        // 转换为JSON字符串
        String jsonString = user.toJSONString();  // 转换为标准JSON字符串 
        
        System.out.println("构建的JSON: " + jsonString);
        // 输出: {"name":"张三","age":30,"address":{"city":"北京","street":"中关村"},"hobbies":["篮球","编程","旅行"]}
    }
}

6. Serialize JavaBean to JSON

import com.alibaba.fastjson2.JSON;

class Employee {
    private String name;
    private int id;
    private double salary;
    
    // getter/setter
}

public class JavaBeanToJsonExample {
    public static void main(String[] args) {
        Employee emp = new Employee();
        emp.setName("李四");
        emp.setId(1001);
        emp.setSalary(15000.5);
        
        // 序列化JavaBean为JSON
        String json = JSON.toJSONString(emp);
        
        // 配置序列化选项（例如不输出null值）
        String jsonWithoutNull = JSON.toJSONString(emp, 
            JSONWriter.Feature.WriteNulls,  // 不输出null字段
            JSONWriter.Feature.PrettyFormat // 格式化输出
        );
        
        System.out.println("默认序列化: " + json);
        System.out.println("优化后序列化: " + jsonWithoutNull);
    }
}

二、高级使用

1. Serialize JavaBean to JSONB

import com.alibaba.fastjson2.JSONB;

public class JSONBSerializationExample {
    public static void main(String[] args) {
        Employee emp = new Employee();
        emp.setName("王五");
        emp.setId(1002);
        emp.setSalary(20000.0);
        
        // 将JavaBean序列化为JSONB二进制格式
        byte[] jsonbBytes = JSONB.toBytes(emp);  // 二进制格式，体积更小性能更高 
        
        System.out.println("JSONB二进制数据长度: " + jsonbBytes.length);
        // 输出: JSONB二进制数据长度: 28（具体长度取决于数据）
    }
}

2. Parse JSONB to JavaBean

import com.alibaba.fastjson2.JSONB;

public class JSONBDeserializationExample {
    public static void main(String[] args) {
        // 假设已有JSONB二进制数据
        byte[] jsonbBytes = { /* ... */ };
        
        // 将JSONB二进制数据反序列化为Employee对象
        Employee emp = JSONB.parseObject(jsonbBytes, Employee.class);  // 支持JSONB协议的反序列化 
        
        System.out.println("反序列化后的员工姓名: " + emp.getName());
        System.out.println("ID: " + emp.getId());
        System.out.println("薪资: " + emp.getSalary());
    }
}

3. Use JSONPath to read partial data

import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONPath;

public class JSONPathExample {
    public static void main(String[] args) {
        String json = "{\"user\":{\"name\":\"张三\",\"age\":30,\"address\":{\"city\":\"北京\",\"street\":\"中关村\"}}}";
        
        // 使用JSONPath提取特定字段
        String name = JSONPath.read(json, "$.user.name").toString();  // 返回"张三" 
        int age = JSONPath.read(json, "$.user.age");  // 返回30
        String city = JSONPath.read(json, "$.user.address.city").toString(); // 返回"北京"
        
        System.out.println("姓名: " + name);
        System.out.println("年龄: " + age);
        System.out.println("城市: " + city);
        
        // 提取数组中的元素
        String arrayJson = "[{\"id\":1,\"name\":\"A\"}, {\"id\":2,\"name\":\"B\"}]";
        String secondName = JSONPath.read(arrayJson, "$[1].name").toString(); // 返回"B"
        System.out.println("数组第二个元素的name: " + secondName);
    }
}

4. Read part of byte[] data using JSONPath

import com.alibaba.fastjson2.JSONB;
import com.alibaba.fastjson2.JSONPath;

public class JSONPathByteExample {
    public static void main(String[] args) {
        // 创建JSONB二进制数据
        Employee emp = new Employee();
        emp.setName("李四");
        emp.setId(1003);
        emp.setSalary(18000.0);
        byte[] jsonbBytes = JSONB.toBytes(emp);
        
        // 使用JSONPath从二进制数据中读取特定字段
        String name = JSONPath.read(jsonbBytes, "$.name").toString();  // 直接从byte[]中读取 
        double salary = JSONPath.read(jsonbBytes, "$.salary");  // 返回18000.0
        
        System.out.println("姓名: " + name);
        System.out.println("薪资: " + salary);
    }
}

5. 高级JSONPath应用场景

import com.alibaba.fastjson2.JSONPath;

public class AdvancedJSONPath {
    public static void main(String[] args) {
        String json = "{\"employees\":[{\"name\":\"张三\",\"age\":30},{\"name\":\"李四\",\"age\":25}]}";
        
        // 复杂路径查询
        Object names = JSONPath.read(json, "$.employees[*].name");  // 返回["张三","李四"]的List
        Object ages = JSONPath.read(json, "$.employees[?(@.age>28)].name"); // 返回["张三"]
        
        System.out.println("所有员工姓名: " + names);
        System.out.println("年龄大于28的员工: " + ages);
        
        // 多字段查询
        Object result = JSONPath.read(json, "$.employees[?(@.age>25)].{name,age}");
        System.out.println("多字段查询结果: " + result);
    }
}

三、使用建议与最佳实践

1. 性能优化建议

  • 大数据量场景：使用BeanToArray特性减少JSON体积，可提升20%以上序列化性能
  • 二进制格式：在内部系统通信中优先使用JSONB格式，比JSON字符串节省30%~50%空间
  • 避免默认序列化：使用JSONWriter.Feature自定义序列化选项，例如：
    String json = JSON.toJSONString(obj, 
    JSONWriter.Feature.WriteNulls,    // 保留null字段
    JSONWriter.Feature.PrettyFormat,  // 格式化输出
    JSONWriter.Feature.WriteClassName // 保留类名信息
);

2. 泛型处理规范

  • 非泛型对象：直接使用JSON.parseObject(json, Class.class)
  • 泛型集合：必须使用TypeReference处理，例如：
    Type listType = new TypeReference<List<Employee>>(){}.getType();
List<Employee> list = JSON.parseObject(jsonStr, listType);

3. 安全使用规范

  • JSONPath注入防护：对不可信的JSONPath表达式进行白名单过滤
  • 反序列化安全：使用JSONReader.Feature.SupportAutoType时需谨慎，建议设置白名单
  • 敏感字段处理：使用@JSONField(serialize = false)注解排除敏感字段

4. 特性配置推荐

// 全局配置示例（适用于Spring Boot）
@Bean
public JSONFactory jsonFactory() {
    return new JSONFactory()
        .setFeature(JSONWriter.Feature.WriteNulls, false)  // 不输出null字段
        .setFeature(JSONWriter.Feature.MapSortField, true) // 保持字段顺序
        .setFeature(JSONWriter.Feature.BeanToArray, true); // 大数据量场景优化
}

5. 版本选择建议

  • 生产环境：使用最新稳定版（当前为2.0.45+）
  • 兼容性考虑：若需兼容旧版Fastjson，注意JSON.parseObject与JSON.parse的区别
  • Spring Boot集成：通过@EnableAutoConfiguration(exclude = FastjsonAutoConfiguration.class)排除默认配置

重要提示：所有序列化/反序列化操作应始终指定目标类型，避免使用Object类型接收，防止潜在的安全风险。对于复杂对象图，建议使用JSONB格式并启用WriteClassName特性确保类型安全

从美团Sonic的成功应用深入理解Java热部署
张彦峰的博客
06-03 5万+
本文探讨了Java热部署技术的基本概念及其实际应用，重点分析了美团在开发过程中使用Sonic热部署框架的经验。通过实现无缝更新，热部署显著提升了开发效率和用户体验，减少了系统停机时间。美团的实践案例展示了热部署在大规模分布式系统中的应用价值，为企业在敏捷开发与持续交付方面提供了有效的借鉴。随着技术的不断进步，热部署将在软件开发中发挥愈加重要的作用。
Fastjson2 全面使用指南（Java后端开发者专用）
python15397的博客
11-07 703
Fastjson2 是阿里巴巴推出的高性能 JSON 处理库，相比 fastjson 1.x 在性能、安全性和功能上均有显著提升。它支持 JSONB 二进制格式、JSONPath 查询、流式处理等特性，兼容 Jackson/Spring 注解规范。基础用法包括 JSON 与 Java 对象的相互转换、JSONObject/JSONArray 的动态操作，以及日期格式等高级配置。进阶功能涵盖 JSONB 二进制处理、JSONPath 数据查询和流式读写工具类（JSONWriter/JSONReader）。通过
FastJSON2 完全使用指南（Java 后端开发实战版）
python15397的博客
11-07 868
FastJSON2是阿里巴巴开源的高性能JSON处理库，本文提供了完整的Java后端开发使用指南。主要包括： Maven依赖引入和Spring Boot替换Jackson的配置方式； 常见使用场景：JSON字符串解析为JSONObject/JSONArray/POJO、Java对象序列化； 动态构建JSON数据； 特性说明：支持泛型、忽略大小写、格式化输出等。该库性能优异，适合高并发场景，是Spring Boot项目中推荐的JSON处理方案之一。
FastJson2 标准使用指南（企业级 Java 后端开发规范版）
python15397的博客
10-15 1279
企业级 FastJson2 标准使用指南，针对 Java 后端开发场景，提供安全、高效的 JSON 处理规范。指南涵盖基础序列化/反序列化操作，强调类型安全与性能优先原则。核心要点包括：推荐使用 JSON.toJSONString() 进行序列化，避免 null 值输出；反序列化时必须指定目标类型（如 User.class），禁止使用无类型解析；处理集合时采用 JSON.parseType() 解决泛型擦除问题。所有示例均结合实际业务场景，确保代码可维护性，适用于 Spring Boot 微服务、REST
Spring Boot 3 中使用 FastJson2 替换 Jackson 的完整实施指南（企业级实战版）
python15397的博客
10-15 915
Spring Boot 3 FastJson2替换Jackson实施指南摘要 本文提供Spring Boot 3项目中用FastJson2替代Jackson的完整方案，重点包含： 性能优势：FastJson2序列化速度提升150%，内存占用更低，适合高并发场景 依赖配置：必须排除spring-boot-starter-json并引入fastjson2-extension-spring6 全局配置：通过@PostConstruct统一设置日期格式、空值处理和数值格式化 安全规范：默认禁用autoType，防止
Fastjson2 vs. Jackson：Java JSON 解析库对比与选型指南
qq_57300198的博客
07-14 1253
Fastjson2 vs. Jackson：Java JSON 解析库对比与选型指南
Java后端最全技术栈指南，学完就当架构师
m0_72885838的博客
07-21 4009
，进行处理。binlog是实时增量工具，ETL工具做辅助。通常一个数据同步功能，需要多个组件的参与，他们共同组成一个整体。
Java工程师学习指南（2019最新版）
热门推荐
Java技术江湖
01-08 1万+
写过一个Java工程师学习指南，我把它分为了四个部分，第一步是打好Java基础，掌握Java核心技术，第二步是掌握Java Web技术栈，能够做一些项目，第三步是掌握Java方面的进阶技术，包括网络编程、并发编程、JVM等，第四步是掌握后端进阶技术，比如分布式、缓存、消息队列等技术。 按照这样的一个脉络，我觉得能够掌握这里面的绝大部分内容，并且有过相应的一些实践，那么可以算是学好了Java...
Fastjson 1.2.26 API功能详解与使用指南
Fastjson 1.2.26 是阿里巴巴开源的一款高性能的 JSON 序列化与反序列化 Java 库，广泛应用于各类 Java 开发项目中，尤其是在微服务架构、分布式系统以及 Web 后端开发中扮演着至关重要的角色。该版本（1.2.26）发布...
Java后端开发速成学习路线与实战项目指南
该路线以“理论+实践”为核心理念，强调通过真实项目驱动学习，并结合主流框架与工具链，全面提升开发者的技术栈深度和工程化能力。 路线的第一阶段是**Java基础**，这是整个后端开发的根基。学习内容包括但不限于...
Java后端技术概览
weixin_33719619的博客
05-14 1134
一个合格的Java后端工程师需要掌握哪些技能呢？扫描下面的二维码可以看到Java后端技术概览图。 软件开发的核心原则 此处所说的是软件开发应该遵循的一些核心原则： Don't Repeat Yourself: 这是软件开发的一个基础原则，即不要做重复性劳动。也是现在所说的“极客文化”的一种。代码重复、工作重复在软件开发中都是不合理的存在。利用各种手段消除这些重复是软件开发的一个核心工作准则。 ...
Alibaba Fastjson Jar包下载指南
7. 集成Fastjson jar包：为了在Java项目中使用Fastjson，开发者需要将Fastjson jar包添加到项目的类路径中。在Maven或Gradle构建的项目中，这通常通过在构建配置文件中添加相应的依赖项来完成。对于非构建工具管理的...
SSM企业物资管理系统h3109(程序+源码+数据库+调试部署+开发环境)带论文文档1万字以上，文末可获取，系统界面在最后面
2509_93102542的博客
11-21 760
在技术实现上，国外多采用成熟的开发框架和技术架构，注重系统的安全性、稳定性和可扩展性，同时积极融入大数据、人工智能等新技术，实现物资需求预测、智能库存优化等功能。基于此，开发一套基于SSM框架的企业物资管理系统，整合部门、员工、物资及各类业务流程管理功能，实现物资管理的数字化、规范化和高效化，成为解决企业物资管理痛点的必然需求。本课题旨在开发一套基于SSM框架的企业物资管理系统，围绕部门、员工、物资信息、物资申请、消息提醒、物资归还、物资入库、意见反馈八大核心功能模块，实现企业物资管理的全流程数字化。
Java原生网络编程-BIO与NIO
照母山挖洋芋
11-24 350
摘要：本文对比了Java原生JDK中的BIO(阻塞I/O)和NIO(非阻塞I/O)网络编程模型。BIO采用"一连接一线程"模式，存在线程资源浪费和性能瓶颈问题，可通过线程池优化为伪异步I/O模型。NIO通过Selector、Channel和Buffer三大核心组件实现非阻塞通信，支持单线程管理多个通道。重点介绍了NIO的Reactor模式、事件类型(OP_READ/OP_WRITE等)及服务端/客户端的不同关注点，展示了NIO相比BIO在高并发场景下的优势。（149字）
spring全局懒加载(default-lazy-init)导致的afterPropertiesSet不执行问题
豆豆的博客
11-21 493
Spring配置default-lazy-init="true"会导致所有Bean延迟初始化，影响afterPropertiesSet方法的执行时机。解决方案包括：1)为关键Bean显式设置lazy-init="false"；2)使用@Lazy(false)注解；3)编程式强制初始化；4)使用DependsOn控制顺序。最佳实践建议分层配置策略，核心组件立即初始化，业务组件懒加载，并通过配置文件分离和环境区分优化配置。实际应用中，Web应用的请求处理相关Bean和批处
Java集合框架实战：构建高效的企业管理系统
2402_83075343的博客
11-23 682
本文通过两个企业管理系统案例，详细解析了Java集合框架的核心应用。员工部门管理系统采用HashMap实现部门与员工的高效映射，具备智能添加、快速查询和动态统计功能；商品库存管理系统基于ArrayList实现精细化管控，包含智能录入、库存预警和价格排序等特性。文章对比了HashMap和ArrayList的特性差异，提供了集合选型的最佳实践，并探讨了系统扩展方向。这两个实战案例展示了集合框架在企业应用中的实际价值，为开发者掌握Java集合提供了实用参考。
Spring Boot 中使用 @Transactional 注解配置事务管理
2509_94007314的博客
11-21 1253
下面分别介绍一下的几个属性。
Springboot | Spring Boot 3 纯 JDBC 实现宠物管理系统增删改查（无 ORM 框架）
最新发布
张较瘦
11-24 490
本文介绍了基于Spring Boot 3和纯JDBC实现的宠物管理系统CRUD操作。通过原生JDBC方式，不使用任何ORM框架，帮助开发者深入理解底层数据库操作原理。文章详细说明了环境准备（JDK17+、Spring Boot 3.2.x、MySQL 8.0）、项目依赖配置、数据库连接设置以及表结构创建。核心实现包括：Pet实体类定义（包含id、name、breed和age字段）以及PetService服务层，利用JdbcTemplate封装增删改查操作，重点演示了如何通过PreparedStatement
2025最新 SpringCloud 教程，教程简介，笔记01
Rockandrollman的博客
11-24 31
2025最新 SpringCloud 教程，教程简介，笔记01
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

龙茶清欢

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值