快捷導(dǎo)航

@JsonProperty和@JSONField注解的區(qū)別解析(最新)

更新時(shí)間：2024年04月01日 11:15:17 作者：四問四不知

Jackson是一款優(yōu)秀的JSON解析庫,添加了依賴之后就可以使用對應(yīng)的注解,讓我們能夠自由的將Java對象和JSON做轉(zhuǎn)換,這篇文章主要介紹了@JsonProperty和@JSONField注解的區(qū)別,需要的朋友可以參考下

JSON（JavaScript Object Notation）

json是一種常見的數(shù)據(jù)交換的輕量級數(shù)據(jù)格式。HTTP協(xié)議傳輸數(shù)據(jù)可以有多種數(shù)據(jù)格式，比如下面幾種常見數(shù)據(jù)傳輸格式，除此之外還有其他的數(shù)據(jù)交換格式。

數(shù)據(jù)傳輸類型	編碼類型	示例
表單格式	application/x-www-form-urlencoded	`username=zk&password=123`
JSON（JavaScript Object Notation）	application/json	`{"username": "zk","password": "123"}`
XML（eXtensible Markup Language）	application/xml	`<user><username>zk</username><password>123</password></user>`

Jackson

Jackson是一款優(yōu)秀的JSON解析庫，添加了依賴之后就可以使用對應(yīng)的注解，讓我們能夠自由的將Java對象和JSON做轉(zhuǎn)換。

比如Java對象轉(zhuǎn)JSON

@JsonProperty和@JSONField

為了解決JSON字符串和其實(shí)體bean的屬性名匹配不上的問題，@JsonProperty和@JSONField都可以將某一屬性名序列化為另一屬性名。

那么@JsonProperty和@JSONField有什么區(qū)別呢？

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.annotation.JSONField;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.hust.zhang.serializable.JsonUtils;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
public class JsonPropertiesVsJsonField {
    @AllArgsConstructor
    @Data
    @Builder
    static class Properties {
        @JsonProperty(value = "json-properties")
        private String jsonProperties;
        @JSONField(name = "json-field")
        private String jsonField;
    }
    public static void main(String[] args) {
        Properties properties = Properties.builder()
                .jsonProperties("test-properties")
                .jsonField("test-field")
                .build();
        System.out.println(JsonUtils.toJson(properties));
        System.out.println(JSON.toJSONString(properties));
    }
}

輸出結(jié)果如下，

{"jsonField":"test-field","json-properties":"test-properties"}
{"json-field":"test-field","jsonProperties":"test-properties"}

可以看到調(diào)用JsonUtils.toJson方法時(shí)，加了@JsonProperty才與bean實(shí)際屬性名匹配。
其中該方法定義如下，ObjectMapper的writeValueAsString方法。

/**
 * Json轉(zhuǎn)換工具類
 */
@Slf4j
public final class JsonUtils {
    /**
     * 私有無參構(gòu)造方法 常量類不能實(shí)例化，直接引用
     */
    private JsonUtils() {
    }
    private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();
    static {
        OBJECT_MAPPER.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
        OBJECT_MAPPER.configure(JsonReadFeature.ALLOW_UNESCAPED_CONTROL_CHARS.mappedFeature(), true);
    }
    public static String toJson(Object object) {
        try {
            return OBJECT_MAPPER.writeValueAsString(object);
        } catch (JsonProcessingException e) {
            log.error("Failed to write the object to string" + object.getClass().getName());
            return null;
        }
    }
    public static <T>T parse(String json, Class<T> tClass){
        try {
            return OBJECT_MAPPER.readValue(json,tClass);
        } catch (JsonProcessingException e) {
            log.error("Failed to deserialize JSON content, json value : " + json);
            return null;
        }
    }
}

除此之外還可以看看@JsonAlias注解。