文章目录
- 文件的上传
- 基本介绍
- 文件上传的HTTP协议的说明
- commons-fileupload.jar 常用API介绍说明
- fileupload类库的使用
- 文件的下载
- 基本介绍和使用说明
- 中文名乱码问题解决方案
文件的上传和下载,是非常常见的功能。很多的系统中,或者软件中都经常使用文件的上传和下载。
比如:QQ 头像,就使用了上传。 邮箱中也有附件的上传和下载功能。 OA 系统中审批有附件材料的上传
文件的上传
基本介绍
:::tips
基本操作:
- 要有一个form标签,method=post请求
- form标签的encType属性值必须为multipart/form-data值
- 在form标签中使用 input type=file 添加上传的文件
- 编写服务器代码(Servlet程序)接受,处理上传的数据
提示:encType=multipart/form-data表示提交的数据,以多段(每一个表单项一个数据段)的形式进行拼接,然后以二进制流的形式发送给服务器
:::
文件上传的HTTP协议的说明
- 下面上传的文件的数据其实是没有显示出来,是存在的,只是浏览器认为你的数据很多,然后认为显示出来不好看,于是就没有显示出来,在IDEA的界面上是可以显示出来的
注意:客户端以流的形式来接受
commons-fileupload.jar 常用API介绍说明
- 对于文件上传的方式,有很多第三方类已经很好的完成了
- 这里我们使用comms-fileupload-jar包,而由于这个jar包依赖commons-io.jar包,所以我们需要引入两个包
ServletFileUpload类 | 用于解析上传的数据 |
---|---|
FileItem类 | 表示每一个表单项 |
boolean ServletFileUpload.isMultipartContent(HttpServletRequest request) | 判断当前上传的数据格式是否是多段的格式 |
public List parseRequest(HttpServletRequest request) | 解析上传的数据 |
boolean FileItem.isFormField() | 判断当前这个表单项,是否是普通的表单项,还是上传的文件类型。true表示普通类型的表单项,false表示上传的文件类型 |
String FileItem.getFieldName() | 获取表单项的name属性值(普通类型) |
String FileItem.getString() | 获取当前表单项的值(普通类型) |
String FileItem.getName() | 获取上传的文件名(文件类型) |
String FileItem.write(file) | 将上传的文件写到参数file所指向的磁盘目录(文件类型) |
fileupload类库的使用
- 上传文件的表单:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<form action="http://localhost:8080/09_EL_JSTL/uploadServlet" method="post" enctype="multipart/form-data">
用户名:<input type="text" name="username"> <br/>
头像:<input type="file" name="photo"> <br/>
<input type="submit" value="上传">
</form>
</body>
</html>
- 解析上传的数据的代码:
package com.zan.servlet;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileItemFactory;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import javax.servlet.ServletException;
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 {
/**
*
* @param req
* @param resp
* @throws ServletException
* @throws IOException
*/
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
//1. 先判断上传的数据是否是多段数据(只有是多段的数据,才是文件上传的)
if (ServletFileUpload.isMultipartContent(req)) {
//创建FileItemFactory工厂实现类
FileItemFactory fileItemFactory = new DiskFileItemFactory();
//上传用于解析上传数据的工具类ServletFileUpload类
ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
//解析上传的数据,得到每一个表单项
try {
List<FileItem> list = servletFileUpload.parseRequest(req);
//循环判断每一个表单项,是普通类型还是上传的文件
for (FileItem fileItem : list) {
if (fileItem.isFormField()) {
//普通表单项
System.out.println("表单项的name属性值:" + fileItem.getFieldName());
//参数 UTF-8解决乱码问题
System.out.println("表单项的value属性值:" + fileItem.getString("UTF-8"));
} else {
//上传的文件
System.out.println("表单项的name属性值:" + fileItem.getFieldName());
System.out.println("上传的文件名:" + fileItem.getName());
//将文件写入磁盘位置
fileItem.write(new File("e:\\" + fileItem.getName()));
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
}
文件的下载
基本介绍和使用说明
:::tips
下载的常用API说明:
**response.getOutputStream();//**获取响应的输出流
servletContext.getResourceAsStream();
**servletContext.getMimeType();//**获取要下载的文件类型
**response.setContentType();//**通过响应头告诉客户端返回的数据类型
:::
:::tips
response.setHeader(“Content-Disposition”, “attachment; fileName=1.jpg”);
这个响应头告诉浏览器,这是需要下载的,而attachment表示附件,也就是下载的一个文件,fileName=后面表示下载的文件名
:::
package com.zan.servlet;
import org.apache.commons.io.IOUtils;
import sun.misc.BASE64Encoder;
import javax.servlet.ServletContext;
import javax.servlet.ServletException;
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.net.URLEncoder;
public class Download extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
//1. 获取要下载的文件名
String downloadFileName = "0.jpg";//固定一下
//2. 读取要下载的文件内容(通过ServletContext对象可以读取)
ServletContext servletContext = getServletContext();
//获取要下载的文件类型
String mimeType = servletContext.getMimeType("/file/" + downloadFileName);
// System.out.println(mimeType);
//4. 在回传前,通过响应头告诉客户端返回的数据类型
resp.setContentType(mimeType);
//5. 还要告诉客户端收到的数据是用于下载使用(还是使用响应头来告诉)
//Content-Disposition 响应头,表示收到的数据怎么处理
//attachment 表示附件,表示下载使用
//filename= 表示指定下载的文件名
//url 编码是把汉字转换成为%xx%xx的格式,xx就是十六进制
if (req.getHeader("User-Agent").contains("Firefox")) {
//如果是火狐浏览器使用Base64编码
resp.setHeader("Content-Disposition", "attachment; filename==?charset?B?" + new BASE64Encoder().encode("中国.jpg".getBytes()) + "?=");
} else {
//如果不是火狐,是IE或谷歌,使用URL编码操作
resp.setHeader("Content-Disposition", "attachment; filename=" + URLEncoder.encode("中国.jpg", "UTF-8"));
}
/**
* 斜杠 / 被服务器解析表示地址为http://ip:port/工程名/ 映射到代码的web目录
*/
InputStream resourceAsStream = servletContext.getResourceAsStream("/file/" + downloadFileName);
//获取响应的输出流
OutputStream outputStream = resp.getOutputStream();
//3. 把下载的文件内容回传给客户端
//读取输入,将输入流的内容复制给输出流,输出给客户端
IOUtils.copy(resourceAsStream, outputStream);
}
}
中文名乱码问题解决方案
- URLEncoder解决IE和谷歌浏览器的附件中文名问题
:::tips
如果客户端浏览器是 IE 浏览器 或者 是谷歌浏览器。我们需要使用 URLEncoder 类先对中文名进行 UTF-8 的编码操作
因为 IE 浏览器和谷歌浏览器收到含有编码后的字符串后会以 UTF-8 字符集进行解码显示
:::
// 把中文名进行 UTF-8 编码操作。
String str = "attachment; fileName=" + URLEncoder.encode("中文.jpg", "UTF-8");
// 然后把编码后的字符串设置到响应头中
response.setHeader("Content-Disposition", str);
- BASE64编解码解决火狐浏览器的附件中文名问题
:::tips
如果客户端浏览器是火狐浏览器。 那么我们需要对中文名进行 BASE64 的编码操作。
这时候需要把请求头 Content-Disposition: attachment; filename=中文名
编码成为:Content-Disposition: attachment; filename==?charset?B?xxxxx?=
:::
| **=? ** | **表示编码内容的开始 ** |
| — | — |
| **charset ** | **表示字符集 ** |
| **B ** | 表示 BASE64 编码 |
| xxxx | ** 表示文件名 BASE64 编码后的内容 ** |
| **?= ** | 表示编码内容的结束 |