1、准备工作
- 对于文件上传,浏览器在上传的过程中是将文件以流的形式提交到服务器端的。
- 一般采用Apache的开源工具common-fileupload这个文件上传组件。
- common-fileupload是依赖于common-io这个包的,所以还需要下载这个包。
我们下载最新的jar包:
- common-fileupload :https://mvnrepository.com/artifact/commons-fileupload/commons-fileupload/1.4
- common-io :https://mvnrepository.com/artifact/org.apache.commons/commons-io/1.3.2
在JavaWeb项目中导入Jar包:
上传文件流程:
2、使用类介绍
文件上传注意事项
- 为保证服务器的安全,上传的文件应放在外界无法访问的目录下,如WEN-INF。
- 为防止同名文件产生覆盖现象,要为文件指定一个唯一的文件名。增加时间戳 -uuid -MD5 --位运算算法
- 要对上传文件的大小进行限制。
- 可以限制上传文件的类型,收到文件时,判断文件名后缀是否合法。
需要用到的类详解
ServletFileUpload负责处理上传的文件数据,并将表单中的每个输入项封装成一个FileItem对象,在使用ServletFileUpload对象解析请求时需要DiskFileItemFactory对象。
所以,我们需要在进行解析工作前构造好DiskFileItemFactory对象,通过ServletFileItem对象的构造方法或setFileItemFactory()设置ServletFileUpload对象的fileItemFactory属性。
FileItem类
在HTML页面中必须要有name:<p><input type="file" name="filename"></p>
<form action="" method="post"><p><input type="file" name="file1"></p><p><input type="file" name="file1"></p><p><input type="submit"> | <input type="reset"></p> </form>
表单中如果包含一个文件上传项的话,这个表单的entype属性必须设置为multipart/form-data
/*通过表单上传文件get:上传文件大小有限制post:上传文件大小没有限制 */ <form action="" enctype="multipart/form-data" method="post">上传用户:<input type="text" name="username"><br/><p><input type="file" name="file1"></p><p><input type="file" name="file1"></p><p><input type="submit"> | <input type="reset"></p> </form>
浏览器的表单类型为multipart/form-data的话,服务器想获取数据就要通过流
【常用方法介绍】
//isFormFile方法用于判断FileItem类对象封装的数据是一个普通文本表单//还是一个文件表单,如果时普通表单字段则返回true,否则返回false booleanisField();//getFieldName方法用于返回表单标签name属性的值 String getFieldName();//getString方法用于将FileItem对象中保存的数据流内容以一个字符串返回 String getString();//getName方法用于获得文件上传字段中的文件名。 String getName();//以流的形式返回上传文件的数据内容。 InputStream getInputStream();//delete方法用来清空FileItem类对象中存放的主体内容//如果主体内容被保存在临时文件中,delete方法将删除该临时文件void delete();
ServletFileUpload类:
ServletFileUpload负责处理上传的文件数据,并将表单中的每个输入项封装成一个FileItem对象中,使用其parseRequest(HttpServletRequest)方法可以将通过表单中每一个HTML标签提交的数据封装成一个FileItem对象,然后以List列表的形式返回。使用该方法处理上传文件简单易用。
3、代码编写
package com.hwt.servlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.*; import java.util.List; import java.util.UUID; import org.apache.commons.fileupload.FileItem; import org.apache.commons.fileupload.FileUploadException; import org.apache.commons.fileupload.ProgressListener; import org.apache.commons.fileupload.disk.DiskFileItemFactory; import org.apache.commons.fileupload.servlet.ServletFileUpload; public class FileServlet extends HttpServlet {//private File file;protected void doPost(HttpServletRequest request, HttpServletResponse response) throws javax.servlet.ServletException, IOException {//判断上传的表单是普通表单还是带文件的表单,是返回true,否返回false;if (!ServletFileUpload.isMultipartContent(request)){return;//如果这是一个普通文件我们直接返回}//如果通过了这个if,说明我们的表单是带文件上传的//创建上传文件的保存目录,为了安全建议在WEB-INF目录下,用户无法访问String uploadpath = this.getServletContext().getRealPath("WEB-INF/Upload");//获取上传文件的保存路径File uploadfile = new File(uploadpath);if (!uploadfile.exists()){uploadfile.mkdir();//如果目录不存在就创建这样一个目录 }/*//临时文件//临时路径,如果上传的文件超过预期的大小,我们将它存放到一个临时目录中,过几天自动删除,或者提醒用户转存为永久String tmppath = this.getServletContext().getRealPath("WEB-INF/tmp");File file = new File(tmppath);if (!file.exists()){file.mkdir();//如果目录不存在就创建这样临时目录}*///处理上传的文件一般需要通过流来获取,我们可以通过request.getInputstream(),原生态文件上传流获取,十分麻烦//但是我们都建议使用Apache的文件上传组件来实现,common-fileupload,它需要依赖于common-io组件;try {//1、创建DiskFileItemFactory对象,处理文件上传路径或限制文件大小File file = null;DiskFileItemFactory factory = gteDiskFileItemFactory(file);//2、获取ServletFileUploadServletFileUpload upload = getServletFileUpload(factory);//3、处理上传文件String msg = uploadParseRequest(upload,request,uploadpath);//Servlet请求转发消息request.setAttribute("msg",msg);request.getRequestDispatcher("/info.jsp").forward(request,response);}catch (FileUploadException e){e.printStackTrace();}}public static DiskFileItemFactory gteDiskFileItemFactory(File file){//1、创建DiskFileItemFactory对象,处理文件上传路径或限制文件大小DiskFileItemFactory factory = new DiskFileItemFactory();//通过这个工厂设置一个缓冲区,当上传的文件大小大于缓冲区的时候,将它放到临时文件中;factory.setSizeThreshold(1024 * 1024);//缓冲区大小为1M factory.setRepository(file);return factory;}public static ServletFileUpload getServletFileUpload(DiskFileItemFactory factory) throws UnsupportedEncodingException {//2、获取ServletFileUploadServletFileUpload upload = new ServletFileUpload(factory);//监听文件上传进度upload.setProgressListener(new ProgressListener() {@Overridepublic void update(long pBytesRead, long lpContentLenght, int i) {//pBytesRead:已读取到的文件大小//pContentLenght:文件大小System.out.println("总大小:"+lpContentLenght+"已上传:"+pBytesRead);}});//处理乱码问题upload.setHeaderEncoding("UTF-8");//设置单个文件的最大值upload.setFileSizeMax(1024 * 1024 * 10);//设置总共能够上传文件的大小//1024 = 1kb * 1024 = 1M * 10 = 10Mupload.setSizeMax(1024 * 1024 * 10);return upload;}public static String uploadParseRequest(ServletFileUpload upload,HttpServletRequest request,String uploadpath) throws IOException, FileUploadException {String msg = "";//3、处理上传文件//把前端的请求解析,封装成一个FileItem对象List<FileItem> fileItems = upload.parseRequest(request);for (FileItem fileItem : fileItems) {if (fileItem.isFormField()){ //判断是普通表单还是带文件的表单//getFieldName指的是前端表单控件的nameString name = fileItem.getFieldName();String value = fileItem.getString("UTF-8");//处理乱码System.out.println(name+":"+value);}else {//判断它是带文件的表单//======================处理文件=======================////拿到文件的名字String uploadFileName = fileItem.getName();System.out.println("上传的文件名:"+uploadFileName);if (uploadFileName.trim().equals("") || uploadFileName == null){continue;}//获得上传的文件名,例如/img/girl/ooa.jpg,只需要ooa,其前面的后面的都不需要String fileName = uploadFileName.substring(uploadFileName.lastIndexOf("/") + 1);//获得文件的后缀名String fileExtName = uploadFileName.substring(uploadFileName.lastIndexOf(".") + 1);/** 如果后缀名 fileExtName 不是我们需要的*就直接return,不处理,告诉用户类型不对* */System.out.println("文件信息【文件名:"+fileName+"文件类型:"+fileExtName+"】");//可以使用UUID(唯一通用识别码)来保证文件名的统一String uuidFileName = UUID.randomUUID().toString();//=======================传输文件=========================////获得文件上传的流InputStream inputStream = fileItem.getInputStream();//创建一个文件输出流FileOutputStream fos = new FileOutputStream(uploadpath + "/" + uuidFileName +"."+ fileExtName);//创建一个缓冲区byte[] buffer = new byte[1024 * 1024];//判断是否读取完毕int len = 0;//如果大于0,说明还存在数据while ((len=inputStream.read(buffer))>0){fos.write(buffer,0,len);}//关闭流 fos.close();inputStream.close();msg = "文件上传成功!";fileItem.delete();//上传成功,清除临时文件 }}return msg;} }
ploadException { String msg = “”; //3、处理上传文件 //把前端的请求解析,封装成一个FileItem对象 List fileItems = upload.parseRequest(request); for (FileItem fileItem : fileItems) { if (fileItem.isFormField()){ //判断是普通表单还是带文件的表单 //getFieldName指的是前端表单控件的name String name = fileItem.getFieldName(); String value = fileItem.getString(“UTF-8”);//处理乱码 System.out.println(name+“:”+value); }else {//判断它是带文件的表单 //处理文件=// //拿到文件的名字 String uploadFileName = fileItem.getName(); System.out.println(“上传的文件名:”+uploadFileName); if (uploadFileName.trim().equals(“”) || uploadFileName == null){ continue; } //获得上传的文件名,例如/img/girl/ooa.jpg,只需要ooa,其前面的后面的都不需要 String fileName = uploadFileName.substring(uploadFileName.lastIndexOf(“/”) + 1); //获得文件的后缀名 String fileExtName = uploadFileName.substring(uploadFileName.lastIndexOf(“.”) + 1); /* * 如果后缀名 fileExtName 不是我们需要的 *就直接return,不处理,告诉用户类型不对 * */ System.out.println(“文件信息【文件名:”+fileName+“文件类型:”+fileExtName+“】”); //可以使用UUID(唯一通用识别码)来保证文件名的统一 String uuidFileName = UUID.randomUUID().toString(); //=传输文件===// //获得文件上传的流 InputStream inputStream = fileItem.getInputStream(); //创建一个文件输出流 FileOutputStream fos = new FileOutputStream(uploadpath + “/” + uuidFileName +“.”+ fileExtName); //创建一个缓冲区 byte[] buffer = new byte[1024 * 1024]; //判断是否读取完毕 int len = 0; //如果大于0,说明还存在数据 while ((len=inputStream.read(buffer))>0){ fos.write(buffer,0,len); } //关闭流 fos.close(); inputStream.close(); msg = “文件上传成功!”; fileItem.delete();//上传成功,清除临时文件 } } return msg; } }