根据源码用HttpServletRequest获取MultipartFile的问题

问题

由于某些原因，现在需要这样的一个文件上传接口，这个接口type(String)是必传参数，photoFile(MultipartFile)是非必传参数，即一般情况下需要接受两个参数，分别为photoFile和type，但是偶尔只接受type参数，不需要起到上传作用。

按常规写法，photoFile参数的required配置设置为了false。

奈何调试时发现，photoFile的required配置是失效的。即下面的接口写法，photoFile成了必传参数。

@ResponseBody
@RequestMapping(value = "/upload")
public String uploadPics(@RequestPart(value = "photoFile", required = false) MultipartFile photoFile,
@RequestParam(value = "type", required = true) String type, HttpServletRequest request) throws Exception {
。。。
}

当模拟upload接口请求时，如果不携带photoFile参数，如上接口写法报错如下

org.springframework.web.multipart.MultipartException: The current request is not a multipart request
at org.springframework.web.servlet.mvc.method.annotation.RequestPartMethodArgumentResolver.assertIsMultipartRequest(RequestPartMethodArgumentResolver.java:178) ~[spring-webmvc-4.0.2.RELEASE.jar:4.0.2.RELEASE]
at org.springframework.web.servlet.mvc.method.annotation.RequestPartMethodArgumentResolver.resolveArgument(RequestPartMethodArgumentResolver.java:116) ~[spring-webmvc-4.0.2.RELEASE.jar:4.0.2.RELEASE]
at org.springframework.web.method.support.HandlerMethodArgumentResolverComposite.resolveArgument(HandlerMethodArgumentResolverComposite.java:79) ~[spring-web-4.0.2.RELEASE.jar:4.0.2.RELEASE]
at org.springframework.web.method.support.InvocableHandlerMethod.getMethodArgumentValues(InvocableHandlerMethod.java:157) ~[spring-web-4.0.2.RELEASE.jar:4.0.2.RELEASE]
at org.springframework.web.method.support.InvocableHandlerMethod.invokeForRequest(InvocableHandlerMethod.java:124) ~[spring-web-4.0.2.RELEASE.jar:4.0.2.RELEASE]
at org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:104) ~[spring-webmvc-4.0.2.RELEASE.jar:4.0.2.RELEASE]
at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.invokeHandleMethod(RequestMappingHandlerAdapter.java:749) ~[spring-webmvc-4.0.2.RELEASE.jar:4.0.2.RELEASE]
at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.handleInternal(RequestMappingHandlerAdapter.java:690) ~[spring-webmvc-4.0.2.RELEASE.jar:4.0.2.RELEASE]
at org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter.handle(AbstractHandlerMethodAdapter.java:83) ~[spring-webmvc-4.0.2.RELEASE.jar:4.0.2.RELEASE]
at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:945) ~[spring-webmvc-4.0.2.RELEASE.jar:4.0.2.RELEASE]
...

方案

required配置失效，估计是没有走required的相关流程。

我们根据所报的第三行错误，进入RequestPartMethodArgumentResolver.class的源码的116行查看。

111     @Override
112     public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer,
113             NativeWebRequest request, WebDataBinderFactory binderFactory) throws Exception {
114
115         HttpServletRequest servletRequest = request.getNativeRequest(HttpServletRequest.class);
116         assertIsMultipartRequest(servletRequest);
117
118         MultipartHttpServletRequest multipartRequest =
119             WebUtils.getNativeRequest(servletRequest, MultipartHttpServletRequest.class);
120
121         String partName = getPartName(parameter);
122         Object arg;
123
124         if (MultipartFile.class.equals(parameter.getParameterType())) {
125             Assert.notNull(multipartRequest, "Expected MultipartHttpServletRequest: is a MultipartResolver configured?");
126             arg = multipartRequest.getFile(partName);
}
.....

再点击116行，进入assertIsMultipartRequest方法

175     private static void assertIsMultipartRequest(HttpServletRequest request) {
176         String contentType = request.getContentType();
177         if (contentType == null || !contentType.toLowerCase().startsWith("multipart/")) {
178             throw new MultipartException("The current request is not a multipart request");
179         }
}

很明显，错误就是178行触发的。而且在上层的几个调用中也没有涉及到required的流程。

那么问题来了, 接口偶尔需要起到上传作用，如果不改变接口传参形式，就只能改源码了，很明显，这不是好的方案。

那答案肯定就在源码里了，我们很容易就想到可以在接口处完全去掉photoFile(MultipartFile)参数，然后把模仿源码，从request里去获取MultipartFile对象。

下面是根据源码118-126行、176-179行修改的接口，经测试是可行的：

@ResponseBody
@RequestMapping(value = "/upload")
public String uploadPics(@RequestParam(value = "type", required = true) String type,
HttpServletRequest request) {
....
// 检测是否为上传请求
String contentType = request.getContentType();
if (contentType != null && contentType.toLowerCase().startsWith("multipart/")) {
MultipartHttpServletRequest multipartRequest =
WebUtils.getNativeRequest(request, MultipartHttpServletRequest.class);
MultipartFile file = multipartRequest.getFile("file");
....
}
....
}

后记

问题的处理其实很简单，但是这边文章的记录是为了另一件事。

当时实现这个功能时，发现常规写法走不通，又不好改源码，内心是有草泥马奔腾而过的。

知道答案可能在源码里，猜想可以去用request获取MultipartFile对象，但是又觉得麻烦，不想去干这事，想着可能有更好的办法，然后这事就拖着。

到后来问同事怎么解决，同事说那就从request获取MultipartFile对象咯。:-O

其实工作经常碰到这类事情，但是很多时候那些 “貌似遥远的路途” 才是真正的捷径 ~