1、概述
文件的上传和下载是非常常见的功能,很多的系统中,或者软件中都经常使用文件的上传和下载。
比如:QQ 头像,就使用了上传。
邮箱中也有附件的上传和下载功能。
OA 系统中审批有附件材料的上传。
2、文件的上传介绍
上传步骤
① 要有一个form 标签,method=post 请求
② form 标签的encType 属性值必须为multipart/form-data 值
③ 在form 标签中使用input type=file 添加上传的文件
④ 编写服务器代码(Servlet 程序)接收,处理上传的数据。
encType=multipart/form-data 表示提交的数据,以多段(每一个表单项一个数据段)的形式进行拼接,然后以二进制流的形式发送给服务器
2.1 代码演示,客户端(前端)
<body>
<form action="http://192.168.31.74:8080/09_EL_JSTL/uploadServlet" method="post" enctype="multipart/form-date">
用户名:<input type=""text" name="username"/>
头像:<input type="file" name="username"/>
<input type=""submit" value="上传">
</form>
</body>
扩展:文件上传的HTTP协议说明 点击上传后,浏览器F12进入调试页面,点击Network,看请求头和请求体
2.2 文件上传API commons-fileupload.jar 常用API 介绍说明
commons-fileupload.jar 需要依赖commons-io.jar 这个包,所以两个包我们都要引入。
(1)导入两个jar 包:
commons-fileupload-1.2.1.jar
commons-io-1.4.jar
(2)该组件的常用类和方法介绍
① ServletFileUpload 类,用于解析上传的数据。
② FileItem 类,表示每一个表单项。
③ boolean ServletFileUpload.isMultipartContent(HttpServletRequest request);
判断当前上传的数据格式是否是多段的格式。
④ public List<FileItem> parseRequest(HttpServletRequest request)
解析上传的数据(即 得到多个表单项,即分别得到里面的input标签对应的流,我们只管找文件的)
⑤ boolean FileItem.isFormField()
判断当前这个表单项,是否是普通的表单项。还是上传的文件类型。
true 表示普通类型的表单项
false 表示上传的文件类型
⑥ String FileItem.getFieldName()
获取表单项的name 属性值
⑦ String FileItem.getString()
获取当前表单项的值。
⑧ String FileItem.getName();
获取上传的文件名
⑨ void FileItem.write( file );
将上传的文件写到参数file 所指向抽硬盘位置。
(3)服务端代码
思路:重点就是要造一个 ServletFileUpload 类的对象,但是这个 ServletFileUpload 构造器又需要另一个实现FileItemFactory接口的对象
public class Upload extends HttpServlet{
@Override
protected void doPost(HttpServletRequest req,HttpServletResponse resp) throws ServletException,IOException{
//1、先判断上传的数据是否是多段数据(只有多段数据,才是文件上传的)
if(ServletFileUpload.isMultipartContent(req)){
//创建FileItemFactory工厂实现类(ServletFileUpload构造器需要)
FileItemFactory fileItemFactory = new DiskFileItemFactory();
//创建用于解析上传数据的工具类ServletFileUpload类对象
ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
try{
//解析上传的数据,得到每一个表单项FileItem
List<FileItem> list = servletFileUpload.parseRequest(req);
//循环判断,每一个表单项,是普通类型,还是上传文件
for(FileItem fileItem:list){ //把每一次遍历到的list集合中的FileItem对象给 fileItem变量
if(fileItem.isFormField()){
//如果是普通表单项
System.out.println("表单项的name属性值:"+ fileItem.getFiledName());
//参数UTF-8解决乱码问题
System.out.println("表单项的value属性值"+ fileItem.getString("UTF-8"));
} else {
//上传的文件
System.out.println("表单项的name属性值:"+ fileItem.getFiledName());
System.out.println("上传的文件名:"+ fileItem.getdName());
//将上传的文件放到E盘根目录
fileItem.write(new File("e:\\" + fileItem.getName()));
}
}
} catch(Exception e) {
e.printStackTrace();
}
}
}
}
web.xml配置
<servlet>
<servlet-name>UploadServlet</servlet-name>
<servlet-class>com.atguigu.servlet.UploadServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>UploadServlet</servlet-name>
<url-pattern>/uploadServlet</url-pattern>
</servlet-mapping>
3、文件的下载
文件下载,服务器需要向客户端提供
① 要下载的文件内容
② 通过响应头告诉客户端返回的数据类型(文件or图片or视频 主要是请求头要使用)
③ 通过响应头告诉客户端该数据用于下载(否则客户端会直接显示到页面上)
④ 把下载的文件内容传给客户端
public class Download extends HttpServlet{
@Override
protected void doGet(HttpServletRequest req,HttpServletResponse resp) throws ServletException,IOException{
//1、获取要下载的文件名
String downloadFileName="2.jpg";
//2、读取要下载的文件内容并转换成流(需要上下文对象的getResourceAsStream)
ServletContext servletContext=getServletContext();//拿到唯一的上下文对象
//获取要下载的文件类型
String mimeType = servletContext.getMimeType("/file/"+downloadFileName);
//通过响应头,将获取的文件类型告诉客户端
resp.setContentType(mimeType);
//告诉客户端数据用于下载,不是显示(还是通过响应头)
//Content-Disposition表示收到的数据准备做什么处理
//attachment表示作为附件处理(即下载)
//filename=表示指定下载的文件名
resp.setHeader("Content-Disposition","attachment;filename="+downloadFileName);
InputStream resourceAsStream = servletContext.getResourceAsStream("/file/"+downloadFileName);
//获取响应输出流
OutputStream outputStream = resp.getOutputStream();
//读取输入流中的的全部数据,复制给输出流,输出客户端
IOUtils.copy(resourceAsStream,outputStream);
}
}
response.setHeader("Content-Disposition", "attachment; fileName=1.jpg");
这个响应头告诉浏览器。这是需要下载的。而attachment 表示附件,也就是下载的一个文件。fileName=后面,表示下载的文件名。
完成上面的两个步骤,下载文件是没问题了。但是如果我们要下载的文件是中文名(比如图片名叫做中文.jpg)的话。你会发现,下载无法正确显示出正确的中文名。
原因是在响应头中,不能包含有中文字符,只能包含ASCII 码。
解决办法:
如果客户端浏览器是IE 浏览器或者是谷歌浏览器。我们需要使用URLEncoder 类先对中文名进行UTF-8 的编码操作。
因为IE 浏览器和谷歌浏览器收到含有编码后的字符串后会以UTF-8 字符集进行解码显示。
// 把中文名进行UTF-8 编码操作。
String str = "attachment; fileName=" + URLEncoder.encode("中文.jpg", "UTF-8");
// 然后把编码后的字符串设置到响应头中
response.setHeader("Content-Disposition", str);