Spring Boot中HTTP请求参数转换和请求体JSON反序列化的区别解析

@Operation(summary = "新增或修改标签信息")
@PostMapping("saveOrUpdate")
public Result saveOrUpdateLabel(@RequestBody LabelInfo labelInfo) {
    service.saveOrUpdate(labelInfo);
    return Result.ok();
}
@Schema(description = "标签信息表")
@TableName(value = "label_info")
@Data
public class LabelInfo extends BaseEntity {
    private static final long serialVersionUID = 1L;
    @Schema(description = "类型")
    @TableField(value = "type")
    private ItemType type;
    @Schema(description = "标签名称")
    @TableField(value = "name")
    private String name;
}
@Getter
@AllArgsConstructor
public enum ItemType implements BaseEnum {
    APARTMENT(1, "公寓"),
    ROOM(2, "房间");
    @EnumValue
    @JsonValue
    private Integer code;
    private String name;
}

Resolved [org.springframework.http.converter.HttpMessageNotReadableException: JSON parse error: Cannot deserialize value of type `com.sense.lease.model.enums.ItemType` from String "2": not one of the values accepted for Enum class: [APARTMENT, ROOM]]

POST /admin/label/saveOrUpdate
Content-Type: application/json
{
  "type": "2",
  "name": "两室一厅"
}

public enum ItemType implements BaseEnum {
    APARTMENT(1, "公寓"),
    ROOM(2, "房间");
    @EnumValue  // MyBatis-Plus使用此注解确定存储到数据库的值
    @JsonValue  // Jackson使用此注解确定序列化/反序列化的值
    private Integer code;
    // ...
}

GET /admin/label/list?type=2

POST /admin/label/saveOrUpdate
Content-Type: application/json
{
  "type": "2",
  "name": "两室一厅"
}

// @JsonCreator注解指定自定义反序列化方法，静态工厂函数，根据code属性值返回对应的枚举对象实例
// 参数类型需与Json数据中code属性的数据类型一致，或者声明为Object类型，否则无法将json数据与参数绑定
// 参数名可直接使用Json数据中的属性名，否则需使用@JsonProperty注解指定属性名。
@JsonCreator
public static ItemType forValue(@JsonProperty("code") String c) {
    for (ItemType type : ItemType.values()) {
        if (type.getCode().equals(Integer.valueOf(c))) {
            return type;
        }
    }
    throw new IllegalArgumentException("code: " + c + "非法");
}