板块一 Servlet编程：第八节 文件上传下载操作 来自【汤米尼克的JavaEE全套教程专栏】

在之前的内容中我们终于结束了Servlet五大对象的学习，我们发现这些对象在操作数据时往往只是简单的参数传递，那我们该如何操作更复杂的资源呢？比如要在后端上传下载一个文件，这一节完善一个Servlet的重要知识，就是文件的上传下载操作

一、文件上传

（1）前端内容

1. 使用表单提交
2. 设置表单的提交类型为POST请求 method="post"
3. 设置表单类型为文件上传表单 enctype="multipart/form-data"
4. 设置文件提交的地址
5. 准备表单元素
   - 普通的表单项 type="text"
   - 文件项 type="file"
6. 设置表单元素的name属性值(表单提交一定要设置表单元素的name属性值,否则后台无法接收数据!)

html code

<form method="post" enctype="multipart/form-data" action="uploadServlet">姓名:<input type="text" name="uname" > <br>文件:<input type="file" name="myfile"> <br><!-- button默认的类型是提交类型 type="submit" --><button>提交</button>
</form>

（2）后端内容

使用注解 @MultipartConfig 将一个Servlet标识为支持文件上传。Servlet将multipart/form-data的
POST 请求封装成一个Part对象,通过Part对象的方法对上传的文件进行操作。

实例，详解见代码注释

package com.TommyNike.servlet;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;
import java.io. IOException;@webServlet("/uploadservlet") //与前端的表单的action一致
@MultipartConfig // 如果是文件上传表单,一定要加这个注解
public class Uploadservlet extends HttpServlet {@override
protected void service(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {request.setCharacterEncoding("UTF-8"); // 设置请求的编码格式// 获取普通表单项 (文本框)String uname= request.getParameter("uname");  //"uname"与文本框的name属性值一致// 通过 getPart(name)方法获取Part对象 (name代表的是页面中file文件域的name属性值)Part part = request.getPart("myfile");// 通过Part对象,获取上传的文件名String fileName = part.getSubmittedFileName();// 获取上传文件需要存放的路径 (得到项目存放的真实路径)String realPath = request.getServletContext().getRealPath("/");// 将文件上传到指定位置part.write(realPath + fileName);}
}

注意：
只要前端表单的属性值为enctype="multipart/form-data"，即表单的类型为文件上传表单，Servlet后端就一定要加注解@MultipartConfig，否则表单的内容无法传递到后端

二、文件下载

文件下载,即将服务器上的资源下载(拷贝)到本地,我们可以通过两种方式下载。第一种是通过超链接本
身的特性来下载;第二种是通过代码下载。

注意：
在Idea中，需要在服务器编辑配置->部署->点击+，把外部资源添加到服务器中，资源才能在浏览器中被访问到

（1）前端的超链接下载

当我们在HTML或JSP页面中使用a标签时,原意是希望能够进行跳转,当遇见浏览器能够直接显示的资源,浏览器就会默认显示出来,比如 txt、png、jpg等。但当超链接遇到浏览器不识别的资源时会自动下载，比如zip压缩包等。当然我们也可以通过download属性规定浏览器进行下载，但有些浏览器并不支持。

默认下载

<!-- 当超链接遇到浏览器不识别的资源时,会自动下载 -- >
<a href="test.zip">超链接下载</a>

指定 download属性下载
download属性可以不写任何信息,会自动使用默认文件名。如果设置了download属性的值,则使用设置的值做为文件名。当用户打开浏览器点击链接的时候就会直接下载文件。

<!-- 当超链接遇到浏览器识别的资源时,默认不会下载。通过download属性可进行下载 -- >
<a href="test.txt" download>超链接下载</a>

（2）后端下载

实现步骤

1. 需要通过 response.setContentType 方法设置Content-type头字段的值为浏览器无法使用某种方式或激活某个程序来处理的MIME类型,也就是让浏览器无法识别它。例如"application/octet-stream"或"application/x-msdownload"等。
2. 设置左下角那个下载框：需要通过响应头 response.setHeader 方法设置Content-Disposition头的值为"attachment;filename=文件名”
3. 读取下载文件,调用输出流response.getOutputStream方法向客户端写入附件内容。

实例，详解见代码注释

package com.TommyNike.servlet;import javax.servlet. ServletException;
import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.FileInputStream;
import java. io. IOException;
import java.io.InputStream;public class Downloadservlet extends HttpServlet {protected void service(HttpServletRequest request, HttpServletResponse response) throws  ServletException, IOException {// 设置两端的编码格式request.setCharacterEncoding("UTF-8");request.setContentType("text/html;charset=UTF-8");// 获取文件下载路径String path = getServletContext().getRealPath("/");//获取要下载的文件名String name = request.getParameter("fileName");if (name == null || "".equals(name .trim())) { //文件名判空response.getWriter().write( s:"请输入要下载的文件名!");response.getWriter().close();return;}//通过路径得到file对象File file = new File(path + name);//判断file对象是否存在,且是否是一个标准文件if (file.exists() && file.isFile()) {// 设置响应类型(浏览器无法使用某种方式或激活某个程序来处理的类型)response.setContentType("application/x-msdownload");// 设置下载文件的名称：nameresponse.setHeader("Content-Disposition", "attachment; filename=" + name);// 得到输入流InputStream is = new FileInputStream(file);// 得到输出流ServletOutputStream os = response.getOutputStream();//定义byte数组byte[] car = new byte[1024];//定义长度int len = 0;// 循环 输出while ((len = is.read(car)) != -1) { // != -1 :不为空os.write(car, 0, len);}// 关闭流 释放资源os.close();is.close();} else {System.out.println("文件不存在,下载失败!");}}
}

以上就是本专栏Servlet板块的全部内容了，欢迎读者在评论区提出意见反馈，博主也很乐于私信交流。下一个板块我们将着重详解Java EE的另一个基石：JSP和JSTL