当先锋百科网

首页 1 2 3 4 5 6 7

SpringMVC框架的实现文件上传

上一篇：SpringMVC框架的返回值及响应数据
下一篇：SpringMVC框架的异常处理及拦截器

文章目录

1、环境搭建

1.1、文件上传的必要前提

  ① form 表单的 enctype 取值必须为：multipart/form-data（默认值是application/x-www-form-urlencoded）。enctype 指的是表单请求正文的类型。
  ② method 属性取值必须是 post。
  ③提供一个文件选择域<input type=”file” />。

1.2、借助第三方组件实现文件上传

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

	<dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>5.0.2.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>5.0.2.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.0.2.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>2.5</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.0</version>
            <scope>provided</scope>
        </dependency>

        <!-- 文件上传 -->
        <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>
    </dependencies>

1.3、配置web.xml

<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
        "http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
    <display-name>Archetype Created Web Application</display-name>

    <!-- 配置过滤器，解决中文乱码的问题 -->
    <filter>
        <filter-name>characterEncodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <!-- 指定字符集 -->
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>characterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <!-- SpringMVC的核心控制器 -->
    <servlet>
        <servlet-name>DispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 配置Servlet的初始化参数，读取springmvc的配置文件，创建spring容器 -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc.xml</param-value>
        </init-param>
        <!-- 配置servlet启动时加载对象 -->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>DispatcherServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

1.4、配置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">

    <!-- 配置spring创建容器时要扫描的包 -->
    <context:component-scan base-package="com.atlantis"/>
    
    <!-- 配置视图解析器 -->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

    <!-- 设置静态资源不被拦截 -->
    <mvc:resources location="/css/" mapping="/css/**"/> <!-- 样式 -->
    <mvc:resources location="/images/" mapping="/images/**"/> <!-- 图片 -->
    <mvc:resources location="/js/" mapping="/js/**"/> <!-- javascript -->

    <!-- 配置spring开启注解mvc的支持-->
    <mvc:annotation-driven />
</beans>

1.5、编写文件上传的JSP页面

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

2、传统方式文件上传

    /**
     * 传统方式文件上传
     */
    @RequestMapping(value = "/fileupload")
    public String fileupload(HttpServletRequest request) throws Exception {
        // 先获取到要上传的文件目录
        String path = request.getSession().getServletContext().getRealPath("/uploads/");
        // 创建File对象，一会向该文件夹下上传文件
        File file = new File(path);
        // 判断路径是否存在，如果不存在则创建
        if (!file.exists()) {
            file.mkdirs();
        }
        // 创建磁盘文件项工厂
        DiskFileItemFactory factory = new DiskFileItemFactory();
        ServletFileUpload fileUpload = new ServletFileUpload(factory);
        // 解析request对象
        List<FileItem> list = fileUpload.parseRequest(request);
        // 遍历
        for (FileItem fileItem : list) {
            // 判断文件项是普通字段，还是上传的文件
            if (!fileItem.isFormField()) {
                // 上传文件项
                // 获取到上传文件的名称
                String filename = fileItem.getName();
                // 上传文件
                fileItem.write(new File(file, filename));
                // 删除临时文件
                fileItem.delete();
            }
        }
        return "success";
    }

在这里插入图片描述
  解决上传文件名可能重复的问题：
在这里插入图片描述

3、SpringMVC文件上传

  SpringMVC 框架提供了 MultipartFile 对象，该对象表示上传的文件，要求变量名称必须和表单 file 标签的 name 属性名称相同。
在这里插入图片描述
  SpringMVC 框架文件上传的原理分析：
在这里插入图片描述
  演示如下：

    <!-- 配置文件解析器对象，要求id名称必须是multipartResolver -->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <!-- 上传文件大小限制，单位为字节 -->
        <property name="maxUploadSize" value="10485760"/>
    </bean>

   /**
     * SpringMVC方式文件上传
     */
    @RequestMapping(value = "/fileupload")
    public String fileupload(HttpServletRequest request, MultipartFile upload) throws Exception {
        // 先获取到要上传的文件目录
        String path = request.getSession().getServletContext().getRealPath("/uploads");
        // 解决同一文件夹中文件过多问题
        String datePath = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
        // 创建File对象，一会向该路径下上传文件
        File file = new File(path + "/" + datePath);
        // 判断路径是否存在，如果不存在则创建
        if (!file.exists()) {
            file.mkdirs();
        }
        // 获取到上传文件的名称
        String filename = upload.getOriginalFilename();
        // 把文件加上随机数，防止文件重复
        String uuid = UUID.randomUUID().toString().replaceAll("-", "").toUpperCase();
        filename = uuid + "_" + filename;
        // 使用MulitpartFile接口中方法，把上传的文件写到指定位置
        upload.transferTo(new File(file, filename));
        return "success";
    }

在这里插入图片描述

4、SpringMVC跨服务器方式文件上传

4.1、分服务器的目的

  在实际开发中，我们会有很多处理不同功能的服务器。例如：
    应用服务器：负责部署应用。
    数据库服务器：运行数据库。
    缓存和消息服务器：负责处理大并发访问的缓存和消息。
    文件服务器：负责存储用户上传文件的服务器。
  注意：此处说的不是服务器集群。

  分服务器处理的目的是让服务器各司其职，从而提高项目的运行效率。
在这里插入图片描述

4.2、环境搭建测试文件上传

（1）搭建图片服务器
  创建图片服务器工程，这里以Maven为例：
在这里插入图片描述
  启动应用服务器和图片服务器：
在这里插入图片描述
（2）实现SpringMVC跨服务器方式文件上传
  引入开发需要的 jar 包坐标：

        <!-- 服务器之间相互通信 -->
        <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>
    </dependencies>

  编写应用服务器中的文件上传JSP页面：

    <form action="file/fileupload" method="post" enctype="multipart/form-data">
        选择文件：<input type="file" name="upload"/><br/>
        <input type="submit" value="上传文件"/>
    </form>

  编写应用服务器中的控制器方法：

    /**
     * SpringMVC跨服务器方式文件上传
     */
    @RequestMapping(value = "/fileupload")
    public String fileupload(HttpServletRequest request, MultipartFile upload) throws Exception {
        // 定义图片服务器的请求路径
        String path = "http://localhost:8080/uploads/";
        // 获取到上传文件的名称
        String filename = upload.getOriginalFilename();
        // 把文件加上随机数，防止文件重复
        String uuid = UUID.randomUUID().toString().replaceAll("-", "").toUpperCase();
        filename = uuid + "_" + filename;

        // 向图片服务器上传文件
        // 创建sun公司提供的jersey包中的Client对象
        Client client = Client.create();
        // 连接图片服务器，即指定上传文件的地址，该地址是 web 路径
        WebResource webResource = client.resource(path + filename);
        // 上传文件
        webResource.put(upload.getBytes());
        return "success";
    }

在这里插入图片描述
  出现以上错误的原因是因为将图片上传单独部署了一个服务器，导致图片不能写入。需要在 Tomcat 目录下的 conf 文件夹下的 web.xml 中加入：

    <init-param>
        <param-name>readonly</param-name>
        <param-value>false</param-value>
     </init-param>

在这里插入图片描述