Jackson優(yōu)雅序列化Java枚舉類(lèi)過(guò)程解析
1. 前言
在Java開(kāi)發(fā)中我們?yōu)榱吮苊膺^(guò)多的魔法值,使用枚舉類(lèi)來(lái)封裝一些靜態(tài)的狀態(tài)代碼。但是在將這些枚舉的意思正確而全面的返回給前端卻并不是那么順利,我們通常會(huì)使用Jackson類(lèi)庫(kù)序列化對(duì)象為JSON,今天就來(lái)講一個(gè)關(guān)于使用Jackson序列化枚舉的通用性技巧。
2. 通用枚舉范式
為了便于統(tǒng)一處理和規(guī)范統(tǒng)一的風(fēng)格,建議指定一個(gè)統(tǒng)一的抽象接口,例如:
/** * The interface Enumerator. */public interface Enumerator { /** * Code integer. * * @return the integer */ Integer code(); /** * Description string. * * @return the string */ String description();}
我們來(lái)寫(xiě)一個(gè)實(shí)現(xiàn)來(lái)標(biāo)識(shí)性別:
public enum GenderEnum implements Enumerator { UNKNOWN(0, '未知'), MALE(1, '男'), FEMALE(2, '女'); private final Integer code; private final String description; GenderEnum(Integer code, String description) { this.code = code; this.description = description; } @Override public Integer code() { return code; } @Override public String description() { return description; }}
3. 序列化枚舉
如果我們直接使用Jackson對(duì)枚舉進(jìn)行序列化,將只能簡(jiǎn)單的輸出枚舉的String名稱(chēng):
@Resource private ObjectMapper objectMapper; @Test void enumTest() { try { String s = objectMapper.writeValueAsString(GenderEnum.MALE); // 輸出字符串 MALE System.out.println(s); } catch (JsonProcessingException e) { e.printStackTrace(); } }
我們期望將GenderEnum.MALE 序列化為 {'code':1,'description':'男'} 。我們可以向ObjectMapper定制化一個(gè)Module來(lái)實(shí)現(xiàn)這種個(gè)性化需求:
// 聲明一個(gè)簡(jiǎn)單Module 對(duì)象 SimpleModule module = new SimpleModule(); // 給Module 添加一個(gè)序列化器 module.addSerializer(Enumerator.class, new JsonSerializer<Enumerator>() {@Overridepublic void serialize(Enumerator value, JsonGenerator gen, SerializerProvider serializers) throws IOException { // 開(kāi)始寫(xiě)入對(duì)象 gen.writeStartObject(); // 分別指定 k v code description gen.writeNumberField('code',value.code()); gen.writeStringField('description',value.description()); // 顯式結(jié)束操作 gen.writeEndObject();} }); // 注冊(cè) Module objectMapper.registerModule(module);
然后再次執(zhí)行就會(huì)獲取我們期望的結(jié)果。然而這并不算合理。
4. Spring Boot 中自動(dòng)全局配置
在Spring Boot應(yīng)用中我們希望能全局配置。Spring Boot的自動(dòng)配置為我們提供了一個(gè)個(gè)性化定制ObjectMapper的可能性,你只需要聲明一個(gè)Jackson2ObjectMapperBuilderCustomizer并注入Spring IoC:
@Beanpublic Jackson2ObjectMapperBuilderCustomizer enumCustomizer(){ return jacksonObjectMapperBuilder -> jacksonObjectMapperBuilder.serializerByType(Enumerator.class, new JsonSerializer<Enumerator>() { @Override public void serialize(Enumerator value, JsonGenerator gen, SerializerProvider serializers) throws IOException { gen.writeStartObject(); gen.writeNumberField('code',value.code()); gen.writeStringField('description',value.description()); gen.writeEndObject(); } });}
這樣就實(shí)現(xiàn)了全局配置。
5. 總結(jié)
這里我們介紹了如何定制Jackson庫(kù)以達(dá)到對(duì)枚舉進(jìn)行更加友好的序列化的目的。其實(shí)不單單枚舉,你也可以實(shí)現(xiàn)其它序列化,反序列化,時(shí)間輸出格式的定制。這些特性留給你自己挖掘。
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持好吧啦網(wǎng)。
相關(guān)文章:
1. HTML5 Canvas繪制圖形從入門(mén)到精通2. HTTP協(xié)議常用的請(qǐng)求頭和響應(yīng)頭響應(yīng)詳解說(shuō)明(學(xué)習(xí))3. 不要在HTML中濫用div4. XML入門(mén)的常見(jiàn)問(wèn)題(三)5. HTML DOM setInterval和clearInterval方法案例詳解6. HTML5實(shí)戰(zhàn)與剖析之觸摸事件(touchstart、touchmove和touchend)7. CSS清除浮動(dòng)方法匯總8. 本站用的rss輸出9. Vue如何使用ElementUI對(duì)表單元素進(jìn)行自定義校驗(yàn)及踩坑10. XML在語(yǔ)音合成中的應(yīng)用
