文件上传概述
文件上传实际上就是Browser (浏览器)跟 Server(服务器)的数据互动
上传:我们把需要上传的资源,发送给服务器,在服务器上保存下来。在智联招聘上填写一个完整的简历还需要上传照片呢。
下载:下载某一个资源时,将服务器上的该资源发送给浏览器。例如网络硬盘!就是用来上传下载文件的。
服务器端获取资源
浏览器在上传的过程中是将文件以流的形式提交到服务器端的,如果直接使用Servlet获取上传文件的输入流然后再解析里面的请求参数是比较麻烦,所以一般选择采用apache的开源工具common-fileupload
这个文件上传组件。common-fileupload
是依赖于common-io
这个包的,所以还需要下载这个包。
fileupload概述
fileupload是由apache的commons组件提供的上传组件。它最主要的工作就是帮我们解析request.getInputStream()
fileupload组件需要的JAR包有:
commons-fileupload.jar,核心包
commons-io.jar,依赖包
fileupload的核心类有:DiskFileItemFactory、ServletFileUpload、FileItem
使用fileupload组件的步骤如下:
//1.创建工厂类DiskFileItemFactory对象
DiskFileItemFactory factory = new DiskFileItemFactory();
//2.使用工厂创建解析器对象
ServletFileUpload fileUpload = new ServletFileUpload(factory);
//3.使用解析器来解析request对象
List<FileItem> list = fileUpload.parseRequest(request);
DiskFileItemFactory 磁盘文件项工厂类
public DiskFileItemFactory(int sizeThreshold, File repository)
构造工厂时,指定内存缓冲区大小和临时文件存放位置
public void setSizeThreshold(int sizeThreshold)
设置内存缓冲区大小,默认10K
public void setRepository(File repository)
设置临时文件存放位置,默认System.getProperty(“java.io.tmpdir”).
内存缓冲区: 上传文件时,上传文件的内容优先保存在内存缓冲区中,当上传文件大小超过缓冲区大小,就会在服务器端产生临时文件
临时文件存放位置: 保存超过了内存缓冲区大小上传文件而产生临时文件 ,产生临时文件可以通过 FileItem的delete()方法删除
FileItem
表示文件上传表单中 每个数据部分
隆重介绍FileItem类,它才是我们最终要的结果。一个FileItem对象对应一个表单项(表单字段)。一个表单中存在文件字段和普通字段,可以使用FileItem类的isFormField()方法来判断表单字段是否为普通字段,如果不是普通字段,那么就是文件字段了
注意事项:因为文件上传表单采用编码方式multipart/form-data 与传统url编码不同,所有getParameter ()方法不能使用 setCharacterEncoding()无法解决输入项乱码问题
ServletFileUpload 文件上传核心类
开发环境搭建
配置Tomcat以及下载jar包
common-io以及common-fileupload包
Maven Repository: commons-fileupload » commons-fileupload (mvnrepository.com)
Maven Repository: commons-io » commons-io (mvnrepository.com)
【注意】:使用IDEA导包需要注意修复路径,将lib添加到项目输出目录
实现文件上传
浏览器端
前端页面:
文件上传页面upload.jsp
<%@ page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head>
<title>文件上传</title>
</head>
<body>
<form action="${pageContext.request.contextPath}/servlet/UploadHandleServlet" enctype="multipart/form-data" method="post">
上传用户:<input type="text" name="username"><br/>
上传文件1:<input type="file" name="file1"><br/>
上传文件2:<input type="file" name="file2"><br/>
<input type="submit" value="提交">
</form>
</body>
</html>
-
HTML中用来跟文件系统进行交互的手段只有一个 :input type=file
-
必须指定 enctype 为 multipart/form-date ,这样数据才会被正确分段处理并上传
- enctype 表示数据的传输格式
- multpart/form-date ,表示数据将会被分段处理之后再发送 -
多文件上传
- 要使用multiple属性
- 后台接受是一个数组
-
后台要用文件类型接收文件,不能用字符串接收,负责会报错;
-
后台可用 String path=request.getRealPath("/"); 方法获取项目的路径,把文件放到相应的路径中。
消息提示页面message.jsp
<%@ page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head>
<title>消息提示</title>
</head>
<body>
${message}
</body>
</html>
服务器端
处理文件上传的Servlet
当提交的表单是文件上传表单时,那么对Servlet也是有要求的。
首先我们要肯定一点,文件上传表单的数据也是被封装到request对象中的。
request.getParameter(String)方法获取指定的表单字段字符内容,但文件上传表单已经不在是字符内容,而是字节内容,所以失效。
这时可以使用request的getInputStream()方法获取ServletInputStream对象,它是InputStream的子类,这个ServletInputStream对象对应整个表单的正文部分(从第一个分隔线开始,到最后),这说明我们需要的解析流中的数据。当然解析它是很麻烦的一件事情,而Apache已经帮我们提供了解析它的工具:commons-fileupload
package me.gacl.web.controller;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
public class UploadHandleServlet extends HttpServlet {
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
//得到上传文件的保存目录,将上传的文件存放于WEB-INF目录下,不允许外界直接访问,保证上传文件的安全
String savePath = this.getServletContext().getRealPath("/WEB-INF/upload");
File file = new File(savePath);
//判断上传文件的保存目录是否存在
if (!file.exists() && !file.isDirectory()) {
System.out.println(savePath+"目录不存在,需要创建");
//创建目录
file.mkdir();
}
//消息提示
String message = "";
try{
//使用Apache文件上传组件处理文件上传步骤:
//1、创建一个DiskFileItemFactory工厂