Java web的文件上传与下载(实战）

Myth丶恋晨 2021-09-21 11:14 383阅读 0赞

#### 引言 ####

在Web应用中，由于大多数文件的上传都是通过表单的形式提交给服务器的，因此，要想在程序中实现文件上传的功能，首先得创建一个用于提交上传文件的表单页面。

> 标签的使用需要注意以下两点：  
> 必须要设置input输入项的name属性，否则浏览器将不会发送上传文件的数据。  
> 必须把将表单页面的method属性设置为post方式，文件的上传是通过二进制的形式上传数据的，enctype属性设置为“multipart/form-data”类型。

<form enctype=“multipart/form-data” method=“post”>
              选择上传文件：<input type=“file” name=“myfile”/><br />
       </form>

文件的上传比较复杂，因此，Apache组织提供了一个开源组件Commons-FileUpload.jar，我们使用这个工具类来对文件进行操作，FileUpload组件也是通过Servlet来实现文件上传功能的。其工作流程如下所示。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center]

#### 准备工作 ####

> 开发工具：Intellij IDEA/Eclipse  
> 所需jar包：commons-fileupload-1.\*.jar和commons-io-1.4.jar  
> [jar包下载网址：https://mvnrepository.com/][jar_https_mvnrepository.com]  
> 也可以通过关注公众号微信公众号源码客栈回复 ”jar"领取jar包的网盘地址下载  
> ![在这里插入图片描述][20200921182506788.jpg_pic_center]

##### fileupload组件里的一些常用的方法 #####

> 我们用到的有isFormFied()、getName()、getFiedName()、write(File file) 、getString()、void delete()等

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 1]

#### DiskFileItemFactory工厂类说明 ####

DiskFileItemFactory类用于将请求消息实体中的每一个文件封装成单独的FileItem对象。如果上传的文件比较小，将直接保存在内存中，如果上传的文件比较大，则会以临时文件的形式，保存在磁盘的临时文件夹中。默认情况下，文件保存在内存还是硬盘临时文件夹的临界值是10240，即10kb。  
DiskFileItemFactory类的两个构造方法：

> DiskFileItemFactory()：采用默认临界值和系统临时文件夹构造文件项工厂对象  
> DiskFileItemFactory(int sizeThreshold，File repository)：采用参数指定临界值和系统临时文件夹构造文件项工厂对象

ServletFileUpload():构造一个未初始化的ServletFileUpload实例对象

> ServletFileUpload(FileItemFactory fileItemFactory):根据参数指定的FileItemFactory 对象创建一个ServletFileUpload对象  
> ServletFileUpload类是Apache组件处理文件上传的核心高级类，通过使用parseRequest(HttpServletRequest) 方法可以将HTML中每个表单提交的数据封装成一个FileItem对象，然后以List列表的形式返回。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 2]

#### 文件下载 ####

对于文件下载，人们并不陌生，我们经常会在某网站下载图片，下载电影等等。  
实现文件下载功能比较简单，直接使用Servlet类和输入/输出流即可实现。实现文件的下载，不仅需要指定文件的路径，还需要在HTTP协议中设置两个响应消息头：

> //设定接受程序处理数据的方式  
> Content-Disposition：attachment; filename =  
> //设定试题内容的MIME类型  
> Content-Type：application/x-msdownload

浏览器通常会直接处理响应的实体内容。当我们需要在HTTP响应消息中设置这两个响应消息头字段，来指定接收程序处理数据内容的方式为下载方式，当单击“下载”超链接时，系统将请求提交到对应的Servlet。在该Servlet中，首先获取下载文件的地址，并根据该地址创建文件字节输入流，然后通过该流读取下载文件内容，最后将读取的内容通过输出流写到目标文件中。

#### 项目骨架 ####

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 3]

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <title>Title</title>
    </head>
    <body>
    <form enctype="multipart/form-data" action="/UploadServlet" method="post">
        用户名:<input type="text" name="username"><br>
       头像： <input type="file" name="photo"><br>
        <input type="submit" value="提交">
    </form>
    
    </body>
    </html>

#### 创建实体类 ####

> 我们通过实体类来暂时保存表单里面的value值和文件的路径

private String username;
     private String photo;
     //setter和getter方法
    @Override
        public String toString() {
            return "User{" +
                    "username='" + username + '\'' +
                    ", photo='" + photo + '\'' +
                    '}';
       }

#### web.xml配置 ####

<?xml version="1.0" encoding="UTF-8"?>
    <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
             version="4.0">
    
        <servlet>
            <servlet-name>UploadServlet</servlet-name>
            <servlet-class>edu.ymkz.web.UploadServlet</servlet-class>
        </servlet>
        <servlet-mapping>
            <servlet-name>UploadServlet</servlet-name>
            <url-pattern>/UploadServlet</url-pattern>
        </servlet-mapping>
    
        <servlet>
            <servlet-name>DownloadServlet</servlet-name>
            <servlet-class>edu.ymkz.web.DownloadServlet</servlet-class>
        </servlet>
        <servlet-mapping>
            <servlet-name>DownloadServlet</servlet-name>
            <url-pattern>/DownloadServlet</url-pattern>
        </servlet-mapping>
    
    </web-app>

#### 上传文件 fileupload.jsp ####

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 4]

#### UploadServlet(处理下载请求） ####

package edu.ymkz.web;
    import edu.ymkz.entity.User;
    import org.apache.commons.fileupload.FileItem;
    import org.apache.commons.fileupload.FileItemFactory;
    import org.apache.commons.fileupload.disk.DiskFileItemFactory;
    import org.apache.commons.fileupload.servlet.ServletFileUpload;
    import javax.servlet.ServletException;
    import javax.servlet.ServletInputStream;
    import javax.servlet.http.HttpServlet;
    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    import java.io.File;
    import java.io.IOException;
    import java.util.List;
    public class UploadServlet extends HttpServlet {
        @Override
        protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
           doPost(req,resp);//调用doPost方法
        }
        @Override
        protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
            req.setCharacterEncoding("utf-8");//处理乱码
            String path="D:\\Program Files\\JetBrains\\idea_projects\\java web\\file_upload\\web\\file\\";
            //默认的文件保存路径，也就是项目的工程所在位置
         //先判断是否是多段的数据，如果返回true，表示普通的表单项，false为文件
            if(ServletFileUpload.isMultipartContent(req)){
                FileItemFactory fileItemFactory=new DiskFileItemFactory();//创建本地文件系统
                ServletFileUpload servletFileUpload=new ServletFileUpload(fileItemFactory);
                try {
                    List<FileItem> list=servletFileUpload.parseRequest(req);//解析多段数据
                    User user=new User();
                   for(FileItem fileItem:list){
                        if(fileItem.isFormField()){//普通表单项
                            user.setUsername(fileItem.getString("utf-8"));//保存普通表但的值
                            System.out.println("表单项的name值"+fileItem.getFieldName());
                            System.out.println("表单项的value值"+fileItem.getString("utf-8"));//解决乱码
                        }else{//文件
                         user.setPhoto(path+fileItem.getName());//把图片的路径保存起来
                            System.out.println("表单项的name值"+fileItem.getFieldName());
                            System.out.println("表单项的value值"+fileItem.getName());//解决乱码
                            fileItem.write(new File(path+fileItem.getName()));
                        }
      					}
                    System.out.println(user.toString());//打印出保存的value值
                }catch (Exception e){
                    e.printStackTrace();
                }
            }
        }
    }

#### UploadServlet打印结果 ####

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 5]

#### 文件下载 download.jsp ####

若图片上传之后不显示，请删除项目里的out目录然后重新部署，就可以了

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
    <html>
    <head>
        <title>Title</title>
    </head>
    <body>
       <img src="/file/ymkz.jpg" /><br>
       <a href="/DownloadServlet?filename=源码客栈.jpg">下载</a>
    </body>
    </html>

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 6]

#### 文件下载DownloadServet ####

//超链接时doGet方法，当请求传到doGet方法之后再调用doPost方法

package edu.ymkz.web;
    import org.apache.commons.io.IOUtils;
    import sun.misc.BASE64Encoder;
    import javax.servlet.*;
    import javax.servlet.annotation.WebServlet;
    import javax.servlet.descriptor.JspConfigDescriptor;
    import javax.servlet.http.HttpServlet;
    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    import java.io.IOException;
    import java.io.InputStream;
    import java.io.OutputStream;
    import java.io.UnsupportedEncodingException;
    import java.net.MalformedURLException;
    import java.net.URL;
    import java.net.URLEncoder;
    import java.util.Enumeration;
    import java.util.EventListener;
    import java.util.Map;
    import java.util.Set;
    @WebServlet(name = "DownloadServlet")
    public class DownloadServlet extends HttpServlet {
        protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
            String downloadFileName = request.getParameter("filename");
            System.out.println(downloadFileName);
            ServletContext servletContext = getServletContext();
            String mimeType = servletContext.getMimeType("/file/" + downloadFileName);
            System.out.println("下载的文件类型" + mimeType);
            response.setContentType(mimeType);
            //attachment表示附件，filename是文件名，表示用来下载的文件名
            if (request.getHeader("User-Agent").contains("Firefox")) {
                response.setHeader("Content-Disposition", "attachment;filename=?UTF-8?B?" + new BASE64Encoder().encode(downloadFileName.getBytes("UTF-8")) + "?=");
            } else {//处理下载之后文件名 为乱码，针对ie google等浏览器
                response.setHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(downloadFileName, "utf-8"));
    
            }
            //火狐，谷歌兼容性最好，
            InputStream inputStream = servletContext.getResourceAsStream("/file/" + downloadFileName);
            byte[] bytes = new byte[1024];
            OutputStream outputStream = response.getOutputStream();
            IOUtils.copy(inputStream, outputStream);
        }
    
        protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
            doPost(request, response);
        }
    }

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center]: /images/20210920/4a4db66c015441fb94f22a23fc827881.png
[jar_https_mvnrepository.com]: https://mvnrepository.com/
[20200921182506788.jpg_pic_center]: /images/20210920/be32749c953648c087168c6f98147df4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20210920/baf4f5a5f0c9436ea5781bca510f8ef3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20210920/46d24cc344654a7bb7a9e12692d09cf3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20210920/7b93984057234a10bde979b1b9603b7a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20210920/d400bc475e4d4f58a9f1dd05324f2d61.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 5]: /images/20210920/cbc07356a5914a0886419df1f153b313.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpcXo2NjY_size_16_color_FFFFFF_t_70_pic_center 6]: /images/20210920/3824e50969014dc7a846aad8a79287a5.png