上传
1、上传对于页面的要求
1、 上传必须用表单,而不能是超链接
2、表单里的 method 必须 POST
3、表单的 enctype 必须指定为 multipart/form-data ,表示多部件表单数据,当表单的enctype不是multipart/form-data时,请求中不包含文件内容,而只有文件的名称,这说明普通文本表单中input:file与input:text没什么区别了。
4、在表单中添加 file 表单字段,即 <input type=“file”>
<body>
<form action="/fileUploadTest1" method="post" enctype="multipart/form-data">
用户名:<input type="text" name="userName" /><br>
文件:<input type="file" name="file"/><br>
<input type="submit" value="提交">
</form>
</body>
2、文件上传对Servlet的要求
当提交的表单是文件上传表单时,那么对Servlet也是有要求的。首先我们要肯定一点,文件上传表单的数据也是被封装到request对象中的。request.getParameter(String)方法获取指定的表单字段字符内容,但文件上传表单已经不在是字符内容,而是字节内容,所以失效。这时可以使用request的getInputStream()方法获取ServletInputStream对象,它是InputStream的子类,这个ServletInputStream对象对应整个表单的正文部分,这说明我们需要的解析流中的数据。当然解析它是很麻烦的一件事情,而Apache已经帮我们提供了解析它的工具:commons-fileupload。
3、为什么使用 fileupload
不能再使用 request.getParameter() 来获取表单数据
可以使用 request.getInputStream() 得到所有的表单数据,而不是一个表单项的数据
这说明不使用fileupload,我们需要自己来对request.getInputStream()的内容进行解析,使用 fileupload 可以方便我们的操作
4、fileupload 简介
fileupload是由apache的commons组件提供的上传组件。它最主要的工作就是帮我们解析request.getInputStream()
需要导入 jar 包:commons-fileupload.jar (核心包),commons-io.jar (依赖包)
fileupload 简单应用
fileupload 的核心类有:DiskFileItemFactory、ServletFileUpLoad、FileItem。
使用 fileupload 组件的步骤如下:
1、创建工厂类 DiskFileItemFactory对象:DiskFileItemFactory factory = new DiskFileItemFactory()
2、使用工厂创建解析对象:ServletFileUpload fileUpload = new ServletFileUpload(factory)
3、使用解析器来解析request对象:List list = fileUpload.parseRequest(request)
FileItem类
一个FileItem对象对应一个表单项(表单字段)。一个表单中存在文件字段和普通字段,可以使用FileItem类的isFormField()方法来判断表单字段是否为普通字段,如果不是普通字段,那么就是文件字段了。
主要方法如下:
String getName():获取文件字段的文件名称;
String getString():获取字段的内容,如果是文件字段,那么获取的是文件内容,当然上传文件必须是文本文件;
String getFieldName():获取字段名称,例如:<input type=”text” name=”username”/>,返回的是username;
String getContentType():获取上传的文件的类型,例如:text/plain
int getSize():获取上传文件的大小;
boolean isFormField():判断当前表单字段是否为普通文本字段,如果返回false,说明是文件字段;
InputStream getInputStream():获取上传文件对应的输入流;
void write(File):把上传的文件保存到指定文件中。
简单的上传案例
第一步,写一个jsp页面,只需要一个表单。
<body>
<form action="/fileUploadTest1" method="post" enctype="multipart/form-data">
用户名:<input type="text" name="userName" /><br>
文件:<input type="file" name="file"/><br>
<input type="submit" value="提交">
</form>
</body>
@WebServlet("/fileUpload")
public class FileUploadTest extends HttpServlet {
protected void doPost(HttpServletRequest request, HttpServletResponse response) {
// 因为要打印,所以设置编码
response.setContentType("text/html;charset=utf-8");
// 创建工厂
DiskFileItemFactory dfif = new DiskFileItemFactory();
// 使用工厂创建解析对象
ServletFileUpload fileUpload = new ServletFileUpload(dfif);
try {
// 使用解析器对象解析request,得到FileItem列表
List<FileItem> list = fileUpload.parseRequest(request);
// 遍历所有表单项
for(FileItem item : list){
// 如果当前表单项为普通表单项
if(item.isFormField()){
String fieldName = item.getFieldName();
if(fieldName.equals("userName")){
response.getWriter().println("用户名:" + item.getString() + "<br/>");
}
} else {
//如果当前表单项不是普通表单项,说明就是文件字段
String name = item.getName();//获取上传文件的名称
// 如果上传的文件名称为空,即没有指定上传文件
if(name == null || name.isEmpty()){
continue;
}
// 获取真实路径,对应${项目目录}/uploads,这个目录必须存在
String realPath = this.getServletContext().getRealPath("/upload");
// 通过uploads目录和文件名称来创建File对象
File file = new File(realPath, name);
// 把上传文件保存到指定位置
item.write(file);
// 打印文件的名称
response.getWriter().println("上传文件名为:" + item.getName() + "<br/>");
// 打印文件的大小
response.getWriter().println("上传文件大小为:" + item.getSize() + "<br/>");
// 打印文件的类型
response.getWriter().println("上传文件的类型是:" + item.getContentType() + "<br/>");
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
上传文件的细节
如果没有把用户上传的文件存放到WEB-INF目录下,那么用户就可以通过浏览器直接访问上传的文件,这是非常危险的。通常我们会在WEB-INF目录下创建一个uploads目录来存放上传的文件,而在Servlet中找到这个目录需要使用ServletContext的getRealPath(String)方法。
对于上传文件同名问题,我们可以使用 UUID 进行解决
限制上传文件的大小,ServletFileUpload类的setFileSizeMax(long)就可以了。参数就是上传文件的上限字节数,例如servletFileUpload.setFileSizeMax(1024*10)表示上限为10KB。
保存在WEB-INF下,并解决文件同名,代码案例
@WebServlet("/fileUploadTest1")
public class FileUploadTest1 extends HttpServlet {
@Override
protected void doPost(HttpServletRequest request, HttpServletResponse response) {
response.setContentType("text/html;charset=utf-8");
DiskFileItemFactory diff = new DiskFileItemFactory();
ServletFileUpload servletFileUpload = new ServletFileUpload(diff);
servletFileUpload.setFileSizeMax(1024*10); //设置文件大小为 10kB
try {
List<FileItem> list = servletFileUpload.parseRequest(request);
FileItem fileItem = list.get(1);
String name = fileItem.getName(); // 获取文件名
String realPath = this.getServletContext().getRealPath("/WEB-INF/uploads");
String filename = UUID.randomUUID().toString() + "_" + name;
File file = new File(realPath, filename);
fileItem.write(file);
response.getWriter().println("文件名:" + fileItem.getName() + "<br>");
response.getWriter().println("大小:" + fileItem.getSize() + "<br>");
response.getWriter().println("类型:" + fileItem.getContentType() + "<br>");
} catch (Exception e) {
e.printStackTrace();
}
}
相对于上传文件来说,下载相对简单
被下载的资源必须放到WEB-INF目录下(只要用户不能通过浏览器直接访问就OK),然后通过Servlet完成下载。
在jsp页面中给出超链接,链接到DownloadServlet,并提供要下载的文件名称。然后DownloadServlet获取文件的真实路径,然后把文件写入到response.getOutputStream()流中。
download.jsp
<body>
<a href="<%=application.getContextPath()%>/download?path=1.jpg">1.jpg</a><br/>
<a href="<%=application.getContextPath()%>/download?path=2.jpg">2.jpg</a><br/>
<a href="<%=application.getContextPath()%>/download?path=3.jpg">3.jpg</a><br/>
</body>
当设置了content-disposition头后,浏览器就会弹出下载框。
而且还可以通过content-disposition头来指定下载文件的名称!
Download
@WebServlet("/download")
public class Download extends HttpServlet {
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType("text/html;charset=utf-8");
String path = request.getParameter("path");
String realPath = request.getServletContext().getRealPath("/WEB-INF/uploads/" + path);
File file = new File(realPath);
if(!file.exists()){
response.getWriter().print("您要下载的文件不存在!!");
return;
}
response.addHeader("content-disposition", "attachment;filename=" + path);
IOUtils.copy(new FileInputStream(file), response.getOutputStream());
解决文件名是中文的问题
String filename = request.getParameter("path");
// GET请求中,参数中包含中文需要自己动手来转换。
// 当然如果你使用了“全局编码过滤器”,那么这里就不用处理了
filename = new String(filename.getBytes("ISO-8859-1"), "UTF-8");
String filepath = this.getServletContext().getRealPath("/WEB-INF/uploads/" + filename);
File file = new File(filepath);
if(!file.exists()) {
response.getWriter().print("您要下载的文件不存在!");
return;
}
// 所有浏览器都会使用本地编码,即中文操作系统使用GBK
// 浏览器收到这个文件名后,会使用iso-8859-1来解码
filename = new String(filename.getBytes("GBK"), "ISO-8859-1");
response.addHeader("content-disposition", "attachment;filename=" + filename);
IOUtils.copy(new FileInputStream(file), response.getOutputStream());