SpringMVC文件上传

2017-09-12 21:54:24

标签： 转载 SpringMVC 文件上传

## 文件上传

### 配置`MultipartResolver`

在`dispatcher-servlet.xml`配置文件配置`MultipartResolver`，`id`属性必须要有且值只能是`multipartResolver`，否则会报错。

为了让`CommonsMultipartResolver`正常工作，必须先将`Jakarta Commons FileUpload`及`Jakarta Commons io`的类包添加到类路径下。

`defaultEncoding`必须和用户`JSP`的`pageEncoding`属性一致，以便正确读取表单内容。

### 编写控制器

@Controller
    @RequestMapping("demo")
    public class DemoController {
        @RequestMapping("/upload")
        public String upload(HttpServletRequest request,
                             @RequestParam("file") MultipartFile file) throws Exception {
            if (!file.isEmpty()) {
                file.transferTo(new File("F:/" + file.getOriginalFilename()));
                request.setAttribute("info", "上传成功！");
            } else {
                request.setAttribute("info", "上传失败！");
            }
            return "message";
        }
    }

Spring MVC 会将上传文件绑定到`MultipartFile`对象中。`MultipartFile`常用方法说明：

*   byte [] getBytes()：获取文件数据。
*   String getContentType()：获取文件MIME类型，如`image/pjpeg`、`text/plain`等。
*   InputStream getInputStream()：获取文件流。
*   String getName()：获取表单中文件组件的名字。
*   String getOriginalFileName()：获取上传文件的原名。
*   long getSize()：获取上传文件的字节大小，单位是`byte`。
*   boolean isEmpty()：是否有上传的文件。
*   void transferTo(File dest)：可以使用该文件将上传的文件保存到一个目标文件中。

### 编写文件上传表单页面

<html>
    <head>
        <title>Spring MVC 文件上传</title>
    </head>
    <body>
        <h2>请选择文件：</h2>
        <form method="post" action="${basePath}demo/upload"
              enctype="multipart/form-data">
            <input type="file" name="file" />
            <input type="submit" />
        </form>
    </body>
    </html>

负责上传文件的表单和一般表单有一些区别，表单的类型编码必须是`multipart/form-data`类型。

## 问题

### 问题一

#### 异常信息

java.lang.ClassNotFoundException: org.apache.commons.fileupload.FileItemFactory

#### 原因及解决方法

缺少`commons-fileupload-x.x.x.jar`文件。目前（2016年9月06日）最新版本是`1.3.2`。

<dependency>
        <groupId>commons-fileupload</groupId>
        <artifactId>commons-fileupload</artifactId>
        <version>1.3.2</version>
    </dependency>

### 问题二

#### 异常信息：

org.springframework.web.util.NestedServletException: Request processing failed; nested exception is java.lang.IllegalArgumentException: Expected MultipartHttpServletRequest: is a MultipartResolver configured?
        org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:973)
        org.springframework.web.servlet.FrameworkServlet.doPost(FrameworkServlet.java:863)
        javax.servlet.http.HttpServlet.service(HttpServlet.java:648)
        org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:837)
        javax.servlet.http.HttpServlet.service(HttpServlet.java:729)
        org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)

#### 原因及解决方法：

配置`MultipartResolver`时未添加`id`属性或者`id`属性的值不是`multipartResolver`。

上一篇：html2canvas 截屏后上传到SpringMVC的服务器端下一篇：Spring MVC REST异常处理最佳实践（上）

分享到：QQ空间新浪微博腾讯微博人人网微信

登录