使用Jackson進行JSON生成與解析的新手指南
更新時間：2025年04月04日 08:25:39 作者：五行星辰
這篇文章主要為大家詳細介紹了如何使用Jackson進行JSON生成與解析處理,文中的示例代碼講解詳細,感興趣的小伙伴可以跟隨小編一起學習一下
1. 核心依賴
Spring Boot 默認集成 Jackson，無需額外依賴：
<!-- 如果使用 Spring Boot Starter Web -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
2. 基礎用法
2.1 對象轉 JSON（序列化）
ObjectMapper mapper = new ObjectMapper();
User user = new User("張三", 25);
String json = mapper.writeValueAsString(user);
// 輸出：{"name":"張三","age":25}
2.2 JSON 轉對象（反序列化）
String json = "{\"name\":\"李四\",\"age\":30}";
User user = mapper.readValue(json, User.class);
3. 常用注解
3.1 字段控制
public class User {
@JsonProperty("user_name") // 自定義JSON字段名
private String name;
@JsonIgnore // 忽略字段
private String password;
@JsonInclude(JsonInclude.Include.NON_NULL) // 非空時序列化
private String email;
}
3.2 時間格式
public class Order {
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private LocalDateTime createTime;
}
3.3 多態(tài)處理
@JsonTypeInfo(use = Id.NAME, property = "type")
@JsonSubTypes({
@Type(value = Cat.class, name = "cat"),
@Type(value = Dog.class, name = "dog")
})
public abstract class Animal {}
4. 自定義配置（Spring Boot）
4.1 全局配置
@Configuration
public class JacksonConfig {
@Bean
public ObjectMapper objectMapper() {
return new ObjectMapper()
.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS) // 日期不轉時間戳
.enable(DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT)
.setSerializationInclusion(JsonInclude.Include.NON_NULL);
}
}
4.2 配置項示例
# application.yml
spring:
jackson:
date-format: yyyy-MM-dd HH:mm:ss
time-zone: GMT+8
default-property-inclusion: non_null
deserialization:
FAIL_ON_UNKNOWN_PROPERTIES: false # 忽略未知字段
5. 高級技巧
5.1 處理泛型
TypeReference<ResultDTO<List<User>>> typeRef = new TypeReference<>() {};
ResultDTO<List<User>> result = mapper.readValue(json, typeRef);
5.2 流式 API（處理大文件）
JsonFactory factory = mapper.getFactory();
try (JsonParser parser = factory.createParser(new File("large.json"))) {
while (parser.nextToken() != null) {
// 逐條處理
}
}
5.3 自定義序列化器
public class MoneySerializer extends JsonSerializer<BigDecimal> {
@Override
public void serialize(BigDecimal value, JsonGenerator gen, SerializerProvider provider) {
gen.writeString(value.setScale(2, RoundingMode.HALF_UP) + "元");
}
}
// 使用注解
public class Product {
@JsonSerialize(using = MoneySerializer.class)
private BigDecimal price;
}
6. 常見問題解決
6.1 循環(huán)引用問題
// 方法1：使用 @JsonIgnore 打斷循環(huán)
public class Order {
@JsonIgnore
private User user;
}
// 方法2：配置全局忽略
mapper.configure(SerializationFeature.FAIL_ON_SELF_REFERENCES, false);
6.2 枚舉處理
public enum Status {
@JsonValue // 序列化時使用 code
OK(1), ERROR(2);
private final int code;
// 反序列化時根據(jù) code 轉換
@JsonCreator
public static Status fromCode(int code) { /* ... */ }
}
6.3 處理特殊字符
mapper.configure(JsonGenerator.Feature.ESCAPE_NON_ASCII, true);
// 輸入：{"name":"張三"} → 輸出：{"name":"\u5F20\u4E09"}
7. 性能優(yōu)化
7.1 啟用緩存
mapper.enable(MapperFeature.USE_ANNOTATIONS); mapper.enable(MapperFeature.CAN_OVERRIDE_ACCESS_MODIFIERS);
7.2 線程安全配置
ObjectMapper mapper = new ObjectMapper(); // 配置為線程安全 mapper.registerModule(new JavaTimeModule()); mapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);
7.3 使用第三方模塊
<dependency>
<groupId>com.fasterxml.jackson.datatype</groupId>
<artifactId>jackson-datatype-jsr310</artifactId>
</dependency>
ObjectMapper mapper = new ObjectMapper().registerModule(new JavaTimeModule());
8. 安全注意事項
8.1 防止 XXE 攻擊
mapper.configure(JsonParser.Feature.ALLOW_EXTERNAL_PROCESSING, false);
8.2 反序列化防護
// 啟用類型檢查 mapper.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL); // 或使用注解 @JsonTypeInfo
最佳實踐總結
- 統(tǒng)一配置：通過 ObjectMapper 全局配置確保一致性
- 合理使用注解：避免過度注解導致代碼污染
- 性能監(jiān)控：對高頻接口進行序列化性能測試
- 版本管理：及時升級 Jackson 版本修復漏洞
通過以上方法，可以高效安全地處理 JSON 數(shù)據(jù)。
到此這篇關于使用Jackson進行JSON生成與解析的新手指南的文章就介紹到這了,更多相關Jackson處理JSON內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
本篇文章主要介紹了使用Spring Boot集成FastDFS的示例代碼，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-02-02
這篇文章主要介紹了SpringBoot之跨域過濾器配置允許跨域訪問方式，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-07-07
下面小編就為大家?guī)硪黄獪\談Java后臺對JSON格式的處理操作。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2016-06-06
SpringBoot返回對象時,如何將Long類型轉換為String
這篇文章主要介紹了SpringBoot返回對象時,實現(xiàn)將Long類型轉換為String，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-06-06
本文主要介紹了Mybatis使用大于等于或小于等于進行比較，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-03-03
這篇文章主要為大家詳細介紹了Java將文件上傳到ftp服務器，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2022-06-06
spring中的BeanFactory與FactoryBean的講解
今天小編就為大家分享一篇關于spring中的BeanFactory與FactoryBean的講解，小編覺得內容挺不錯的，現(xiàn)在分享給大家，具有很好的參考價值，需要的朋友一起跟隨小編來看看吧2019-01-01
本篇文章主要介紹了java如何實現(xiàn)判斷文件的真實類型，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-08-08
這篇文章主要介紹了Java如何把map分割成多個map,本文通過實例代碼給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友參考下吧2024-08-08
Java底層基于二叉搜索樹實現(xiàn)集合和映射/集合Set功能詳解
這篇文章主要介紹了Java底層基于二叉搜索樹實現(xiàn)集合和映射/集合Set功能,結合實例形式分析了Java使用二叉搜索樹實現(xiàn)集合和映射相關操作技巧,需要的朋友可以參考下2020-03-03