SpringBoot接口自定義序列化

需求背景

在我們寫接口的時(shí)候可能會(huì)有這樣的需求合搅,例如對(duì)于BigDecimal類型的字段有時(shí)候需要顯示到小數(shù)點(diǎn)后兩位兢哭,有時(shí)候需要顯示成百分比不铆,有時(shí)候則取整暂题。

@Data
public class Order {
    /**
     * 訂單號(hào)
     */
    private String orderNo;
    /**
     * 訂單金額,保留兩位小數(shù)
     */
    private BigDecimal orderAmount;
    /**
     * 優(yōu)惠金額丑慎,只保留整數(shù)
     */
    private BigDecimal discountAmount;
    /**
     * 優(yōu)惠百分比喜喂,顯示百分比
     */
    private BigDecimal discountPercent;
}

例如上面的訂單模型瓤摧,我們的訂單金額需要保留兩位小數(shù),優(yōu)惠金額保留整數(shù)玉吁,而優(yōu)惠百分比我們這需要以百分號(hào)的形式顯示出來(lái)照弥,如果我們沒(méi)有做任何特殊處理,最后顯示的效果如下所示:

{
    "orderNo": "20210605091",
    "orderAmount": 100.05,
    "discountAmount": 10.00,
    "discountPercent": 0.10
}

@JsonSerialize和JsonSerializer<T>

通過(guò)查詢資料进副,可以通過(guò)@JsonSerialize和JsonSerializer<T>來(lái)實(shí)現(xiàn)自定義序列化这揣。

public class PercentSerialize extends JsonSerializer<BigDecimal> {
    private final DecimalFormat df = new DecimalFormat("##.00%");
    @Override
    public void serialize(BigDecimal value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        if (value == null){
            gen.writeNull();
        }else {
            gen.writeString(df.format(value));
        }
    }
}

我們通過(guò)繼承JsonSerializer類來(lái)實(shí)現(xiàn)我們自己的序列化要求,這里面的<T>代表的是序列化時(shí)的類型影斑,例如我需要對(duì)Double類型做自定義的序列化那么這個(gè)T就是Double给赞。最后我們只要實(shí)現(xiàn)serialize方法即可,第一個(gè)參數(shù)value就是字段的值矫户,第二個(gè)參數(shù)gen用于生成json內(nèi)容片迅,第三個(gè)參數(shù)暫時(shí)不管。

@Data
public class Order {
    /**
     * 訂單號(hào)
     */
    private String orderNo;
    /**
     * 訂單金額,保留兩位小數(shù)
     */
    private BigDecimal orderAmount;
    /**
     * 優(yōu)惠金額皆辽,只保留整數(shù)
     */
    private BigDecimal discountAmount;
    /**
     * 優(yōu)惠百分比柑蛇,顯示百分比
     */
    @JsonSerialize(using = PercentSerialize.class)
    private BigDecimal discountPercent;
}

在我們的訂單模型類中我們給discountPercent字段加上@JsonSerialize(using = PercentSerialize.class)注解,然后運(yùn)行代碼打印效果如下:

{
    "orderNo": "20210605091",
    "orderAmount": 100.05,
    "discountAmount": 10.00,
    "discountPercent": "10.00%"
}

存在的問(wèn)題

上面貌似已經(jīng)解決了問(wèn)題膳汪,我們只要再寫一個(gè)把BigDecimal顯示成整數(shù)輸出的類即可唯蝶。但是如果我還要輸出別的格式怎么辦呢?難道再寫一個(gè)遗嗽?看來(lái)這種方式也不是很靠譜粘我,哪有沒(méi)有別的更好的方式呢?

如果我能獲取到序列化的那個(gè)字段痹换,我是不是可以在字段上添加一個(gè)注解征字,然后讀取注解中的格式,然后在序列化時(shí)將BigDecimal序列化成我指定的格式就行了娇豫。經(jīng)過(guò)一番查找匙姜,發(fā)現(xiàn)還真有辦法可以獲取到當(dāng)前序列化的字段。

Jackson中提供了一個(gè)ContextualSerializer接口冯痢,我們只要實(shí)現(xiàn)這個(gè)接口就能獲取到當(dāng)前序列化的字段氮昧。

public class BigDecimalSerialize extends JsonSerializer<BigDecimal> implements ContextualSerializer {
    private DecimalFormat df;
    @Override
    public void serialize(BigDecimal value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        if (value == null){
            gen.writeNull();
        }else {
            if (df == null){
                gen.writeNumber(value.setScale(2,BigDecimal.ROUND_HALF_UP));
            }else {
                gen.writeString(df.format(value));
            }
        }
    }
    @Override
    public JsonSerializer<?> createContextual(SerializerProvider prov, BeanProperty property) throws JsonMappingException {
        //判斷beanProperty是不是空
        if (property == null){
            return prov.findNullValueSerializer(property);
        }
        //判斷類型是否是BigDecimal
        if (Objects.equals(property.getType().getRawClass(),BigDecimal.class)){
            JacksonBigDecimal annotation = property.getAnnotation(JacksonBigDecimal.class);
            if (annotation != null){
                String pattern = annotation.pattern();
                df = new DecimalFormat(pattern);
                return this;
            }
        }
        return prov.findValueSerializer (property.getType (), property);
    }
}

然后自定義注解如下:

@Retention(RetentionPolicy.RUNTIME)
@JacksonAnnotationsInside
@JsonSerialize(using = BigDecimalSerialize.class)
public @interface JacksonBigDecimal {
    /**
     * BigDecimal格式,格式標(biāo)準(zhǔn)請(qǐng)參考{@link java.text.DecimalFormat}
     */
    String pattern() default "";
}

訂單模型類中修改如下:

@Data
public class Order {
    /**
     * 訂單號(hào)
     */
    private String orderNo;
    /**
     * 訂單金額,保留兩位小數(shù)
     */
    @JacksonBigDecimal(pattern = "#.##")
    private BigDecimal orderAmount;
    /**
     * 優(yōu)惠金額浦楣,只保留整數(shù)
     */
    @JacksonBigDecimal(pattern = "#")
    private BigDecimal discountAmount;
    /**
     * 優(yōu)惠百分比袖肥,顯示百分比
     */
//    @JsonSerialize(using = PercentSerialize.class)
    @JacksonBigDecimal(pattern = "##.00%")
    private BigDecimal discountPercent;
}

最后輸出的結(jié)果如下:

{
    "orderNo": "20210605091",
    "orderAmount": "100.05",
    "discountAmount": "10",
    "discountPercent": "10.00%"
}

通過(guò)這種方式,我們?cè)谔幚硗环N類型時(shí)將它用不同的方式進(jìn)行JSON輸出振劳。例如我們?cè)谳敵鲇脩舻氖謾C(jī)號(hào)碼時(shí)椎组,我們需要輸出前三位和后四位,中間幾位使用*號(hào)來(lái)代替历恐。對(duì)于這種需求都可以通過(guò)這種方式實(shí)現(xiàn)寸癌。

相關(guān)代碼

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末专筷,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子蒸苇,更是在濱河造成了極大的恐慌磷蛹,老刑警劉巖,帶你破解...
    沈念sama閱讀 217,509評(píng)論 6 504
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件填渠,死亡現(xiàn)場(chǎng)離奇詭異弦聂,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)氛什,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,806評(píng)論 3 394
  • 文/潘曉璐 我一進(jìn)店門莺葫,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人枪眉,你說(shuō)我怎么就攤上這事捺檬。” “怎么了贸铜?”我有些...
    開封第一講書人閱讀 163,875評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵堡纬,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我蒿秦,道長(zhǎng)烤镐,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,441評(píng)論 1 293
  • 正文 為了忘掉前任棍鳖,我火速辦了婚禮炮叶,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘渡处。我一直安慰自己镜悉,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,488評(píng)論 6 392
  • 文/花漫 我一把揭開白布医瘫。 她就那樣靜靜地躺著侣肄,像睡著了一般。 火紅的嫁衣襯著肌膚如雪醇份。 梳的紋絲不亂的頭發(fā)上稼锅,一...
    開封第一講書人閱讀 51,365評(píng)論 1 302
  • 那天,我揣著相機(jī)與錄音僚纷,去河邊找鬼矩距。 笑死,一個(gè)胖子當(dāng)著我的面吹牛畔濒,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播锣咒,決...
    沈念sama閱讀 40,190評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼侵状,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼赞弥!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起趣兄,我...
    開封第一講書人閱讀 39,062評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤绽左,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后艇潭,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體拼窥,經(jīng)...
    沈念sama閱讀 45,500評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,706評(píng)論 3 335
  • 正文 我和宋清朗相戀三年蹋凝,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了鲁纠。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,834評(píng)論 1 347
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡鳍寂,死狀恐怖改含,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情迄汛,我是刑警寧澤捍壤,帶...
    沈念sama閱讀 35,559評(píng)論 5 345
  • 正文 年R本政府宣布,位于F島的核電站鞍爱,受9級(jí)特大地震影響鹃觉,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜睹逃,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,167評(píng)論 3 328
  • 文/蒙蒙 一盗扇、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧唯卖,春花似錦粱玲、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,779評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至橄碾,卻和暖如春卵沉,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背法牲。 一陣腳步聲響...
    開封第一講書人閱讀 32,912評(píng)論 1 269
  • 我被黑心中介騙來(lái)泰國(guó)打工史汗, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人拒垃。 一個(gè)月前我還...
    沈念sama閱讀 47,958評(píng)論 2 370
  • 正文 我出身青樓停撞,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子戈毒,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,779評(píng)論 2 354

推薦閱讀更多精彩內(nèi)容