www.伊人网,国产91久久精品一区二区,色吧首页dvd

前文說(shuō)到優(yōu)雅的使用枚舉參數(shù) 和實(shí)現(xiàn)原理，本文繼續(xù)說(shuō)一下如何在 RequestBody 中優(yōu)雅使用枚舉。

本文先上實(shí)戰(zhàn)，說(shuō)一下如何實(shí)現(xiàn)。在優(yōu)雅的使用枚舉參數(shù) 代碼的基礎(chǔ)上，我們繼續(xù)實(shí)現(xiàn)。

確認(rèn)需求

需求與前文類(lèi)似，只不過(guò)這里需要是在 RequestBody 中使用。與前文不同的是，這種請(qǐng)求是通過(guò) Http Body 的方式傳輸?shù)胶蠖耍ǔＪ?json 或 xml 格式，Spring 默認(rèn)借助 Jackson 反序列化為對(duì)象。

同樣的，我們需要在枚舉中定義 int 類(lèi)型的 id、String 類(lèi)型的 code，id 取值不限于序號(hào)（即從 0 開(kāi)始的 orinal 數(shù)據(jù)），code 不限于 name。客戶(hù)端請(qǐng)求過(guò)程中，可以傳 id，可以傳 code，也可以傳 name。服務(wù)端只需要在對(duì)象中定義一個(gè)枚舉參數(shù)，不需要額外的轉(zhuǎn)換，即可得到枚舉值。

好了，接下來(lái)我們定義一下枚舉對(duì)象。

定義枚舉和對(duì)象

先定義我們的枚舉類(lèi)GenderIdCodeEnum，包含 id 和 code 兩個(gè)屬性：

				?

									public enum GenderIdCodeEnum implements IdCodeBaseEnum {

									    MALE(1, "male"),

									    FEMALE(2, "female");

									    private final Integer id;

									    private final String code;

									    GenderIdCodeEnum(Integer id, String code) {

									        this.id = id;

									        this.code = code;

									    }

									    @Override

									    public String getCode() {

									        return code;

									    }

									    @Override

									    public Integer getId() {

									        return id;

									    }

									}

這個(gè)枚舉類(lèi)的要求與前文一致，不清楚的可以再去看一下。

在定義一個(gè)包裝類(lèi)GenderIdCodeRequestBody，用于接收 json 數(shù)據(jù)的請(qǐng)求體：

				?

									@Data

									public class GenderIdCodeRequestBody {

									    private String name;

									    private GenderIdCodeEnum gender;

									    private long timestamp;

									}

除了GenderIdCodeEnum參數(shù)外，其他都是示例，所以隨便定義一下。

實(shí)現(xiàn)轉(zhuǎn)換邏輯

前奏鋪墊好，接下來(lái)入正題了。Jackson 提供了兩種方案：

方案一：精準(zhǔn)攻擊，指定需要轉(zhuǎn)換的字段，不影響其他類(lèi)對(duì)象中的字段
方案二：全范圍攻擊，所有借助 Jackson 反序列化的枚舉字段，全部具備自動(dòng)轉(zhuǎn)換功能

方案一：精準(zhǔn)攻擊

這種方案中，我們首先需要實(shí)現(xiàn)JsonDeserialize抽象類(lèi)：

				?

									public class IdCodeToEnumDeserializer extends JsonDeserializer<BaseEnum> {

									    @Override

									    public BaseEnum deserialize(JsonParser jsonParser, DeserializationContext deserializationContext)

									            throws IOException {

									        final String param = jsonParser.getText();// 1

									        final JsonStreamContext parsingContext = jsonParser.getParsingContext();// 2

									        final String currentName = parsingContext.getCurrentName();// 3

									        final Object currentValue = parsingContext.getCurrentValue();// 4

									        try {

									            final Field declaredField = currentValue.getClass().getDeclaredField(currentName);// 5

									            final Class<?> targetType = declaredField.getType();// 6

									            final Method createMethod = targetType.getDeclaredMethod("create", Object.class);// 7

									            return (BaseEnum) createMethod.invoke(null, param);// 8

									        } catch (NoSuchMethodException | InvocationTargetException | IllegalAccessException | NoSuchFieldException e) {

									            throw new CodeBaseException(ErrorResponseEnum.PARAMS_ENUM_NOT_MATCH, new Object[] {param}, "", e);

									        }

									    }

									}

然后在指定枚舉字段上定義@JsonDeserialize注解，比如：

				?

									@JsonDeserialize(using = IdCodeToEnumDeserializer.class)

									private GenderIdCodeEnum gender;

具體說(shuō)一下每行的作用：

獲取參數(shù)值。根據(jù)需要，此處可能是 id、code 或 name，也就是源值，需要將其轉(zhuǎn)換為枚舉；
獲取轉(zhuǎn)換上線(xiàn)文，這個(gè)是為 3、4 步做準(zhǔn)備的；
獲取標(biāo)記@JsonDeserialize注解的字段，此時(shí)currentName的值是gender；
獲取包裝對(duì)象，也就是GenderIdCodeRequestBody對(duì)象；
根據(jù)包裝對(duì)象的Class對(duì)象，以及字段名gender獲取Field對(duì)象，為第 5 步做準(zhǔn)備；
獲取gender字段對(duì)應(yīng)的枚舉類(lèi)型，也即是GenderIdCodeEnum。之所以這樣做，是要實(shí)現(xiàn)一個(gè)通用的反序列化類(lèi)；
這里是寫(xiě)死的一種實(shí)現(xiàn)，就是在枚舉類(lèi)中，需要定義一個(gè)靜態(tài)方法，方法名是create，請(qǐng)求參數(shù)是Object；
通過(guò)反射調(diào)用create方法，將第一步獲取的請(qǐng)求參數(shù)傳入。

我們來(lái)看一下枚舉類(lèi)中定義的create方法：

				?

									public static GenderIdCodeEnum create(Object code) {

									    final String stringCode = code.toString();

									    final Integer intCode = BaseEnum.adapter(stringCode);

									    for (GenderIdCodeEnum item : values()) {

									        if (Objects.equals(stringCode, item.name())) {

									            return item;

									        }

									        if (Objects.equals(item.getCode(), stringCode)) {

									            return item;

									        }

									        if (Objects.equals(item.getId(), intCode)) {

									            return item;

									        }

									    }

									    return null;

									}

為了性能考慮，我們可以提前定義三組 map，分別以 id、code、name 為 key，以枚舉值為 value，這樣就可以通過(guò) O(1) 的時(shí)間復(fù)雜度返回了。可以參考前文的Converter類(lèi)的實(shí)現(xiàn)邏輯。

這樣，我們就可以實(shí)現(xiàn)精準(zhǔn)轉(zhuǎn)換了。

方案二：全范圍攻擊

這種方案是全范圍攻擊了，只要是 Jackson 參與的反序列化，只要其中有目標(biāo)枚舉參數(shù)，就會(huì)受到這種進(jìn)入這種方案的邏輯中。這種方案是在枚舉類(lèi)中定義一個(gè)靜態(tài)轉(zhuǎn)換方法，通過(guò)@JsonCreator注解注釋?zhuān)琂ackson 就會(huì)自動(dòng)轉(zhuǎn)換了。

這個(gè)方法的定義與方案一中的create方法完全一致，所以只需要在create方法上加上注解即可：

				?

									@JsonCreator(mode = Mode.DELEGATING)

									public static GenderIdCodeEnum create(Object code) {

									    final String stringCode = code.toString();

									    final Integer intCode = BaseEnum.adapter(stringCode);

									    for (GenderIdCodeEnum item : values()) {

									        if (Objects.equals(stringCode, item.name())) {

									            return item;

									        }

									        if (Objects.equals(item.getCode(), stringCode)) {

									            return item;

									        }

									        if (Objects.equals(item.getId(), intCode)) {

									            return item;

									        }

									    }

									    return null;

									}

其中Mode類(lèi)有四個(gè)值：DEFAULT、DELEGATING、PROPERTIES、DISABLED，這四種的差別會(huì)在原理篇中說(shuō)明。還是那句話(huà)，對(duì)于應(yīng)用類(lèi)技術(shù)，我們可以先知其然，再知其所以然，也一定要知其所以然。

測(cè)試

先定義一個(gè) controller 方法：

				?

									@PostMapping("gender-id-code-request-body")

									public GenderIdCodeRequestBody bodyGenderIdCode(@RequestBody GenderIdCodeRequestBody genderRequest) {

									    genderRequest.setTimestamp(System.currentTimeMillis());

									    return genderRequest;

									}

然后定義測(cè)試用例，還是借助 JUnit5：

				?

									@ParameterizedTest

									@ValueSource(strings = {"\"MALE\"", "\"male\"", "\"1\"", "1"})

									void postGenderIdCode(String gender) throws Exception {

									    final String result = mockMvc.perform(

									            MockMvcRequestBuilders.post("/echo/gender-id-code-request-body")

									                    .contentType(MediaType.APPLICATION_JSON_UTF8)

									                    .accept(MediaType.APPLICATION_JSON_UTF8)

									                    .content("{\"gender\": " + gender + ", \"name\": \"看山\"}")

									    )

									            .andExpect(MockMvcResultMatchers.status().isOk())

									            .andDo(MockMvcResultHandlers.print())

									            .andReturn()

									            .getResponse()

									            .getContentAsString();

									    ObjectMapper objectMapper = new ObjectMapper();

									    final GenderIdCodeRequestBody genderRequest = objectMapper.readValue(result, GenderIdCodeRequestBody.class);

									    Assertions.assertEquals(GenderIdCodeEnum.MALE, genderRequest.getGender());

									    Assertions.assertEquals("看山", genderRequest.getName());

									    Assertions.assertTrue(genderRequest.getTimestamp() > 0);

									}

文末總結(jié)

本文主要說(shuō)明了如何在 RequestBody 中優(yōu)雅的使用枚舉參數(shù)，借助了 Jackson 的反序列化擴(kuò)展，可以定制類(lèi)型轉(zhuǎn)換邏輯。礙于文章篇幅，沒(méi)有羅列大段代碼。關(guān)注公號(hào)「看山的小屋」回復(fù) spring 可以獲取源碼。關(guān)注我，下一篇我們進(jìn)入原理篇。