SpringBoot使用转换器将前端参数转换为枚举

前言

最近遇到一个小伙伴问前端枚举转换问题，才意识到可以通过转换器(Converter)自动将前端传入的字段值使用枚举接收。

我自己捣鼓了一番，现在记录笔记分享一下!有兴趣的小伙伴可以自己尝试一下!

这里使用的是 MyBatis-Plus 和 SpringBoot 2.3.4.RELEASE

1实现过程

配置转换器

 
 
 
 
    
  
  
  
  
  1. /**
    2. 
  
  
  
  
  2.  * @author liuzhihang
    3. 
  
  
  
  
  3.  * @date 2021/8/31 16:29
    4. 
  
  
  
  
  4.  */
    5. 
  
  
  
  
  5. @Configuration
    6. 
  
  
  
  
  6. public class WebConfig implements WebMvcConfigurer {
    7. 
  
  
  
  
  7. 
  
  
  
  
  8.     @Override
    9. 
  
  
  
  
  9.     public void addFormatters(FormatterRegistry registry) {
    10. 
  
  
  
  
  10. 
  
  
  
  
  11.         registry.addConverterFactory(new ConverterFactory() {
    12. 
  
  
  
  
  12.             @Override
    13. 
  
  
  
  
  13.             public  Converter getConverter(Class targetType) {
    14. 
  
  
  
  
  14. 
  
  
  
  
  15.                 T[] enums = targetType.getEnumConstants();
    16. 
  
  
  
  
  16. 
  
  
  
  
  17.                 return source -> {
    18. 
  
  
  
  
  18. 
  
  
  
  
  19.                     for (T e : enums) {
    20. 
  
  
  
  
  20.                         if (e.getCode().equals(source)) {
    21. 
  
  
  
  
  21.                             return e;
    22. 
  
  
  
  
  22.                         }
    23. 
  
  
  
  
  23.                     }
    24. 
  
  
  
  
  24. 
  
  
  
  
  25.                     throw new IllegalArgumentException("枚举 Code 不正确");
    26. 
  
  
  
  
  26.                 };
    27. 
  
  
  
  
  27.             }
    28. 
  
  
  
  
  28.         });
    29. 
  
  
  
  
  29.     }
    30. 
  
  
  
  
  30. }
    31.

直接在 WebMvcConfigurer 里实现 addFormatters 方法即可，然后 new 一个 ConverterFactory。

WebMvcConfigurer 相信大家都不陌生，一般添加一些拦截器，通用校验 token、日志等等都会用到。具体可以参考这篇文章：几行代码轻松实现跨系统传递 traceId，再也不用担心对不上日志了!，里面有一些其他的应用。

就这些，很简单的实现。下面介绍下项目的内容和代码，方便理解。

项目代码

  • 请求参数：
 
 
 
 
    
  
  
  
  
  1. POST http://localhost:8818/user/listByStatus
    2. 
  
  
  
  
  2. Content-Type: application/json
    3. 
  
  
  
  
  3. 
  
  
  
  
  4. {
    5. 
  
  
  
  
  5.   "orderStatus": 1
    6. 
  
  
  
  
  6. }
    7.
  • Controller
 
 
 
 
    
  
  
  
  
  1. /**
    2. 
  
  
  
  
  2.  * @author liuzhihang
    3. 
  
  
  
  
  3.  * @date 2021/8/30 11:08
    4. 
  
  
  
  
  4.  */
    5. 
  
  
  
  
  5. @Slf4j
    6. 
  
  
  
  
  6. @RestController
    7. 
  
  
  
  
  7. @RequestMapping("/user")
    8. 
  
  
  
  
  8. public class UserController {
    9. 
  
  
  
  
  9. 
  
  
  
  
  10.     @Autowired
    11. 
  
  
  
  
  11.     private OrderService orderService;
    12. 
  
  
  
  
  12. 
  
  
  
  
  13.     @PostMapping(value = "/listByStatus")
    14. 
  
  
  
  
  14.     public ResultVO listByStatus(@Validated @RequestBody UserRequest request)  {
    15. 
  
  
  
  
  15. 
  
  
  
  
  16.         log.info("请求参数:{}", request);
    17. 
  
  
  
  
  17. 
  
  
  
  
  18.         List orderList = orderService.getByOrderStatus(request.getOrderStatus());
    19. 
  
  
  
  
  19. 
  
  
  
  
  20.         UserResponse response = new UserResponse();
    21. 
  
  
  
  
  21. 
  
  
  
  
  22.         response.setRecords(orderList);
    23. 
  
  
  
  
  23. 
  
  
  
  
  24.         log.info("返回参数:{}", response);
    25. 
  
  
  
  
  25. 
  
  
  
  
  26.         return ResultVO.success(response);
    27. 
  
  
  
  
  27.     }
    28. 
  
  
  
  
  28. }
    29.
  • Entity
 
 
 
 
    
  
  
  
  
  1. @Data
    2. 
  
  
  
  
  2. public class UserRequest {
    3. 
  
  
  
  
  3. 
  
  
  
  
  4.     private OrderStatusEnum orderStatus;
    5. 
  
  
  
  
  5.     private ViewStatusEnum viewStatus;
    6. 
  
  
  
  
  6. }
    7. 
  
  
  
  
  7. 
  
  
  
  
  8. @Data
    9. 
  
  
  
  
  9. public class UserResponse {
    10. 
  
  
  
  
  10. 
  
  
  
  
  11.     private List records;
    12. 
  
  
  
  
  12. 
  
  
  
  
  13. }
    14.

Web 传入 orderStatus 为 1，而后端接收对象是 UserRequest 的 orderStatus 字段是个 OrderStatusEnum 类型的枚举。

这里就需要自动将数字类型的字段转换为枚举字段。这个枚举会直接通过 MyBatis-Plus 查询。

为什么要这么用呢?

其实原因很简单，使用枚举限制数据库字段的类型，比如数据库状态只有 0、1、2，那就和代码里的枚举对应起来。防止传入其他值。

  • 枚举
 
 
 
 
    
  
  
  
  
  1. public interface BaseEnum {
    2. 
  
  
  
  
  2.     Object getCode();
    3. 
  
  
  
  
  3. }
    4. 
 
 
 
 
 
 
 
 
    
  
  
  
  
  1. public enum OrderStatusEnum implements BaseEnum {
    2. 
  
  
  
  
  2. 
  
  
  
  
  3.     INIT(0, "初始状态"),
    4. 
  
  
  
  
  4.     SUCCESS(1, "成功"),
    5. 
  
  
  
  
  5.     FAIL(2, "失败");
    6. 
  
  
  
  
  6. 
  
  
  
  
  7.     @EnumValue
    8. 
  
  
  
  
  8.     @JsonValue
    9. 
  
  
  
  
  9.     private final int code;
    10. 
  
  
  
  
  10. 
  
  
  
  
  11.     private final String desc;
    12. 
  
  
  
  
  12. 
  
  
  
  
  13.     OrderStatusEnum(int code, String desc) {
    14. 
  
  
  
  
  14.         this.code = code;
    15. 
  
  
  
  
  15.         this.desc = desc;
    16. 
  
  
  
  
  16.     }
    17. 
  
  
  
  
  17. 
  
  
  
  
  18.     @Override
    19. 
  
  
  
  
  19.     public Integer getCode() {
    20. 
  
  
  
  
  20.         return code;
    21. 
  
  
  
  
  21.     }
    22. 
  
  
  
  
  22. 
  
  
  
  
  23.     public String getDesc() {
    24. 
  
  
  
  
  24.         return desc;
    25. 
  
  
  
  
  25.     }
    26. 
  
  
  
  
  26. }
    27.

这里先声明接口 BaseEnum，所有的枚举都继承这个接口，并实现 getCode 方法。

@EnumValue：MyBatis-Plus 的枚举，和数据库字段映射用的

@JsonValue：返回给前端时，这个枚举字段序列化时，返回参数只显示 code。

这样就可以实现效果，请求参数为数字，接收对象字段为枚举，返回字段也是 code。

效果

测试结果

测试结果经过验证，是可以胜任传入数值和字符串的。

也可以结合异常处理器，返回通用异常。具体怎么用查一查 @ExceptionHandler 就知道了。

具体说明

在 addFormatters 方法中可以看到 registry.addConverterFactory() 接收的是一个 ConverterFactory 对象。

 
 
 
 
    
  
  
  
  
  1. public interface ConverterFactory {
    2. 
  
  
  
  
  2. 
  
  
  
  
  3.   Converter getConverter(Class targetType);
    4. 
  
  
  
  
  4. }
    5.
  • S 就是传入的字段类型(数字，字符串)
  • R 是要转换为的类型(枚举)
  • T 继承了 R，其实就是参数对象中字段的类型

在 ConverterFactory 的 getConverter 方法则需要返回一个实际的转换器 Converter

 
 
 
 
    
  
  
  
  
  1. @FunctionalInterface
    2. 
  
  
  
  
  2. public interface Converter {
    3. 
  
  
  
  
  3. 
  
  
  
  
  4.  @Nullable
    5. 
  
  
  
  
  5.  T convert(S source);
    6. 
  
  
  
  
  6. 
  
  
  
  
  7. }
    8.

convert 方法的入参是一个 source，就是要转换为什么类型的，这里就是数字/字符串，然后返回一个枚举即可。

注意这里加了 @FunctionalInterface 就意味着这里是可以用 lambda 表达式的。

2优化

一般 WebConfig 中除了实现 addFormatters 方法外，还会实现 addInterceptors 等等，这样写难免会很长，所以可以改为下面这种。

 
 
 
 
    
  
  
  
  
  1. @Configuration
    2. 
  
  
  
  
  2. public class WebConfig implements WebMvcConfigurer {
    3. 
  
  
  
  
  3. 
  
  
  
  
  4.     @Autowired
    5. 
  
  
  
  
  5.     private LogInterceptor logInterceptor;
    6. 
  
  
  
  
  6. 
  
  
  
  
  7.     @Autowired
    8. 
  
  
  
  
  8.     private AppTokenInterceptor appTokenInterceptor;
    9. 
  
  
  
  
  9. 
  
  
  
  
  10. 
  
  
  
  
  11.     @Autowired
    12. 
  
  
  
  
  12.     private EnumConverterFactory enumConverterFactory;
    13. 
  
  
  
  
  13. 
  
  
  
  
  14.     @Override
    15. 
  
  
  
  
  15.     public void addInterceptors(InterceptorRegistry registry) {
    16. 
  
  
  
  
  16. 
  
  
  
  
  17.         // 日志
    18. 
  
  
  
  
  18.         registry.addInterceptor(logInterceptor)
    19. 
  
  
  
  
  19.                 .addPathPatterns("/**");
    20. 
  
  
  
  
  20. 
  
  
  
  
  21.         // app token校验
    22. 
  
  
  
  
  22.         registry.addInterceptor(appTokenInterceptor)
    23. 
  
  
  
  
  23.                 .addPathPatterns("/app/**");
    24. 
  
  
  
  
  24. 
  
  
  
  
  25.     }
    26. 
  
  
  
  
  26. 
  
  
  
  
  27.     @Override
    28. 
  
  
  
  
  28.     public void addFormatters(FormatterRegistry registry) {
    29. 
  
  
  
  
  29.         
    30. 
  
  
  
  
  30.         // 枚举转换
    31. 
  
  
  
  
  31.         registry.addConverterFactory(enumConverterFactory);
    32. 
  
  
  
  
  32.     }
    33. 
  
  
  
  
  33. }
    34.

这种就需要咱们创建 EnumConverterFactory 类并实现 ConverterFactory 接口了，还得注入到 Spring 容器中

 
 
 
 
    
  
  
  
  
  1. @Component
    2. 
  
  
  
  
  2. public class EnumConverterFactory implements ConverterFactory {
    3. 
  
  
  
  
  3. 
  
  
  
  
  4.     @Override
    5. 
  
  
  
  
  5.     public  Converter getConverter(Class targetType) {
    6. 
  
  
  
  
  6. 
  
  
  
  
  7.         return new EnumConverter<>(targetType);
    8. 
  
  
  
  
  8.     }
    9. 
  
  
  
  
  9. }
    10. 
  
  
  
  
  10. public class EnumConverter implements Converter {
    11. 
  
  
  
  
  11. 
  
  
  
  
  12.     private final Class targetType;
    13. 
  
  
  
  
  13. 
  
  
  
  
  14.     public EnumConverter(Class targetType) {
    15. 
  
  
  
  
  15.         this.targetType = targetType;
    16. 
  
  
  
  
  16.     }
    17. 
  
  
  
  
  17. 
  
  
  
  
  18.     @Override
    19. 
  
  
  
  
  19.     public T convert(Object source) {
    20. 
  
  
  
  
  20. 
  
  
  
  
  21.         for (T e : targetType.getEnumConstants()) {
    22. 
  
  
  
  
  22.             if (e.getCode().equals(source)) {
    23. 
  
  
  
  
  23.                 return e;
    24. 
  
  
  
  
  24.             }
    25. 
  
  
  
  
  25.         }
    26. 
  
  
  
  
  26. 
  
  
  
  
  27.         throw new IllegalArgumentException("枚举 Code 不正确");
    28. 
  
  
  
  
  28.     }
    29. 
  
  
  
  
  29. }
    30.

3总结

当然这里也有一些其他的优化点，比如可以使用缓存将 Convert 缓存起来。

不过我也遇到一个其他的问题，就是我 debug 断点竟然一直没有断到转换器中，不知道有没有小伙伴尝试过?

标题名称：SpringBoot使用转换器将前端参数转换为枚举
本文来源：http://www.csdahua.cn/qtweb/news13/351363.html

网站建设、网络推广公司-快上网，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 快上网

成都快上网为您推荐相关内容

网站建设知识

分类信息网站

成都机房机柜租用　　 　网站建设方案　　 　蜀锦在线　　 　名片印刷厂　　 　彭山网站制作　　 　奢侈品网站建设方案　　 　成都网站优化　　 　成都网站建设　　 　成都微信二次开发　　 　手机网站建设公司　　 　网络推广公司　　 　成都棕树机房　　 　四川搅拌罐车　　 　营销网站定位　　 　成都微信二次开发公司　　 　混凝土搅拌罐车　　 　h5页面制作　　 　四川和正源　　 　成都网站建设　　 　犀浦雨棚定制