龙空技术网

SpringBoot 同一个接口同时支持 form 表单、form-data的优雅写法

Java架构新资讯 2553

前言:

今天小伙伴们对“springmvc form表单”大致比较注重,姐妹们都需要剖析一些“springmvc form表单”的相关资讯。那么小编在网上收集了一些对于“springmvc form表单””的相关资讯,希望看官们能喜欢,看官们一起来了解一下吧!

网上很多代码都是千篇一律的 cvs,相信我只要你认真看完我写的这篇,你就可以完全掌握这个知识点,这篇文章不适合直接 cvs,一定要先理解。

最近重写个项目遇到个比较棘手的问题,老项目是 PHP 接口,这个接口同时兼容 POST json 和 form 表单,更骚的是连 form-data 也兼容。。。因为写 PHP 请求的对接方代码不严谨。详见这里。

而在 Java 中,一个接口只支持一种 content-type,json 就用 @RequestBody,form 表单就用 @RequestParam 或不写,form-data 就用 MultipartFile。

兼容版本

如果要把在一个接口中同时兼容三种,比较笨的办法就是获取 HttpServletRequest,然后自己再写方法解析。类似如下:

private Map<String, Object> getParams(HttpServletRequest request) {    String contentType = request.getContentType();    if (contentType.contains("application/json")) {        // json 解析...        return null;    } else if (contentType.contains("application/x-www-form-urlencoded")) {        // form 表单解析 ...        return null;    } else if (contentType.contains("multipart")) {        // 文件流解析        return null;    } else {         throw new BizException("不支持的content-type");    } }复制代码

但是这样写有弊端

代码很丑,具体到解析代码又臭又长只能返回固定 map 或者自己重新组装参数类无法使用 @Valid 校验参数,像我这种几十个参数都要检验的简直是灾难优雅版本

网上有 form 表单和 json 同时兼容的版本,但是没有兼容 form-data,我在这做一下补充。

1. 自定义注解

@Target(ElementType.PARAMETER)@Retention(RetentionPolicy.RUNTIME)@Documentedpublic @interface GamePHP {}复制代码
2. 自定义注解解析
public class GamePHPMethodProcessor implements HandlerMethodArgumentResolver {    private GameFormMethodArgumentResolver formResolver;    private GameJsonMethodArgumentResolver jsonResolver;    public GamePHPMethodProcessor() {        List<HttpMessageConverter<?>> messageConverters = new ArrayList<>();        PHPMessageConverter PHPMessageConverter = new PHPMessageConverter();        messageConverters.add(PHPMessageConverter);        jsonResolver = new GameJsonMethodArgumentResolver(messageConverters);        formResolver = new GameFormMethodArgumentResolver();    }    @Override    public boolean supportsParameter(MethodParameter parameter) {        GamePHP ann = parameter.getParameterAnnotation(GamePHP.class);        return (ann != null);    }    @Override    public Object resolveArgument(MethodParameter methodParameter, ModelAndViewContainer modelAndViewContainer, NativeWebRequest nativeWebRequest, WebDataBinderFactory webDataBinderFactory) throws Exception {        ServletRequest servletRequest = nativeWebRequest.getNativeRequest(ServletRequest.class);        String contentType = servletRequest.getContentType();        if (contentType == null) {            throw new IllegalArgumentException("不支持contentType");        }        if (contentType.contains("application/json")) {            return jsonResolver.resolveArgument(methodParameter, modelAndViewContainer, nativeWebRequest, webDataBinderFactory);        }        if (contentType.contains("application/x-www-form-urlencoded")) {            return formResolver.resolveArgument(methodParameter, modelAndViewContainer, nativeWebRequest, webDataBinderFactory);        }        if (contentType.contains("multipart")) {            return formResolver.resolveArgument(methodParameter, modelAndViewContainer, nativeWebRequest, webDataBinderFactory);        }        throw new IllegalArgumentException("不支持contentType");    }}复制代码
3. 添加到 spring configuration
    @Bean    public MyMvcConfigurer mvcConfigurer() {        return new MyMvcConfigurer();    }    public static class MyMvcConfigurer implements WebMvcConfigurer {        public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {            resolvers.add(new GamePHPMethodProcessor());        }    }复制代码
4. form-data 的特殊处理

引入 jar 包

    <dependency>      <groupId>commons-fileupload</groupId>      <artifactId>commons-fileupload</artifactId>      <version>1.3.1</version>    </dependency>    <dependency>      <groupId>commons-io</groupId>      <artifactId>commons-io</artifactId>      <version>2.4</version>    </dependency>复制代码

新增解析 bean

@Bean(name = "multipartResolver")public MultipartResolver multipartResolver(){    CommonsMultipartResolver resolver = new CommonsMultipartResolver();    resolver.setDefaultEncoding("UTF-8");    resolver.setResolveLazily(true);//resolveLazily属性启用是为了推迟文件解析,以在在UploadAction中捕获文件大小异常    resolver.setMaxInMemorySize(40960);    resolver.setMaxUploadSize(50*1024*1024);//上传文件大小 50M 50*1024*1024    return resolver;}复制代码

特殊说明,GameJsonMethodArgumentResolver 和 GameFormMethodArgumentResolver 是我们自定义的 json 和 form 解析,如果你没有自定义的,使用 spring 默认的 ServletModelAttributeMethodProcessor 和 RequestResponseBodyMethodProcessor 也可以。

只需将 @RequestParam 注解改为 @GamePHP,接口即可同时兼容三种 content-type。

其流程为,spring 启动的时候,MyMvcConfigurer 调用 addArgumentResolvers 方法将 GamePHPMethodProcessor 注入,接到请求时,supportsParameter 方法判断是否使用此 resolver,如果为 true,则进入 resolveArgument 方法执行。

至此我们可以得出一个结论,PHP 是世界上最垃圾的语言。写代码一时爽,维护火葬场。

原文链接:

标签: #springmvc form表单