2020-06-30

SSM-SpringMVC【实现文件上传】

字数统计: 2.1k字 | 阅读时长: 9分

一、前言

（一）文件上传的必要前提

A form 表单的 enctype 取值必须是： multipart/form-data
	(默认值是:application/x-www-form-urlencoded)
	enctype:是表单请求正文的类型
B method 属性取值必须是 Post
C 提供一个文件选择域<input type=”file” />

（二）文件上传的原理分析

当 form 表单的 enctype 取值不是默认值后， request.getParameter()将失效。
enctype=”application/x-www-form-urlencoded”时， form 表单的正文内容是：
key=value&key=value&key=value
当 form 表单的 enctype 取值为 Mutilpart/form-data 时，请求正文内容就变成：
每一部分都是 MIME 类型描述的正文
-----------------------------7de1a433602ac 分界符
Content-Disposition: form-data; name="userName" 协议头
aaa 										协议的正文
-----------------------------7de1a433602ac
Content-Disposition: form-data; name="file";
filename="C:\Users\zhy\Desktop\fileupload_demofile\b.txt"
Content-Type: text/plain 协议的类型（ MIME 类型）
bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb
-----------------------------7de1a433602ac--

二、传统方式实现文件上传

（一）说明

1 2	传统方式的文件上传，指的是我们上传的文件和访问的应用存在于同一台服务器上。并且上传完成之后，浏览器可能跳转。

（二）需要借助的第三方组件

使用 Commons-fileupload 组件实现文件上传，需要导入该组件相应的支撑 jar 包： Commons-fileupload 和
commons-io。 commons-io 不属于文件上传组件的开发 jar 文件，但Commons-fileupload 组件从 1.1 版本开始，它
工作时需要 commons-io 包的支持。

<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>

（三）实现代码

jsp代码：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <form action="user/fileUpload" method="post" enctype="multipart/form-data">
        选择文件：<input type="file" name="upload"> <br/>
        <input type="submit" name="上传">
    </form>
</body>
</html>

controller代码：

@Controller
@RequestMapping("/user")
public class UserController {
    /**
     * 传统方式文件上传
     * @return
     */
    @RequestMapping("/fileUpload")
    public String fileUpload(HttpServletRequest request) throws Exception {
        System.out.println("文件上传成功！");

        //使用fileload组件完成文件上传
        //1、获取文件上传后保存的位置
//        String path = request.getSession().getServletContext().getRealPath("/uploads/");
        String path = "C:/Users/ASUS/Desktop/uploads";
        //2、判断该文件夹是否存在
        File file = new File(path);
        if(!file.exists()){
            //不存在，则创建文件夹
            file.mkdirs();
        }

        //3、创建fileload对象
        DiskFileItemFactory fileItemFactory = new DiskFileItemFactory();
        ServletFileUpload fileUpload = new ServletFileUpload(fileItemFactory);

        //4、使用fileload对象解析request对象，获取文件上传项
        List<FileItem> items = fileUpload.parseRequest(request);
        //遍历，判断当前item对象是否为上传文件项
        for (FileItem item : items) {
            if (item.isFormField()){
                //说明为普通表单项
            }else{
                //说明为上传文件项
                //获取上传文件的名称
                String fileName = item.getName();
                //生成uuid，保证为唯一文件名
                String uuid = UUID.randomUUID().toString().replace("-", "");
                fileName = uuid + "_" + fileName;
                //完成文件上传
                item.write(new File(path, fileName));
                //删除临时文件
                item.delete();
            }
        }
        return "success";
    }
}

三、SpringMVC传统方式实现文件上传

（一）导入依赖

<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>

（二）代码实现

jsp代码：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <form action="user/fileUpload02" method="post" enctype="multipart/form-data">
        选择文件：<input type="file" name="upload"> <br/>
    	<input type="submit" name="上传">
    </form>
</body>
</html>

controller代码：

@Controller
@RequestMapping("/user")
public class UserController {
    /**
     * SpringMVC方式文件上传
     * @return
     */
    @RequestMapping("/fileUpload02")
    public String fileUpload02(HttpServletRequest request, MultipartFile upload) throws IOException {
        System.out.println("SpringMVC文件上传成功！");

        //1、获取文件上传后保存的位置
        String path = "C:/Users/ASUS/Desktop/uploads";
        //2、判断该文件夹是否存在
        File file = new File(path);
        if(!file.exists()){
            //不存在，则创建文件夹
            file.mkdirs();
        }

        //3、获取文件上传的名称
        String fileName = upload.getOriginalFilename();
        //生成uuid，保证为唯一文件名
        String uuid = UUID.randomUUID().toString().replace("-", "");
        fileName = uuid + "_" + fileName;

        //4、上传文件
        upload.transferTo(new File(path, fileName));

        return "success";
    }
}

配置文件解析器：
需要在springmvc.xml配置文件中配置文件解析器

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation=" http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/mvc
       http://www.springframework.org/schema/mvc/spring-mvc.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context.xsd">

    <context:component-scan base-package="com.zuobiao"></context:component-scan>

    <!--配置视图解析器对象-->
    <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>

    <!--配置文件解析器对象-->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <!-- 设置上传文件的最大尺寸为 10MB -->
        <property name="maxUploadSize" value="10485760" ></property>
    </bean>
    
    <mvc:annotation-driven/>

</beans>

（三）注意事项

1、在上述配置中，第22行的 id 名称必须为：multipartResolver；
2、在controller代码的第9行，方法中的 MultipartFile 形参的参数名称必须和 jsp 中输入项的 name 属性值一样。如：

1	选择文件：<input type="file" name="upload"> <br/>

1	public String fileUpload02(HttpServletRequest request, MultipartFile upload) throws IOException {}

文件上传02

四、SpringMVC跨服务器实现文件上传

（一）分服务器的目的

在实际开发中，我们会有很多处理不同功能的服务器。例如：
应用服务器：负责部署我们的应用
数据库服务器：运行我们的数据库
缓存和消息服务器：负责处理大并发访问的缓存和消息
文件服务器：负责存储用户上传文件的服务器。
(注意：此处说的不是服务器集群）
分服务器处理的目的是让服务器各司其职，从而提高我们项目的运行效率

（二）前期准备

准备两个Tomcat服务器，和一个用于存储文件的web工程即可。
注：用于存储文件的Tomcat需要在web.xml中将readonly参数设置为false。

（三）导入依赖

<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>

<dependency>
    <groupId>com.sun.jersey</groupId>
    <artifactId>jersey-core</artifactId>
    <version>1.18.1</version>
</dependency>
<dependency>
    <groupId>com.sun.jersey</groupId>
    <artifactId>jersey-client</artifactId>
    <version>1.18.1</version>
</dependency>

（四）代码实现

jsp代码：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <form action="user/fileUpload03" method="post" enctype="multipart/form-data">
        选择文件：<input type="file" name="upload"> <br/>
        <input type="submit" name="上传">
    </form>
</body>
</html>

controller代码：

@Controller
@RequestMapping("/user")
public class UserController {

    /**
     * SpringMVC跨服务器实现文件上传
     * @param upload
     * @return
     */
    @RequestMapping("/fileUpload03")
    public String fileUpload03(MultipartFile upload){
        System.out.println("SpringMVC跨服务器实现文件上传");

        /**
         * 1、获取文件上传路径
         * 2、获取上传文件的文件名称
         * 3、创建请求文件服务器的客户端
         * 4、连接文件服务器
         * 5、上传文件
         */
        //如果该路径最后没有加/的话，那么在连接时就需要手动拼接
        //该路径为文件服务器上用于存储文件的项目的url。存储于uploads文件夹中
        String path = "http://localhost:9090/fileupload_war/uploads/";  

        String fileName = upload.getOriginalFilename();
        String uuid = UUID.randomUUID().toString().replace("-", "");
        fileName = uuid + "_" + fileName;

        Client client = Client.create();

        WebResource webResource = client.resource(path + fileName);

        try {
            webResource.put(upload.getBytes());
        } catch (IOException e) {
            e.printStackTrace();
        }

        return "success";
    }
}

配置文件解析器：

<!--配置文件解析器对象-->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="maxUploadSize" value="10485760" ></property>
</bean>

Java新手，若有错误，欢迎指正！

| 阅读量次