一、文件的上传

将用户本地磁盘中的文件提交保存到服务器中的磁盘上。

1.1、存在的问题.

我们要做文件上传，一般的步骤是：

要有一个 form 标签，method=post 请求。因为get请求里面限制了大小。
form 标签的 encType 属性值必须为 multipart/form-data 值。
在 form 标签中使用 input type=file 添加上传的文件。
编写服务器代码（Servlet 程序）接收，处理上传的数据。

encType=multipart/form-data 表示提交的数据，以多段（每一个表单项一个数据段）的形式进行拼接，然后以二进制流的形式发送给服务器。

我们通过写代码可以发现，enctype="multipart/form-data" 提交的数据，getParameter() 无法获取到。

1.2、Servlet3.0 文件上传

既然文件上传如此头疼，那么总该有人挺身而出帮我们解决这个难题。Servlet 3.0 提供了文件上传操作功能，而且使用也非常简单。

我们只需要给 Servlet 贴一个注解 @MultipartConfig 然后使用getPart()获取请求中指定 name 的文件到 Part 对象，就可以使用它的API来进行操作文件了。

1.3、API

HttpServletRequest 提供了两个方法用于从请求中解析上传的文件。

返回值	方法	作用
Part	getPart(String name)	用于获取请求中指定 name 的文件
Collection	getParts()	获取请求中全部的文件

Part中常用的方法：

返回值	方法	作用
void	write(String fileName)	直接把接收到的文件保存在磁盘中
void	getContentType()	获取文件的MIME类型
String	getHeader(String name)	获取请求头信息
long	getSize()	获取文件的大小

1.4、代码

package com.servlet;
import java.io.IOException;
import java.net.http.HttpClient;
import javax.servlet.ServletException;
import javax.servlet.annotation.MultipartConfig;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.Part;
/**
 * @author Xiao_Lin
 * @date 2021/1/20 9:26
 */
@WebServlet("/fileUpload")
@MultipartConfig
public class FileUploadServlet extends HttpServlet {
  @Override
  protected void service(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    // 普通的参数还是使用原来的接收方式
    String username = req.getParameter("username");
    // 文件数据的获取
    Part part = req.getPart("headImg");
    //保存到磁盘,参数名称为盘符+文件名+后缀名（自己命名）
    part.write("d:/headimg.jpg");
复制代码

<%@page contentType="text/html; UTF-8" pageEncoding="UTF-8" isELIgnored="false" %>
<html>
<body>
<h2>Hello World!</h2>
<form action="/fileUpload" method="post" enctype="multipart/form-data">
    用户名：<input type="text" name="username">
    上传文件:<input type="file" name="headImg">
    <input type="submit" value="注册">
</form>
</body>
</html>
复制代码

二、文件上传拓展

2.1、获取上传文件名

我们可以使用可使用 Part对象的API来获取。

返回值	方法	作用
String	getHeader("content-disposition")	Tocmat 8.0 之前使用通过请求头获取文件名，需截取字符串
String	getSubmittedFileName()	Tomcat8.0 之后提供的直接获取文件名方式

package com.servlet;
import java.io.IOException;
import java.net.http.HttpClient;
import javax.servlet.ServletException;
import javax.servlet.annotation.MultipartConfig;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.Part;
/**
 * @author Xiao_Lin
 * @date 2021/1/20 9:26
 */
@WebServlet("/fileUpload")
@MultipartConfig
public class FileUploadServlet extends HttpServlet {
  @Override
  protected void service(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    // 普通的参数还是使用原来的接收方式
    String username = req.getParameter("username");
    // 文件数据的获取
    Part part = req.getPart("headImg");
    // 保存到磁盘,参数名称为盘符+文件名+后缀名(自动获取文件名)
    part.write("d:/"+part.getSubmittedFileName());
  }
}
复制代码

2.2、使用UUID生成文件名

若上传得文件名相同会导致覆盖服务器之前已上传的的文件，我们的解决方法就是自己给文件起一个唯一的名称，确保不被覆盖，这里我们使用的是 UUID。

package com.servlet;
import java.io.IOException;
import java.net.http.HttpClient;
import java.util.UUID;
import javax.servlet.ServletException;
import javax.servlet.annotation.MultipartConfig;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.Part;
/**
 * @author Xiao_Lin
 * @date 2021/1/20 9:26
 */
@WebServlet("/fileUpload")
@MultipartConfig
public class FileUploadServlet extends HttpServlet {
  @Override
  protected void service(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    // 文件数据的获取
      Part part = req.getPart("headImg");
    //获取上传的文件名
    String realName = part.getSubmittedFileName();
    //拿到文件的拓展名
    String ext = realName.substring(realName.lastIndexOf("."));
    //生成唯一的UUID，保证不会重复
    String fileNewName = UUID.randomUUID().toString()+ext;
    part.write("d://"+fileNewName);
  }
}
复制代码

注意：在tomcat7 的环境下就没有part.getSubmittedFileName()这一方法，无法直接获取文件名，如果使用的是Tomcat7插件或者是Tomcat8以下的版本，需要换方法。不然会报错。

String cd = part.getHeader("Content-Disposition");
//截取不同类型的文件需要自行判断
 String filename = cd.substring(cd.lastIndexOf("=")+2, cd.length()-1);
复制代码

2.3、文件保存位置问题

文件在磁盘某个位置，不在项目下，无法使用 HTTP 协议访问，所以要把用户上传的文件存放到项目中

才可通过 HTTP 协议来访问，且保存的位置路径不可以写绝对路径，那么我们该如何进行访问呢？

我们可以通过ServletContext 对象的 getRealPath("项目中保存上传文件的文件夹的相对路径") 来获取其的绝对路径。

我们在webapps目录下新建一个upload用来存放文件。

package com.servlet;
import java.io.IOException;
import java.net.http.HttpClient;
import java.util.UUID;
import javax.servlet.ServletException;
import javax.servlet.annotation.MultipartConfig;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.Part;
/**
 * @author Xiao_Lin
 * @date 2021/1/20 9:26
 */
@WebServlet("/fileUpload")
@MultipartConfig
public class FileUploadServlet extends HttpServlet {
  @Override
  protected void service(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    // 文件数据的获取
      Part part = req.getPart("headImg");
    String cd = part.getHeader("Content-Disposition");
    //获取上传的文件名
    String realName = cd.substring(cd.lastIndexOf("=")+2, cd.length()-1);
    //拿到文件的拓展名
    String ext = realName.substring(realName.lastIndexOf("."));
    //生成唯一的UUID，保证不会重复
    String fileNewName = UUID.randomUUID().toString()+ext;
    // 获取项目下的 upload 目录的绝对路径，拼接成文件的保存路径(maven项目需要用tomcat7才可以)
    String realPath = req.getServletContext().getRealPath("/upload") +"/"+ fileNewName;
    part.write(realPath);
  }
}
复制代码

2.4、文件类型的约束

限制用户恶意上传文件，比如要让用户上传头像，而用户却上传一个非图片文件，比如 JSP 文件。

package com.servlet;
import java.io.IOException;
import java.net.http.HttpClient;
import java.util.UUID;
import javax.servlet.ServletException;
import javax.servlet.annotation.MultipartConfig;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.Part;
/**
 * @author Xiao_Lin
 * @date 2021/1/20 9:26
 */
@WebServlet("/fileUpload")
@MultipartConfig
public class FileUploadServlet extends HttpServlet {
  @Override
  protected void service(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    // 文件数据的获取
    Part part = req.getPart("headImg");
    System.out.println(part.getContentType());
    // 如果上传的文件不是图片（文件扩展名不是以image开头的就不是图片）
    if (!part.getContentType().startsWith("image/")) {
      req.setAttribute("msg","请上传图片");
      req.getRequestDispatcher("/index.jsp").forward(req, resp);
      return;
    }
  }
}
复制代码

2.5、文件的大小约束

文件上传限制大小可提高服务器硬盘的使用率，防止用户恶意上传文件造成服务器磁盘资源紧张。我们可以通过设置 @MutipartConfig 的属性做限制，他有两个属性：

maxFileSize：单个上传文件大小限制，单位：bytes。
·maxRequestSize·：显示请求中数据的大小，单位：bytes。

@MultipartConfig(maxFileSize = 80000, maxRequestSize = 140000)
复制代码

三、文件的下载

3.1、代码

package com.servlet;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
/**
 * @author Xiao_Lin
 * @date 2021/1/21 10:58
 */
@WebServlet(urlPatterns = "/download")
public class DownloadServlet extends HttpServlet {
  @Override
  protected void service(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    // 获取用户需要下载的文件名称
    String fileName = req.getParameter("fileName");
    // 获取文件所在的根路径
    String realPath = req.getServletContext().getRealPath("/WEB-INF/upload/");
    // 使用工具类Files的copy方法获取一个文件输出流，响应给浏览器
    Files.copy(Paths.get(realPath,fileName),resp.getOutputStream());
  }
}
复制代码

3.2、下载文件的名称问题

默认情况下，Tomcat 服务器未告知浏览器文件的名称，所以需要手动设置响应头来告知浏览器文件名称。

// 给浏览器一个推荐名称
resp.setHeader("Content-Disposition", "attachment;filename=文件名称");
复制代码

如果文件中有中文的话还涉及到需要处理中文乱码的问题，这里分为两个流派：

IE 使用 URL 编码方式：URLEncoder.encode(fileName, "UTF-8")
非 IE使用 ISO-8859-1 编码：new String (fileName.getBytes("UTF-8"), "ISO-8859-1")

package com.servlet;
import java.io.IOException;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
/**
 * @author Xiao_Lin
 * @date 2021/1/21 10:58
 */
@WebServlet(urlPatterns = "/download")
public class DownloadServlet extends HttpServlet {
  @Override
  protected void service(HttpServletRequest req, HttpServletResponse resp)
      throws ServletException, IOException {
    // 获取用户需要下载的文件名称
    String fileName = req.getParameter("fileName");
    // 获取浏览器的类型
    String header = req.getHeader("User-Agent");
    // 如果包含MSIE说明是微软的浏览器（非IE），否则就不是IE
    String name = header.contains("MSIE") ? URLEncoder.encode(fileName, StandardCharsets.UTF_8) :
        new String(fileName.getBytes(StandardCharsets.UTF_8), StandardCharsets.ISO_8859_1);
    // 设置文件的下载名
    resp.setHeader("Content-Disposition","attachment;filename=" + name);
    // 获取文件所在的根路径
    String realPath = req.getServletContext().getRealPath("/WEB-INF/upload/");
    // 使用工具类Files的copy方法获取一个文件输出流，响应给浏览器
    Files.copy(Paths.get(realPath,fileName),resp.getOutputStream());
  }
}

看完再也不担心不会文章的上传与下载（建议收藏）