快捷導(dǎo)航

使用Jackson進(jìn)行JSON生成與解析的新手指南

更新時(shí)間：2025年04月04日 08:25:39 作者：五行星辰

這篇文章主要為大家詳細(xì)介紹了如何使用Jackson進(jìn)行JSON生成與解析處理,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下

1. 核心依賴

Spring Boot 默認(rèn)集成 Jackson，無(wú)需額外依賴：

<!-- 如果使用 Spring Boot Starter Web -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

2. 基礎(chǔ)用法

2.1 對(duì)象轉(zhuǎn) JSON（序列化）

ObjectMapper mapper = new ObjectMapper();
User user = new User("張三", 25);
String json = mapper.writeValueAsString(user);
// 輸出：{"name":"張三","age":25}

2.2 JSON 轉(zhuǎn)對(duì)象（反序列化）

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)  // 非空時(shí)序列化
    private String email;
}

3.2 時(shí)間格式

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)  // 日期不轉(zhuǎn)時(shí)間戳
            .enable(DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT)
            .setSerializationInclusion(JsonInclude.Include.NON_NULL);
    }
}

4.2 配置項(xiàng)示例

# 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. 高級(jí)技巧

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  // 序列化時(shí)使用 code
    OK(1), ERROR(2);

    private final int code;
    // 反序列化時(shí)根據(jù) code 轉(zhuǎn)換
    @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. 安全注意事項(xiàng)

8.1 防止 XXE 攻擊

mapper.configure(JsonParser.Feature.ALLOW_EXTERNAL_PROCESSING, false);

8.2 反序列化防護(hù)

// 啟用類型檢查
mapper.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL);
// 或使用注解 @JsonTypeInfo

最佳實(shí)踐總結(jié)

統(tǒng)一配置：通過 ObjectMapper 全局配置確保一致性
合理使用注解：避免過度注解導(dǎo)致代碼污染
性能監(jiān)控：對(duì)高頻接口進(jìn)行序列化性能測(cè)試
版本管理：及時(shí)升級(jí) Jackson 版本修復(fù)漏洞

通過以上方法，可以高效安全地處理 JSON 數(shù)據(jù)。

到此這篇關(guān)于使用Jackson進(jìn)行JSON生成與解析的新手指南的文章就介紹到這了,更多相關(guān)Jackson處理JSON內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

Jackson
JSON

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线