day18_文件的上传和下载学习笔记
1、文件上传的原理分析
什么是文件上传?
要将客户端(浏览器)数据存储到服务器端,而不将数据直接存储到数据库中,而是要将数据存储到服务器所在的磁盘
上,这就要使用文件上传。为什么使用文件上传?
通过文件上传,可以将浏览器端的数据直接保存到服务器端。不将数据保存到数据库中,而是保存到服务器磁盘上,这样减少了数据库服务器
的压力,对数据的操作更加灵活。
1.1、文件上传的必要前提
- a、提供form表单,method必须是
post
提交方式。 - b、form表单必须设置为
enctype="multipart/form-data"
。 - c、提供
input type="file"
类的上传输入域。
1.2、enctype属性
作用
:告知服务器请求正文的MIME类型(文件类型)
。(与请求消息头中:Content-Type作用是一致的)可选值
:
application/x-www-form-urlencoded(默认)
请求消息正文:name=tom&photo=a.txt
服务器获取数据:String name = request.getParameter("name");
![](https://s1.ax1x.com/2018/12/11/FY19iT.png)
浏览器效果如下:
![](https://s1.ax1x.com/2018/12/11/FY1iz4.png)
示例代码如下:
![](https://s1.ax1x.com/2018/12/11/FY1CJU.png)
multipart/form-data
请求消息正文:
服务器获取数据:request.getParameter(String) 方法获取指定的表单字段字符内容,但文件上传表单已经不再是字符内容,而是字节内容,所以失效,所以需要字节流的方式。
![](https://s1.ax1x.com/2018/12/11/FY1SoV.png)
浏览器效果如下:
![](https://s1.ax1x.com/2018/12/11/FYlzd0.png)
示例代码如下:
![](https://s1.ax1x.com/2018/12/11/FY1kQJ.png)
文件上传
:解析请求正文
的每部分的内容。
2、借助第三方的上传组件实现文件上传
2.1、fileupload概述
fileupload
是由apache
的commons组件
提供的上传组件。它最主要的工作就是帮我们解析request.getInputStream()
。
使用步骤,导入:commons-fileupload
相关jar包
commons-fileupload.jar,核心包。
commons-io.jar,依赖包。
2.2、fileupload的核心类有
DiskFileItemFactory、ServletFileUpload
、FileItem。
a、解析原理
![](https://s1.ax1x.com/2018/12/11/FY1edx.png)
2.3、fileupload简单应用
使用fileupload组件的步骤如下:
1、创建工厂类DiskFileItemFactory对象
DiskFileItemFactory factory = new DiskFileItemFactory();
2、使用工厂创建解析器对象
ServletFileUpload fileUpload = new ServletFileUpload(factory);
3、使用解析器来解析request对象
List< FileItem > list = fileUpload.parseRequest(request);
FileItem对象对应一个`表单项(表单字段)`。可以是`文件字段`或`普通字段`。
FileItem接口的方法:
boolean isFormField():判断当前表单字段是否为`普通文本字段`,如果返回false,则说明是`文件字段`。
String getFieldName():获取`字段名称`,例如:< input type="text" name="username" />,返回的是username。
String getString():获取`字段的内容`,如果是文件字段,那么获取的是文件内容,当然上传的文件必须是文本文件。
String getName():获取`文件字段的文件名称`(如:a.txt)。
String getContentType():获取上传的`文件的MIME类型`,例如:text/plain、image/pjpeg。
int getSize():获取上传`文件的大小`。
InputStream getInputStream():获取上传文件对应的`输入流`。
void write(File file):把上传的文件`保存`到指定文件中。
void delete();
3、文件上传时要考虑的几个问题(`经验分享`)
a、保证服务器的安全
把保存上传文件的目录放在用户直接访问不到的地方。
![](https://s1.ax1x.com/2018/12/11/FY1PWF.png)
b、避免文件被覆盖
让文件名唯一即可。
![](https://s1.ax1x.com/2018/12/11/FY1Ze1.png)
c、避免同一个文件夹中的文件过多
方案一
:按照日期进行打散存储目录
![](https://s1.ax1x.com/2018/12/11/FY1mo6.png)
方案二
:用文件名的hashCode计算打散的存储目录:二级目录![](https://s1.ax1x.com/2018/12/11/FY1Ay9.png)
d、限制文件的大小:web方式不适合上传大的文件
设置单个文件大小
:
ServletFileUpload.setFileSizeMax(字节);设置总文件大小
:(多文件上传时)
ServletFileUpload.setSizeMax(字节);
e、上传字段用户没有上传的问题
通过判断文件名是否为空
即可。
f、临时文件的问题
DiskFileItemFactory
:作用:产生FileItem对象。
DiskFileItemFactory内部有一个缓存
,缓存大小默认是10Kb
。如果上传的文件超过10Kb,就用磁盘
作为缓存。
存放缓存文件的目录在哪里?答
:默认是系统的临时目录。FileItem.delete();
FileItem.delete(); 如果自己用IO流实现的文件上传,则要在流关闭后,清理临时文件。FileItem.write(File file);
把上传的文件保存到指定文件,该方式会自动删除临时文件,注意:实际操作不能够自动删除临时文件
(即:使用 FileItem自带的方法上传文件)。
完整的示例代码如下:
public class UploadServlet2 extends HttpServlet {
@Override
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// request.setCharacterEncoding("UTF-8"); // 解决服务器接收请求的编码问题,该方式的优先级不高,不好!
// 要执行文件上传的操作
// 首先判断表单是否支持文件上传。即:判断 enctype="multipart/form-data"
boolean isMultipartContent = ServletFileUpload.isMultipartContent(request);
if (!isMultipartContent) {
throw new RuntimeException("your form is not multipart/form-data");
}
// 创建一个DiskFileItemfactory工厂类对象
DiskFileItemFactory factory = new DiskFileItemFactory();
factory.setRepository(new File("e:\\")); // 指定临时文件的存储目录
// 使用工厂创建解析器ServletFileUpload核心对象
ServletFileUpload sfu = new ServletFileUpload(factory);
// 解决上传文件表单项出现乱码问题
sfu.setHeaderEncoding("UTF-8");
// 使用解析器来解析request对象 ,并得到一个表单项的List集合
try {
// 限制上传文件的大小
// sfu.setFileSizeMax(1024 * 1024 * 3); // 表示3M大小的文件
// sfu.setSizeMax(1024 * 1024 * 6); // 多个文件上传时
List<FileItem> fileItems = sfu.parseRequest(request);
// 遍历表单项数据
for (FileItem fileitem : fileItems) {
if (fileitem.isFormField()) {
// 文本表单项,普通文本字段(字符串)
processFormField(fileitem);
} else {
// 文件表单项,文件字段(使用字节流读取)
processUploadField(fileitem);
}
}
} catch (FileUploadBase.FileSizeLimitExceededException e) {
// throw new RuntimeException("文件过大,不能超过3M");
System.out.println("文件过大,不能超过3M"); // 自定义异常
} catch (FileUploadBase.SizeLimitExceededException e) {
System.out.println("总文件大小不能超过6M"); // 自定义异常
} catch (FileUploadException e) {
e.printStackTrace();
}
}
@Override
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
doGet(request, response);
}
// 文本表单项,普通文本字段(字符串)
private void processFormField(FileItem fileitem) {
try {
String fieldname = fileitem.getFieldName(); // 获取字段名
String fieldvalue = fileitem.getString("UTF-8"); // 获取字段值,并解决上传普通文本表单出的乱码问题
// 解决上传普通文本表单项出现的乱码问题
// fieldvalue = new String(fieldvalue.getBytes("iso-8859-1"), "utf-8");
System.out.println(fieldname + "=" + fieldvalue);
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
}
// 文件表单项,文件字段(使用字节流读取)
private void processUploadField(FileItem fileitem) {
try {
// 得到文件输入流
InputStream is = fileitem.getInputStream();
// 创建一个文件存盘的目录
String directoryRealPath = this.getServletContext().getRealPath("/WEB-INF/upload");
File storeDirectory = new File(directoryRealPath); // 既代表文件又代表目录
if (!storeDirectory.exists()) {
storeDirectory.mkdirs(); // 就创建一个指定的目录
}
// 获取文件字段的文件名称
String filename = fileitem.getName(); // 文件项框中的值 F:\图片素材\小清新\43.jpg 或者 43.jpg
// 处理文件名问题 F:\apache-tomcat-7.0.52\webapps\day18_00_upload\ upload\F:\图片素材\小清新\43.jpg
if (filename != null) {
// filename = filename.substring(filename.lastIndexOf(File.separator) + 1);
filename = FilenameUtils.getName(filename); // 效果同上
}
// 解决文件同名的问题
filename = UUID.randomUUID() + "_" + filename;
// 法一:按日期打散(创建)目录
// String childDirectory = makeChildDirectory(storeDirectory); // 2015-10-19
// 法二:用文件名的hashCode计算打散的存储目录:即二级目录
String childDirectory = makeChildDirectory(storeDirectory, filename); // a/b
// 在storeDirectory目录下,创建完整目录下的文件
File file = new File(storeDirectory, childDirectory + File.separator + filename); // 绝对目录/日期目录/文件名
// 通过文件输出流将上传的文件保存到服务器的磁盘
FileOutputStream fos = new FileOutputStream(file);
int len = 0;
byte[] b = new byte[1024];
while ((len = is.read(b)) != -1) {
fos.write(b, 0, len);
}
fos.close();
is.close();
fileitem.delete(); // 如果自己用IO流实现的文件上传,则要在流关闭后,清除临时文件
// 把上传的文件保存到指定文件(使用 FileItem自带的方法上传文件)
// fileitem.write(new File(storeDirectory, childDirectory + File.separator + filename));
// fileitem.delete();
} catch (IOException e) {
e.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
}
}
// 用文件名的hashCode计算打散的存储目录:二级目录
private String makeChildDirectory(File storeDirectory, String filename) {
int hashcode = filename.hashCode(); // 返回字符串转换的32位hashcode码
System.out.println(hashcode);
String code = Integer.toHexString(hashcode); // 把hashcode码转换为16进制的字符
System.out.println(code); // 例如:abdsaf2131safsd
String childDirectory = code.charAt(0) + File.separator + code.charAt(1); // 取前两位,作为二级目录,例如:a/b
// 创建指定目录
File file = new File(storeDirectory, childDirectory);
if (!file.exists()) {
file.mkdirs();
}
return childDirectory;
}
/*
// 按日期打散目录
private String makeChildDirectory(File storeDirectory) {
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
String dateDirectory = sdf.format(new Date());
// 创建指定目录
File file = new File(storeDirectory, dateDirectory);
if (!file.exists()) {
file.mkdirs();
}
return dateDirectory;
}*/
}
一次上传一个文件的form表单代码upload.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<form enctype="multipart/form-data"
action="${pageContext.request.contextPath }/servlet/uploadServlet2"
method="post">
<input type="text" name="name" /><br />
<input type="file" name="photo" /><br />
<input type="submit" value="上传" /><br />
</form>
</body>
</html>
浏览器效果如下:
![](https://s1.ax1x.com/2018/12/11/FY1ELR.png)
一次上传两个文件的form表单代码
upload2.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<form enctype="multipart/form-data"
action="${pageContext.request.contextPath }/servlet/uploadServlet2"
method="post">
<input type="text" name="name" /><br />
<input type="file" name="photo" /><br />
<input type="file" name="photo" /><br />
<input type="submit" value="上传" /><br />
</form>
</body>
</html>
浏览器效果如下:
![](https://s1.ax1x.com/2018/12/11/FY1uFK.png)
动态添加上传按钮上传多个文件
upload3.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<script type="text/javascript">
function addFile() {
// 得到div容器
var div1 = document.getElementById("div1");
div1.innerHTML += "<div><input type='file' name='photo'/><input type='button' value='删除' onclick='delFile(this)'/></div>";
}
function delFile(input) {
// 使用input对象的爷爷删除他的爸爸
input.parentNode.parentNode.removeChild(input.parentNode);
}
</script>
<body>
<form enctype="multipart/form-data"
action="${pageContext.request.contextPath }/servlet/uploadServlet2"
method="post">
<input type="text" name="name" /><br />
<div id="div1">
<div>
<input type="file" name="photo"/>
<input type="button" value="添加" onclick="addFile()"/><br />
</div>
</div>
<input type="submit" value="上传" /><br />
</form>
</body>
</html>
浏览器效果如下:
![](https://s1.ax1x.com/2018/12/11/FY1KJO.png)
4、文件的下载
注意
:在web开发中,不适合大的数据下载,通过浏览器进行大的数据下载,不合适,此时需要借助下载软件进行下载,比如:迅雷、电驴、百度网盘等等。
web开发中,文件下载的应用场景
是:从数据库表里面查找数据,动态的生成所需的文件。
文件下载的示例代码如下:
public class DownloadServlet extends HttpServlet {
@Override
public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 设置一个要下载的文件
String filename = "销售榜单.csv"; // csv文件可以用excle打开
// 设置文件名的编码
if (request.getHeader("user-agent").toLowerCase().contains("msie")) {
filename = URLEncoder.encode(filename, "UTF-8"); // 将不安全的文件名改为UTF-8格式
} else {
filename = new String(filename.getBytes("UTF-8"), "iso-8859-1"); // 火狐浏览器
}
// 告知浏览器要下载的文件
response.setHeader("content-disposition", "attachment;filename=" + filename);
// response.setHeader("content-type", "image/jpeg");
response.setContentType(this.getServletContext().getMimeType(filename)); // 告知浏览器根据文件名的后缀自动获得文件类型
response.setCharacterEncoding("UTF-8"); // 设置服务器使用什么编码,去向外输出下面文件输出流的内容
// 创建一个文件输出流
PrintWriter out = response.getWriter();
out.write("电视机, 20\n"); // 以后连接数据库即可
out.write("洗衣机, 10\n");
out.write("冰箱, 8\n");
}
@Override
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
doGet(request, response);
}
}
重构添加图书信息的示例代码:
public class AddBookServlet extends HttpServlet {
@Override
public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 创建一个DiskFileItemFactory工厂
DiskFileItemFactory factory = new DiskFileItemFactory();
// 创建一个ServletFileUpload对象
ServletFileUpload sfu = new ServletFileUpload(factory);
// 解决上传文件的乱码
sfu.setHeaderEncoding("UTF-8");
// 解析request对象,返回所有表单项
List<FileItem> fileItems = new ArrayList<FileItem>(0);
// 用于封装普通表单项的数据
Map<String, String[]> map = new HashMap<String, String[]>();
try {
fileItems = sfu.parseRequest(request);
// 迭代遍历fileItems表单项
for (FileItem fileItem : fileItems) {
if (fileItem.isFormField()) {
// 普通表单项
String name = fileItem.getFieldName(); // 得到字段名
String value = fileItem.getString("UTF-8"); // 得到字段值
map.put(name, new String[] { value }); // 向map中赋值
} else {
// 文件表单项
InputStream inputStream = fileItem.getInputStream();
String filename = fileItem.getName(); // 得到上传的文件名
String extension = FilenameUtils.getExtension(filename);
if (!("jsp".equals(extension) || "exe".equals(extension))) { // 上传的文件不能是jsp、exe
// 创建一个文件存盘的目录
File storeDirectory = new File(this.getServletContext().getRealPath("/upload"));
if (!storeDirectory.exists()) {
storeDirectory.mkdirs(); // 如果该目录不存在,就创建
}
// 处理文件名问题
if (filename != null) {
filename = FilenameUtils.getName(filename);
}
// 目录打散
String childDirectory = makeChildDirectory(storeDirectory, filename); // a/b
// 把上传的文件保存到指定文件(使用 FileItem自带的方法上传文件)
filename = childDirectory + File.separator + filename;
fileItem.write(new File(storeDirectory, filename));
fileItem.delete(); // 删除临时文件
}
map.put(fileItem.getFieldName(), new String[] { filename }); // 将图片表单项的name和value保存到map中
}
}
Book book = new Book();
BeanUtils.populate(book, map);
book.setId(UUIDUtil.getUUID()); // 设置图书编号
// 调用业务逻辑
BookServiceImpl bs = new BookServiceImpl();
bs.addBook(book);
// 分发转向
// 不写/代表相对路径,相对于本类的路径
request.getRequestDispatcher("bookListServlet").forward(request, response);
} catch (FileUploadException e) {
e.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
}
}
// request.setCharacterEncoding("UTF-8"); // 获取表单数据
// Book book = new Book();
// try {
// BeanUtils.populate(book, request.getParameterMap());
// book.setId(UUIDUtil.getUUID()); // 手动生成一个随机ID
// } catch (Exception e) {
// e.printStackTrace();
// }
//
// // 调用业务逻辑
// BookServiceImpl bs = newBookServiceImpl();
// bs.addBook(book);
//
// // 分发转向
// // 不写/代表相对路径,相对于本类的路径
// request.getRequestDispatcher("bookListServlet").forward(request, response);
@Override
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
doGet(request, response);
}
// 目录打散
private String makeChildDirectory(File storeDirectory, String filename) {
int hashcode = filename.hashCode(); // 返回字符转换的32位hashcode码
System.out.println(hashcode);
String code = Integer.toHexString(hashcode); // 把hashcode转换为16进制的字符
System.out.println(code); // abdsaf2131safsd
String childDirectory = code.charAt(0) + File.separator + code.charAt(1); // a/b
// 创建指定目录
File file = new File(storeDirectory, childDirectory);
if (!file.exists()) {
file.mkdirs();
}
return childDirectory;
}
}
product_list.jsp
<div class="divbookpic">
<p>
<a href="#"><img src="${pageContext.request.contextPath}/upload/${b.img_url}" width="115" height="129" border="0" /> </a>
</p>
</div>
【转载文章务必保留出处和署名,谢谢!】