说明：fastjson2是一个性能极致并且简单易用的Java JSON库（官方语），本文介绍在Spring Boot项目中如何使用fastjson2。
创建项目
首先，创建一个Maven项目，引入fastjson2依赖，如下：
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.12</version> <relativePath/> </parent> <groupId>com.hezy</groupId> <artifactId>fastjson2_demo</artifactId> <version>1.0-SNAPSHOT</version> <name>Archetype - fastjson2_demo</name> <url>http://maven.apache.org</url> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> </dependency> <!--fastjson2依赖--> <dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2</artifactId> <version>2.0.50</version> </dependency> </dependencies> </project>
创建一个实体类对象，User
import lombok.*; import java.io.Serializable; @Data public class User implements Serializable { /** * id */ private String id; /** * 证件号 */ private String cardNo; /** * 手机号 */ private String phone; /** * 姓名 */ private String name; /** * 用户名 */ private String username; /** * 密码 */ private String password; }
这里需要注意对象需要实现Serializable 接口，表示该对象实例能被序列化，另外对象需要有全参构造、无参构造（@Data注解自动生成），在分布式项目中，服务之间传输对象（如Dubbo、MQ）底层实现依赖于对象的全参构造，如果对象没有全参构造方法会报错的。
还有，严格来说，对象需要设置一个序列化版本ID，不设置Java虚拟机会自动为其设置。但如果在序列化之后，改动过对象的属性，那么自动设置的序列化版本ID会发生改变，这时候再去反序列化原来生成过的JavaBean数据（如文本、xml文件、缓存中的）就会报错。
private static final long serialVersionUID = 1L
这里只是一个Demo，就不讲究了。
使用
先创建一些变量，如下：
static User user; static String userJson = "{\"id\":\"10001\",\"cardNo\":\"123456194910014896\",\"phone\":\"12345678901\",\"name\":\"hezy\",\"username\":\"hezy\",\"password\":\"123456\"}"; static byte[] userJsonBytes = userJson.getBytes(); static String userJsonArray = "[{\"id\":\"10001\",\"cardNo\":\"123456194910014896\",\"phone\":\"12345678901\",\"name\":\"hezy\",\"username\":\"hezy\",\"password\":\"123456\"}]"; static { user = new User(); user.setId("10001"); user.setCardNo("123456194910014896"); user.setPhone("12345678901"); user.setName("hezy"); user.setUsername("hezy"); user.setPassword("123456"); }
2.1将JSON解析为JSONObject
/** * 2.1将JSON解析为JSONObject */ @Test public void jsonToJSONObject() { JSONObject jsonObject1 = JSON.parseObject(userJson); System.out.println(jsonObject1); JSONObject jsonObject2 = JSON.parseObject(userJsonBytes); System.out.println(jsonObject2); }
2.2 将JSON解析为JSONArray
/** * 2.2将JSON解析为JSONArray */ @Test public void jsonToJSONArray() { JSONArray jsonArray = JSON.parseArray(userJsonArray); System.out.println(jsonArray.get(0)); }
2.3 将JSON解析为Java对象
/** * 2.3 将JSON解析为Java对象 */ @Test public void jsonToJavaBean() { User userBean = JSON.parseObject(userJson, User.class); System.out.println(userBean); }
2.4 将Java对象序列化为JSON
/** * 2.4 将Java对象序列化为JSON */ @Test public void javaBeanToJson() { String jsonString = JSON.toJSONString(user); System.out.println(jsonString); byte[] jsonBytes = JSON.toJSONBytes(userJsonBytes); System.out.println(jsonBytes); }
2.5 使用JSONObject、JSONArray
2.5.1 获取简单属性
/** * 2.5.1 使用JSONObject、JSONArray * 获取简单属性 */ @Test public void getValue() { JSONObject jsonObject = JSON.parseObject(userJson); String username = jsonObject.getString("username"); System.out.println(username); }
2.5.2 读取JavaBean
/** * 2.5.2 使用JSONObject、JSONArray * 读取JavaBean */ @Test public void getJavaBean() { JSONArray jsonArray = JSON.parseArray(userJsonArray); JSONObject jsonObject = JSON.parseObject(userJson); User userBean = jsonArray.getObject(0, User.class); System.out.println(userBean); // 这里也可以换成自定义对象，就是说支持读取对象中的对象 String username = jsonObject.getObject("username", String.class); System.out.println(username); }
2.5.3 转为JavaBean
/** * 2.5.3 使用JSONObject、JSONArray * 转为JavaBean */ @Test public void toJavaBean() { JSONArray jsonArray = JSON.parseArray(userJsonArray); JSONObject jsonObject = JSON.parseObject(userJson); User user = jsonObject.toJavaObject(User.class); System.out.println(user); List<User> users = jsonArray.toJavaList(User.class); System.out.println(users); }
2.6 将JavaBean对象序列化为JSON
/** * 2.6 将JavaBean对象序列化为JSON */ @Test public void javaBeanObjectToJson() { String jsonString = JSON.toJSONString(user); System.out.println(jsonString); byte[] jsonBytes = JSON.toJSONBytes(user); System.out.println(jsonBytes); }
相关注解
-
@JsonIgnore：序列化时排除该属性，详情参考：排除对象属性序列化的三种方式
-
@JSONType(orders = {})：定义序列化时的属性顺序；
@Data @JSONType(orders = {"id", "cardNo", "phone", "name", "username", "password"}) public class User implements Serializable { …… }
如上面2.6方法，加上上面的注解后重新启动，结果如下，序列化后属性顺序改变了：
- @JSONField(name = “”)：指定该属性序列化时的名称；
/** * 姓名 */ @JSONField(name = "realName") private String name;
如上面2.6方法，加上注解后重新启动，结果如下，序列化后的name变为realName
- @JsonFormat(pattern = “yyyy-MM-dd”, timezone = “GMT+8”)：日期格式化成
yyyy-MM-dd，时区为东八区；
创建一个日期属性，如下：
/** * 生日 */ @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8") private Date birthday;
赋值，当前日期
user.setBirthday(new Date());
打印序列化前后的内容
/** * 2.6 将JavaBean对象序列化为JSON */ @Test public void javaBeanObjectToJson() { System.out.println(user); String jsonString = JSON.toJSONString(user); System.out.println(jsonString); }
可以看到日期格式发生了改变
总结
集中去看API毫无意义，因为看了、敲了，用的时候也会忘，而且这些API名称看起来都差不多，不好区分。用的时候再去查（源码、百度、GPT）也都来得及，后面的注解值得一看。
