快捷導(dǎo)航

Jackson優(yōu)雅序列化Java枚舉類過(guò)程解析

更新時(shí)間：2020年09月04日 09:18:15 作者：碼農(nóng)小胖哥

這篇文章主要介紹了Jackson優(yōu)雅序列化Java枚舉類過(guò)程解析,文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下

1. 前言

在Java開(kāi)發(fā)中我們?yōu)榱吮苊膺^(guò)多的魔法值，使用枚舉類來(lái)封裝一些靜態(tài)的狀態(tài)代碼。但是在將這些枚舉的意思正確而全面的返回給前端卻并不是那么順利，我們通常會(huì)使用Jackson類庫(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)寫一個(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名稱：

  @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>() {
        @Override
        public void serialize(Enumerator value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
          // 開(kāi)始寫入對(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:

@Bean
public 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í)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: