【JavaWeb基础】文件上传和下载(修订版)

迈不过友情╰ 2021-09-30 23:00 440阅读 0赞

## 前言 ##

> 只有光头才能变强。
> 
> 文本已收录至我的GitHub仓库，欢迎Star：https://github.com/ZhongFuCheng3y/3y

# 什么是文件上传？ #

文件上传就是把用户的信息保存起来。

# 为什么需要文件上传？ #

在用户注册的时候，可能需要用户提交照片。那么这张照片就应该要进行保存。

# 上传组件(工具) #

## 为什么我们要使用上传工具？ ##

为啥我们需要上传组件呢？当我们要获取客户端的数据，我们一般是通过getParameter()方法来获取的。

**上传文件数据是经过MIME协议进行分割的，表单进行了二进制封装。也就是说：getParameter()无法获取得到上传文件的数据。**

我们首先来看看**文件上传http是怎么把数据带过去的**

<form action="${pageContext.request.contextPath }/servlet/UploadServlet1" enctype="multipart/form-data" method="post">  上传用户：<input type="text" name="username"><br/>  上传文件1：<input type="file" name="file1"><br/>  上传文件2：<input type="file" name="file2"><br/>  <input type="submit" value="提交"></form>
      上传用户：<input type="text" name="username"><br/>
      上传文件1：<input type="file" name="file1"><br/>
      上传文件2：<input type="file" name="file2"><br/>
      <input type="submit" value="提交">
    </form>

![640?wx\_fmt=png][640_wx_fmt_png] 这里写图片描述

String ss = request.getParameter("username");System.out.println(ss);
    System.out.println(ss);

![640?wx\_fmt=png][640_wx_fmt_png 1] 这里写图片描述

那么我们要怎么办呢？？？？**request对象提供了ServletInputStream流给我们读取数据**

ServletInputStream inputStream = request.getInputStream();byte[] bytes = new byte[1024];int len = 0;while ((len = inputStream.read(bytes)) > 0) {  System.out.println(new String(bytes, 0, len));}
    byte[] bytes = new byte[1024];
    int len = 0;
    
    while ((len = inputStream.read(bytes)) > 0) {
        
      System.out.println(new String(bytes, 0, len));
    }

<input type="text" name="password">

![640?wx\_fmt=png][640_wx_fmt_png 2] 这里写图片描述

现在我们能够读取上传文件的数据了，但是现在问题又来了：**怎么把文件上传个数据和普通传送给服务器的数据分割开来呢？？？**上面在图上我们已经看到了，他们是混合在一起的。

按我们平常的做法是很难分割开来的，所以我们需要上传组件

--------------------

## 上传组件有两种 ##

--------------------

# FileUpload #

要使用FileUpload组件，就需要导入两个jar包

## 开发步骤 ##

--------------------

## 快速入门 ##

try{  //1.得到解析器工厂  DiskFileItemFactory factory = new DiskFileItemFactory();  //2.得到解析器  ServletFileUpload upload = new ServletFileUpload(factory);  //3.判断上传表单的类型  if(!upload.isMultipartContent(request)){    //上传表单为普通表单，则按照传统方式获取数据即可    return;  }  //为上传表单，则调用解析器解析上传数据  List<FileItem> list = upload.parseRequest(request);  //FileItem  //遍历list，得到用于封装第一个上传输入项数据fileItem对象  for(FileItem item : list){    if(item.isFormField()){      //得到的是普通输入项      String name = item.getFieldName();  //得到输入项的名称      String value = item.getString();      System.out.println(name + "=" + value);    }else{      //得到上传输入项      String filename = item.getName();  //得到上传文件名  C:\Documents and Settings\ThinkPad\桌面\1.txt      filename = filename.substring(filename.lastIndexOf("\\")+1);      InputStream in = item.getInputStream();   //得到上传数据      int len = 0;      byte buffer[]= new byte[1024];      String savepath = this.getServletContext().getRealPath("/upload");      FileOutputStream out = new FileOutputStream(savepath + "\\" + filename);  //向upload目录中写入文件      while((len=in.read(buffer))>0){        out.write(buffer, 0, len);      }      in.close();      out.close();    }  }}catch (Exception e) {  e.printStackTrace();}
    
      //1.得到解析器工厂
      DiskFileItemFactory factory = new DiskFileItemFactory();
    
      //2.得到解析器
      ServletFileUpload upload = new ServletFileUpload(factory);
    
      //3.判断上传表单的类型
      if(!upload.isMultipartContent(request)){
        
        //上传表单为普通表单，则按照传统方式获取数据即可
        return;
      }
    
      //为上传表单，则调用解析器解析上传数据
      List<FileItem> list = upload.parseRequest(request);  //FileItem
    
      //遍历list，得到用于封装第一个上传输入项数据fileItem对象
      for(FileItem item : list){
        
    
        if(item.isFormField()){
        
          //得到的是普通输入项
          String name = item.getFieldName();  //得到输入项的名称
          String value = item.getString();
          System.out.println(name + "=" + value);
        }else{
        
          //得到上传输入项
          String filename = item.getName();  //得到上传文件名  C:\Documents and Settings\ThinkPad\桌面\1.txt
          filename = filename.substring(filename.lastIndexOf("\\")+1);
          InputStream in = item.getInputStream();   //得到上传数据
          int len = 0;
          byte buffer[]= new byte[1024];
    
    
          String savepath = this.getServletContext().getRealPath("/upload");
          FileOutputStream out = new FileOutputStream(savepath + "\\" + filename);  //向upload目录中写入文件
          while((len=in.read(buffer))>0){
        
            out.write(buffer, 0, len);
          }
    
          in.close();
          out.close();
        }
      }
    
    }catch (Exception e) {
        
      e.printStackTrace();
    }

### 测试 ###

![640?wx\_fmt=png][640_wx_fmt_png 3] 这里写图片描述

--------------------

# SmartUpload #

要使用SmartUpload组件，就需要**导入smartupload.jar开发包**

## 快速入门 ##

//实例化组件SmartUpload smartUpload = new SmartUpload();//初始化上传操作smartUpload.initialize(this.getServletConfig(), request, response);try {  //上传准备  smartUpload.upload();  //对于普通数据，单纯到request对象是无法获取得到提交参数的。也是需要依赖smartUpload  String password = smartUpload.getRequest().getParameter("password");  System.out.println(password);  //上传到uploadFile文件夹中  smartUpload.save("uploadFile");} catch (SmartUploadException e) {  e.printStackTrace();}
    SmartUpload smartUpload = new SmartUpload();
    
    //初始化上传操作
    smartUpload.initialize(this.getServletConfig(), request, response);
    
    
    try {
        
    
      //上传准备
      smartUpload.upload();
    
      //对于普通数据，单纯到request对象是无法获取得到提交参数的。也是需要依赖smartUpload
      String password = smartUpload.getRequest().getParameter("password");
      System.out.println(password);
    
      //上传到uploadFile文件夹中
      smartUpload.save("uploadFile");
    
    
    } catch (SmartUploadException e) {
        
      e.printStackTrace();
    }

## 测试 ##

同样地，**我们可以上传文件到uploadFile文件夹中。代码量也的确减少很多！**

**也能够获取普通字段的参数**

![640?wx\_fmt=png][640_wx_fmt_png 4] 这里写图片描述

--------------------

# 上传文件名的中文乱码和上传数据的中文乱码 #

![640?wx\_fmt=png][640_wx_fmt_png 5] 这里写图片描述![640?wx\_fmt=png][640_wx_fmt_png 6] 这里写图片描述

上面已经说了，上传文件的数据的**表单进行了二进制封装**，所以**使用request对数据编码编码，对于表单提交过来的数据是不奏效的！**

## FileUpload解决乱码 ##

使用FileUpload解决乱码问题是十分简单的

//设置upload的编码        fileUpload.setHeaderEncoding("UTF-8");
            fileUpload.setHeaderEncoding("UTF-8");

String value = fileItem.getString("UTF-8");

### **效果：** ###

![640?wx\_fmt=png][640_wx_fmt_png 7] 这里写图片描述

--------------------

## **SmartUpload解决乱码** ##

这个组件解决乱码问题有点麻烦，在网上找了各种办法也没找到简单的……

所以，**如果数据不涉及到中文就使用SmartUpload组件，涉及到中文数据就使用FileUpload组件吧！**

--------------------

# 多个文件上传，动态添加上传控件 #

假设我现在有多个文件要上传，而且要**上传的个数是不确定的**。那么我们要怎么办呢？？？

我们不可能列出很多很多个上传文件的控件在页面上，这样不美观。如果用户用不到那么多个控件，也浪费呀。

所以，我们想要动态地增添上传文件的控件，**如果用户还想要上传文件，只需要动态地生成控件出来即可！**

## 分析 ##

要想在页面上动态地生成控件，无非就是使用JavaScript代码。

那么我们要怎么做呢？？

这样子吧：**当用户想要上传文件的时候，就点击按钮，按钮绑定事件，生成文件上传的控件**。

为了做得更加完善，**每当生成了文件上传的控件，也提供一个删除按钮，删除该控件！**

我们**应该使用div装载着我们要生成的控件和删除按钮，而用户点击删除的时候，应该是要把删除按钮和文件上传控件都一起隐藏起来的**。所以，最好就是使用**嵌套div**！

## 代码 ##

<table border="1px">    <tr>        <td>上传用户：</td>        <td><input type="text" name="username"></td>    </tr>    <tr>        <td>添加上传文件</td>        <td><input type="button" value="添加上传文件" onclick="addUploadFile()"> </td>    </tr>    <tr>        <td>            <div id="file">            </div>        </td>    </tr></table>
    
        <tr>
            <td>上传用户：</td>
            <td><input type="text" name="username"></td>
        </tr>
    
        <tr>
            <td>添加上传文件</td>
            <td><input type="button" value="添加上传文件" onclick="addUploadFile()"> </td>
        </tr>
    
        <tr>
    
            <td>
                <div id="file">
                </div>
            </td>
        </tr>
    
    </table>

--------------------

# 文件上传细节 #

## 分析 ##

删除临时文件问题是非常简单的，只需要**在所有的操作完毕之后，调用FileItem的delete()方法即可**

让上传文件的位置不能在WEB服务器管理之下，我们**把上传文件的位置放到WEB-INF/目录下即可！**

文件名相同的问题，我们可以**使用UUID+用户上传的文件名来作为我们保存上传文件名**。这样的文件名就是独一无二的了。

要将上传的文件进行打散，那么我们需要**使用HashCode算法来进行打散**。

## 代码 ##

下面我们写一个比较完善的上传文件代码

private String makeDirPath(String fileName, String path) {  //通过文件名来算出一级目录和二级目录  int hashCode = fileName.hashCode();  int dir1 = hashCode & 0xf;  int dir2 = (hashCode & 0xf0) >> 4;  String dir = path + "\\" + dir1 + "\\" + dir2;  //如果该目录不存在，就创建目录  File file = new File(dir);  if (!file.exists()) {    file.mkdirs();  }  //返回全路径  return dir;}
    
      //通过文件名来算出一级目录和二级目录
      int hashCode = fileName.hashCode();
      int dir1 = hashCode & 0xf;
      int dir2 = (hashCode & 0xf0) >> 4;
    
      String dir = path + "\\" + dir1 + "\\" + dir2;
    
      //如果该目录不存在，就创建目录
      File file = new File(dir);
      if (!file.exists()) {
        
    
        file.mkdirs();
      }
      //返回全路径
      return dir;
    
    }

private String makeFileName(String fileName) {  //使用下划线把UUID和文件名分割开来，后面可能会解析文件名的。  return UUID.randomUUID().toString() + "_"+ fileName;}
    
      //使用下划线把UUID和文件名分割开来，后面可能会解析文件名的。
      return UUID.randomUUID().toString() + "_"+ fileName;
    
    }

//创建工厂DiskFileItemFactory factory = new DiskFileItemFactory();//通过工厂创建解析器ServletFileUpload fileUpload = new ServletFileUpload(factory);//设置upload的编码fileUpload.setHeaderEncoding("UTF-8");//判断上传表单的类型if(!fileUpload.isMultipartContent(request)){  //上传表单为普通表单，则按照传统方式获取数据即可  return;}try {  //解析request对象，得到List【装载着上传的全部内容】  List<FileItem> list = fileUpload.parseRequest(request);  //遍历List，判断装载的内容是普通字段还是上传文件  for (FileItem fileItem : list) {    //如果是普通输入项    if (fileItem.isFormField()) {      //得到输入项的名称和值      String name = fileItem.getFieldName();      String value = fileItem.getString("UTF-8");      System.out.println(name + " = " + value);    } else {      //如果是上传文件      //得到上传名称【包括路径名】      String fileName = fileItem.getName();      //截取文件名      fileName = fileName.substring(fileName.lastIndexOf("\\") + 1);      //生成独一无二的文件名      fileName = makeFileName(fileName);      InputStream inputStream = fileItem.getInputStream();      //得到项目的路径，把上传文件写到项目中      String path = this.getServletContext().getRealPath("/WEB-INF/uploadFile");      //得到分散后的目录路径      String realPath = makeDirPath(fileName, path);      FileOutputStream outputStream = new FileOutputStream(realPath + "\\" + fileName);      byte[] bytes = new byte[1024];      int len = 0;      while ((len = inputStream.read(bytes)) > 0) {        outputStream.write(bytes, 0, len);      }      inputStream.close();      outputStream.close();      //删除临时文件的数据      fileItem.delete();    }  }} catch (FileUploadException e) {  e.printStackTrace();}
    DiskFileItemFactory factory = new DiskFileItemFactory();
    
    //通过工厂创建解析器
    ServletFileUpload fileUpload = new ServletFileUpload(factory);
    
    //设置upload的编码
    fileUpload.setHeaderEncoding("UTF-8");
    
    //判断上传表单的类型
    if(!fileUpload.isMultipartContent(request)){
        
      //上传表单为普通表单，则按照传统方式获取数据即可
      return;
    }
    
    try {
        
    
      //解析request对象，得到List【装载着上传的全部内容】
      List<FileItem> list = fileUpload.parseRequest(request);
    
      //遍历List，判断装载的内容是普通字段还是上传文件
      for (FileItem fileItem : list) {
        
    
        //如果是普通输入项
        if (fileItem.isFormField()) {
        
    
          //得到输入项的名称和值
          String name = fileItem.getFieldName();
          String value = fileItem.getString("UTF-8");
    
          System.out.println(name + " = " + value);
        } else {
        
    
          //如果是上传文件
    
          //得到上传名称【包括路径名】
          String fileName = fileItem.getName();
    
          //截取文件名
          fileName = fileName.substring(fileName.lastIndexOf("\\") + 1);
    
          //生成独一无二的文件名
          fileName = makeFileName(fileName);
    
          InputStream inputStream = fileItem.getInputStream();
    
          //得到项目的路径，把上传文件写到项目中
          String path = this.getServletContext().getRealPath("/WEB-INF/uploadFile");
    
          //得到分散后的目录路径
          String realPath = makeDirPath(fileName, path);
    
          FileOutputStream outputStream = new FileOutputStream(realPath + "\\" + fileName);
    
          byte[] bytes = new byte[1024];
          int len = 0;
          while ((len = inputStream.read(bytes)) > 0) {
        
            outputStream.write(bytes, 0, len);
          }
    
          inputStream.close();
          outputStream.close();
    
          //删除临时文件的数据
          fileItem.delete();
    
        }
      }
    
    } catch (FileUploadException e) {
        
      e.printStackTrace();
    }

## 效果： ##

![640?wx\_fmt=png][640_wx_fmt_png 8] 这里写图片描述

--------------------

# 列出上传目录下的文件，提供下载 #

在讲解respose对象的时候已经讲解过文件下载了。这次我们就直接写一个小案例来巩固文件下载把。

![640?wx\_fmt=png][640_wx_fmt_png 9] 这里写图片描述

## 分析 ##

首先，要把目录下的文件都列出来。由于后**面要根据文件名对文件进行下载，所以我们用一个Map集合来保存所有的文件**

下载文件部分也很简单，**根据文件名和上传文件位置找到对应的文件，对其进行读写，然后修改消息头实现下载就好了。**

## 代码 ##

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {  //得到上传文件的目录  String filePath = this.getServletContext().getRealPath("/WEB-INF/uploadFile");  Map map = new HashMap();  //使用递归来得到所有的文件，并添加到Map集合中  getAllFiles(new File(filePath), map);  request.setAttribute("map", map);  request.getRequestDispatcher("/listFile.jsp").forward(request, response);}private void getAllFiles(File filePath, Map map) {  //如果不是文件，那么它就是文件夹  if (!filePath.isFile()) {    //列出文件夹下所有的文件（可能是文件，可能是文件夹）    File[] files = filePath.listFiles();    for (File file : files) {      //得到的文件（或者是文件夹）再对其进行判断      getAllFiles(file, map);    }  } else {    //进入到else语句了，肯定是文件了    //得到文件名    String fileName = filePath.getName().substring(filePath.getName().lastIndexOf("_") + 1);    //我们将文件全名作为key，文件名作为value保存在map集合中    map.put(filePath.getName(), fileName);  }}
    
    
      //得到上传文件的目录
      String filePath = this.getServletContext().getRealPath("/WEB-INF/uploadFile");
    
      Map map = new HashMap();
    
      //使用递归来得到所有的文件，并添加到Map集合中
      getAllFiles(new File(filePath), map);
    
      request.setAttribute("map", map);
      request.getRequestDispatcher("/listFile.jsp").forward(request, response);
    
    
    
    }
    
    private void getAllFiles(File filePath, Map map) {
        
    
      //如果不是文件，那么它就是文件夹
      if (!filePath.isFile()) {
        
    
        //列出文件夹下所有的文件（可能是文件，可能是文件夹）
        File[] files = filePath.listFiles();
        for (File file : files) {
        
    
          //得到的文件（或者是文件夹）再对其进行判断
          getAllFiles(file, map);
        }
      } else {
        
        //进入到else语句了，肯定是文件了
    
        //得到文件名
        String fileName = filePath.getName().substring(filePath.getName().lastIndexOf("_") + 1);
    
        //我们将文件全名作为key，文件名作为value保存在map集合中
        map.put(filePath.getName(), fileName);
    
      }
    
    }

<c:forEach items="${map}" var="me">    <c:url var="url" value="/DownFileServlet">        <c:param name="fileName" value="${me.key}"></c:param>    </c:url>    ${me.value}<a href="${url}">下载！</a><br></c:forEach>"me">
    
        <c:url var="url" value="/DownFileServlet">
            <c:param name="fileName" value="${me.key}"></c:param>
        </c:url>
        ${me.value}<a href="${url}">下载！</a><br>
    
    </c:forEach>

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {  //得到文件的全名  String fileName = request.getParameter("fileName");  //如果是中文数据，需要转码。  fileName = new String(fileName.getBytes("ISO8859-1"), "utf-8");  //得到保存文件的位置  String path = this.getServletContext().getRealPath("/WEB-INF/uploadFile");  //文件是通过文件名进行hashCode打散保存的，通过文件名拿到文件绝对路径  String fileRealPath = makeFilePath(fileName, path);  System.out.println(fileRealPath);  //判断文件是否存在  File file = new File(fileRealPath);  if (!file.exists()) {    request.setAttribute("message", "您要下载的资源不存在了！");    request.getRequestDispatcher("/message.jsp").forward(request, response);    return ;  }  //存在  //读取该文件并把数据写给浏览器  FileInputStream inputStream = new FileInputStream(fileRealPath);  byte[] bytes = new byte[1024];  int len = 0;  while ((len = inputStream.read(bytes)) > 0) {    response.getOutputStream().write(bytes, 0, len);  }  inputStream.close();  //设置消息头，告诉浏览器，这是下载的文件  String name = fileName.substring(fileName.lastIndexOf("_") + 1);  response.setHeader("content-disposition","attachment;filename=" + URLEncoder.encode(name, "UTF-8"));}private String makeFilePath(String fileName, String path) {  int hashCode = fileName.hashCode();  int dir1 = hashCode & 0xf;  int dir2 = (hashCode & 0xf0) >> 4;  String dir = path + "\\" + dir1 + "\\" + dir2 +"\\"+ fileName;  return dir;}
    
      //得到文件的全名
      String fileName = request.getParameter("fileName");
    
      //如果是中文数据，需要转码。
      fileName = new String(fileName.getBytes("ISO8859-1"), "utf-8");
    
      //得到保存文件的位置
      String path = this.getServletContext().getRealPath("/WEB-INF/uploadFile");
    
      //文件是通过文件名进行hashCode打散保存的，通过文件名拿到文件绝对路径
      String fileRealPath = makeFilePath(fileName, path);
      System.out.println(fileRealPath);
    
      //判断文件是否存在
      File file = new File(fileRealPath);
      if (!file.exists()) {
        
        request.setAttribute("message", "您要下载的资源不存在了！");
        request.getRequestDispatcher("/message.jsp").forward(request, response);
        return ;
      }
    
      //存在
    
      //读取该文件并把数据写给浏览器
      FileInputStream inputStream = new FileInputStream(fileRealPath);
      byte[] bytes = new byte[1024];
      int len = 0;
      while ((len = inputStream.read(bytes)) > 0) {
        
        response.getOutputStream().write(bytes, 0, len);
      }
    
      inputStream.close();
    
    
      //设置消息头，告诉浏览器，这是下载的文件
      String name = fileName.substring(fileName.lastIndexOf("_") + 1);
      response.setHeader("content-disposition","attachment;filename=" + URLEncoder.encode(name, "UTF-8"));
    
    }
    
    private String makeFilePath(String fileName, String path) {
        
    
      int hashCode = fileName.hashCode();
    
      int dir1 = hashCode & 0xf;
      int dir2 = (hashCode & 0xf0) >> 4;
    
      String dir = path + "\\" + dir1 + "\\" + dir2 +"\\"+ fileName;
      return dir;
    }

## 最后 ##

##  ##

> 乐于输出**干货**的Java技术公众号：Java3y。公众号内有200多篇**原创**技术文章、海量视频资源、精美脑图，不妨来**关注**一下！

![640?wx\_fmt=jpeg][640_wx_fmt_jpeg]

有帮助？好看！转发！ ![640][]

[640_wx_fmt_png]: /images/20210827/ce05c67dec0646d6b3a83880f4c44f6e.png?wx_fmt=png
[640_wx_fmt_png 1]: /images/20210827/e41304f6a0a643bc87e7bc3712c944ec.png?wx_fmt=png
[640_wx_fmt_png 2]: /images/20210827/e70e720eedae46709d55cffee610d932.png?wx_fmt=png
[640_wx_fmt_png 3]: /images/20210827/2361d72dfcb64967a86aa6f3176d1ccf.png?wx_fmt=png
[640_wx_fmt_png 4]: /images/20210827/c93bf857839c44c1b442f3248a4e6296.png?wx_fmt=png
[640_wx_fmt_png 5]: https://ss.csdn.net/p?https://mmbiz.qpic.cn/mmbiz_png/2BGWl1qPxib2N4xnOl3eGTdY2gvsYhf0rMKhzM65qDORiaVQWtDBAOJuiam1E1OS75MTibjFzZuA5SOCfftbfwPglw/640?wx_fmt=png
[640_wx_fmt_png 6]: /images/20210827/9576c660b74e4cf39e43fddce45c9b4c.png?wx_fmt=png
[640_wx_fmt_png 7]: /images/20210827/223279b861f64fdaa98752b950570fc9.png?wx_fmt=png
[640_wx_fmt_png 8]: /images/20210827/a4eb67ea9cb24f88ae9159d89538050f.png?wx_fmt=png
[640_wx_fmt_png 9]: /images/20210827/1a827e4857304829b9c0dfd48516bab7.png?wx_fmt=png
[640_wx_fmt_jpeg]: /images/20210827/df74880aa20743b4ae9c16b592d81d2f.png?wx_fmt=jpeg
[640]: /images/20210827/4d4cd4861a4843639d842e1a5787d338.png