文件上传的概述(上传不能使用BaseServlet)
1.上传对表单限制
* method="post"
* enctype="multipart/form-data"如果不加这个,它会把体中的中文生成url编码的形式;上传的时候用它
* 表单中需要添加文件表单项:<input type="file" name="xxx" ...>
2.上传对Servlet限制
* request.getParameter("xxx");这个方法在表单为enctype="multipart/form-data"时,它作废了。它永远返回null。
* ServletInputStream request.getInputStream();包含整个请求的体!
---------------------------------------------------------------------
3.多部件表单的体
1.每隔出多个部件,即一个表单项一个部件
2.一个部件中自己包含请求头和空行,以及请求体。
3普通表单项:
> 一个头:Content-Disposition:包含name="xxx",即表单项名称。
> 体就是表单项的值。
4.文件表单项:
> 两个头:
* Content-Disposition:包含name="xxx",即表单项名称;还有一个filename="yyy.jpg",表示上传文件的名称。
* Content-Type:它是上传文件的MIME类型,例如image/pjpeg,表示上传的是图片,图中是jpg扩展名的图片。
> 体就是上传文件的内容。
------WebKitFormBoundary6opWGr8NaACK9My4 Content-Disposition: form-data; name="username" taeyeon ------WebKitFormBoundary6opWGr8NaACK9My4 Content-Disposition: form-data; name="zhaoPian"; filename="lovejrr.jpg" Content-Type: image/jpeg 文件内容
------WebKitFormBoundary6opWGr8NaACK9My4--
4.commons-fileupload
commons-fileupload-1.2.2.jar------这个小组件,它会帮我们解析request中上传的数据,解析后的结果是一个表单项数据封装到一个FileItem对象中。我们只需要调用FileItem的方法即可!
commons-io.jar-----依赖
1)上传三步
相关类:
* 工厂:DiskFileItemFactory
* 解析器:ServletFileUpload
* 表单项:FileItem
a)创建工厂:DiskFileItemFactory factory = new DiskFileItemFactory();
b)创建解析器:ServletFileUpload sfu = new ServletFileUpload(factory);
c)使用解析器来解析request,得到FileItem集合:List<FileItem> fileItemList = sfu.parseRequest(request);
2)FileItem---(一个接口,它有实现类)
* boolean isFormField():是否为普通表单项!返回true为普通表单项,如果返回false即文件表单项!
* String getFieldName():返回表单项的名称;
* String getString(String charset):返回表单项的值;
* String getName():返回上传的文件名称;
* long getSize():返回上传文件的字节数;
* InputStream getInputStream():返回上传文件对应的输入流;
* void write(File destFile):把上传的文件内容保存到指定的文件中。
* String getContentType():返回上传文件的类型。如果是普通表单,返回的是null。
form2.jsp:
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <body> <h1>上传2</h1> <form action='<c:url value="/Upload2Servlet"></c:url>' method="post" enctype="multipart/form-data"> 用户名:<input type="text" name="username"/><br> 照片:<input type="file" name="zhaoPian"><br> <input type="submit" value="上传"> </form> </body>
Upload2Servlet.java:
package day22_1; import java.io.File; import java.io.IOException; 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.FileUploadException; import org.apache.commons.fileupload.disk.DiskFileItemFactory; import org.apache.commons.fileupload.servlet.ServletFileUpload; public class Upload2Servlet extends HttpServlet { public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { /* * 上传三步 * 1.创建工厂 * 2.通过工厂创建解析器 * 3.解析request,得到FileItem集合 * 4.遍历FileItem集合,调用 其API完成文件的保存 */ DiskFileItemFactory factory=new DiskFileItemFactory(); ServletFileUpload sfu=new ServletFileUpload(factory); try { List<FileItem> fileItemList = sfu.parseRequest(request); FileItem fi1=fileItemList.get(0); FileItem fi2=fileItemList.get(1); System.out.println("普通表单项演示:"+fi1.getFieldName()+"="+fi1.getString("UTF-8")); System.out.println("Content-Type:"+fi2.getContentType()); System.out.println("Size:"+fi2.getSize()); System.out.println("filename:"+fi2.getName()); //保存文件 File destFile=new File("F:/jrrlove.jpg"); try { fi2.write(destFile); } catch (Exception e) { throw new RuntimeException(e); } } catch (FileUploadException e) { throw new RuntimeException(e);//异常转换一下 } } }
5.上传的细节
1)文件必须保存到WEB-INF下!
* 目的是不让浏览器直接访问到!
* 把文件保存到WEB-INF目录下!
2)文件名称相关问题
* 有的浏览器上传的文件名是绝对路径,这需要切割!C:filesaibing.jpg
String filename=fi2.getName();//获取文件名(有可能带路径) int index=filename.lastIndexOf("\"); if(index != -1){ filename=filename.substring(index+1); }
* 文件名乱码或者普通表单项乱码:request.setCharacterEncoding("utf-8");因为fileupload内部会调用reque.getCharacterEncoding();//优先级低
fileUpload.setHeaderEncoding(String):这种方式的优先级高于前一种。
上传文件内容中包含中文:
通常我们不关心上传文件的内容,因为是把文件保存到硬盘上!如果在控制台显示上传的文件内容,那么可以使用fileItem.getString("utf-8")来处理编码。
文本文件内容和普通表单项内容使用FileItem类的getString("utf-8")来处理编码。
* 文件同名问题:我们需要为每个文件添加名称前缀,这个前缀要保证不能重复。uuid
> filename = CommonsUtils.uuid() + "_" + filename;
3)目录打散问题
* 不能在一个目录下存放过多文件。
> 首字母打散:使用文件的首字母做为目录名称,例如:abc.txt,那么我们把文件保存到a目录下。如果a目录不存在,那么创建它。
> 时间打散:使用当前日期做为目录。
> 哈希打散:
# 通过文件名称得到int值,即调用hashCode()
# 它int 值转换成16进制0~9,A~F
# 获取16进制的前两位用来生成目录,目录为两层!例如:1B2C3D4E5F,/1/B/保存文件。
jar包:commons-fileupload.jar
commons-io.jar
commons-beanutils.jar
commons-logging.jar
itcast-tools.jar
form3.jsp:
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <body> <h1>上传3</h1> <form action='<c:url value="/Upload3Servlet"></c:url>' method="post" enctype="multipart/form-data"> 用户名:<input type="text" name="username" /><br> 照片:<input type="file" name="zhaoPian"><br> <input type="submit" value="上传"> </form> </body>
Upload3Servlet.java:
package day22_1; import java.io.File; import java.io.IOException; 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.FileUploadException; import org.apache.commons.fileupload.disk.DiskFileItemFactory; import org.apache.commons.fileupload.servlet.ServletFileUpload; import cn.itcast.commons.CommonUtils; public class Upload3Servlet extends HttpServlet { public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { /* * 上传三步 */ //工厂 DiskFileItemFactory factory=new DiskFileItemFactory(); //解析器 ServletFileUpload sfu=new ServletFileUpload(factory); //解析,得到List try { List<FileItem> list = sfu.parseRequest(request); FileItem fi=list.get(1);//获取文件表单项 ////////////////////////////////////// /* * 1.得到文件保存的路径 */ String root = request.getServletContext().getRealPath("/WEB-INF/files"); /* * 2.生成两层目录 * 1)得到文件名称 * 2)得到hashCode * 3)转换成16进制 * 4)获取前两个字符用来生成目录 */ String filename = fi.getName();//获取上传的文件名称 /* * 处理文件名绝对路径问题 */ int index = filename.lastIndexOf("\"); if(index != -1){ filename=filename.substring(index+1); } /* * 给文件名称加uuid前缀,处理文件同名问题---itcast-tools.jar */ String savename=CommonUtils.uuid()+"_"+filename; /* * 1.得到hashCode */ int hCode=filename.hashCode(); String hex = Integer.toHexString(hCode); /* * 2获取hex的前两个字母,与root连接在一起,生成一个完整路径 */ File dirFile=new File(root,hex.charAt(0)+"/"+hex.charAt(1)); /* * 3.创建目录链 */ dirFile.mkdirs(); /* * 4.创建目录文件 */ File destFile=new File(dirFile,savename); /* * 5.保存 */ fi.write(destFile); ////////////////////////////////////// } catch (FileUploadException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (Exception e) { // TODO Auto-generated catch block e.printStackTrace(); } } }
在WEB-INF下建一个files目录,上传的图片都会保存到服务器的这个项目下的这files目录下。
4)上传文件的大小限制
* 单个文件大小限制
> sfu.setFileSizeMax(100*1024):限制单个文件大小为100KB
> 上面的方法调用,必须在解析开始之前调用!
> 如果上传的文件超出限制,在parseRequest()方法执行时,会抛出异常!FileUploadBase.FileSizeLimitExceedeException。
举例:-----单个文件大小限制
sfu.setFileSizeMax(100*1024); catch (FileUploadException e) { if(e instanceof FileUploadBase.FileSizeLimitExceededException){ request.setAttribute("msg", "您上传的文件超出了100KB!"); request.getRequestDispatcher("/form3.jsp").forward(request, response); }
* 整个请求所有数据大小限制
> sfu.setSizeMax(1024*1024);//限制整个表单大小为1M
> 这个方法也必须在parseRequest()方法之前调用!
> 如果上传的文件超出限制,在parseRequest()方法执行时,会抛出异常!FileUploadBase.SizeLimitExceedeException。
5)缓存大小与临时目录
上传的过程:客户端--->服务器内存--->再到硬盘,所以对应特别大的文件需要使用到缓存(一次一次的从内存向硬盘保存数据)。
* 缓存大小:超出多大,才向硬盘上保存!默认为10KB。
* 临时目录:向硬盘的什么目录保存。
设置缓存大小与临时目录:new DiskFileItemFactory(20*1024, new File("F:/temp"))
//工厂-----参数:1缓存大小 2临时目录 DiskFileItemFactory factory=new DiskFileItemFactory(20*1024,new File("F:/f/temp"));
*******上传的文件临时存放到这个目录下,等上传完毕,就会复制到files目录下,然后该临时目录下的文件消失******
6.下载
1)下载就是向客户端响应字节数据!
原来我们响应的都是html的字符数据!
把一个文件变成字节数组,使用response.getOutputStream()来响应给浏览器!!!
2)下载的要求
* 两个头一个流!
> Content-Type:你传递给客户端的文件是什么MIME类型,例如:image/pjpeg
通过文件名称调用ServletContext的getMimeType()方法,得到MIME类型!
> Content-Disposition:它的默认值为inline,表示在浏览器窗口中打开!attachment;filename=xxx
在filename=后面跟随的是显示在下载框中的文件名称!
> 流:要下载的文件数据!
自己new一个输入流即可!
示例:
package com.xjs.web.servlet; import java.io.FileInputStream; import java.io.IOException; import javax.servlet.ServletException; import javax.servlet.ServletOutputStream; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.apache.commons.io.IOUtils; public class Download1Servlet extends HttpServlet { public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { /* * 两个头一个流 * 1.Content-Type * 2.Content-Disposition * 3.流 下载文件的数据 */ String filename="G:/GD.mp3"; //通过ServletContent的getMimeTypeZ()方法得到文件的MIME类型 String contentType = this.getServletContext().getMimeType(filename); String contentDisposition="attachment;filename=jrr.mp3"; FileInputStream in=new FileInputStream(filename); //设置头 response.setHeader("Content-Type", contentType); response.setHeader("Content-Disposition", contentDisposition); //获取绑定响应客户端的流 ServletOutputStream out=response.getOutputStream(); IOUtils.copy(in, out);//把输入流中的数据写入到输出流中。 in.close(); } }
3)下载的细节
1.显示在下载框中的中文名称时,会出现乱码。
*FireFox:Base64编码。
* 其他大部分浏览器:URL编码。
通用方案:filename=new String(filename.getBytes("GBK"), "ISO-8859-1");
// 用来对下载的文件名称进行编码的! public static String filenameEncoding(String filename, HttpServletRequest request) throws IOException { String agent = request.getHeader("User-Agent"); //获取浏览器 if (agent.contains("Firefox")) { BASE64Encoder base64Encoder = new BASE64Encoder(); filename = "=?utf-8?B?" + base64Encoder.encode(filename.getBytes("utf-8")) + "?="; } else if(agent.contains("MSIE")) { filename = URLEncoder.encode(filename, "utf-8"); } else { filename = URLEncoder.encode(filename, "utf-8"); } return filename; }
对中文(不乱吗)名称文件的下载:
package com.xjs.web.servlet; import java.io.FileInputStream; import java.io.IOException; import java.net.URLEncoder; import javax.servlet.ServletException; import javax.servlet.ServletOutputStream; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.apache.commons.io.IOUtils; import sun.misc.BASE64Encoder; public class Download1Servlet extends HttpServlet { public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { /* * 两个头一个流 * 1.Content-Type * 2.Content-Disposition * 3.流 下载文件的数据 */ String filename="G:/金泰妍.mp3"; //为了使下载框中显示中文文件名称不出乱码! // String framename=new String("金泰妍.mp3".getBytes("GBK"),"ISO-8859-1"); String framename=filenameEncoding("金泰妍.mp3", request); //通过ServletContent的getMimeTypeZ()方法得到文件的MIME类型 String contentType = this.getServletContext().getMimeType(filename); String contentDisposition="attachment;filename="+framename; FileInputStream in=new FileInputStream(filename); //设置头 response.setHeader("Content-Type", contentType); response.setHeader("Content-Disposition", contentDisposition); //获取绑定响应客户端的流 ServletOutputStream out=response.getOutputStream(); IOUtils.copy(in, out);//把输入流中的数据写入到输出流中。 in.close(); } // 用来对下载的文件名称进行编码的! public static String filenameEncoding(String filename, HttpServletRequest request) throws IOException { String agent = request.getHeader("User-Agent"); //获取浏览器 if (agent.contains("Firefox")) { BASE64Encoder base64Encoder = new BASE64Encoder(); filename = "=?utf-8?B?" + base64Encoder.encode(filename.getBytes("utf-8")) + "?="; } else if(agent.contains("MSIE")) { filename = URLEncoder.encode(filename, "utf-8"); } else { filename = URLEncoder.encode(filename, "utf-8"); } return filename; } }