使用fileupload组件实现文件上传功能
FileUpload文件上传
fileUpload是apache的commons组件提供的上传组件,它最主要的工作就是帮我们解析request.getInpustream()。
使用fileUpload组件首先需要引入两个jar包:
- commons-fileUpload.jar
- commons-io.jar
fileUpload的核心类有DiskFileItemFactory、ServletFileUpload、FileItem。
使用fileUpload固定步骤:
- 创建工厂类:DiskFileItemFactory factory=new DiskFileItemFactory();
- 创建解析器:ServletFileUpload upload=new ServletFileUpload(factory);
- 使用解析器解析request对象:List list=upload.parseRequest(request);
一个FileItem对象对应一个表单项。FileItem类有如下方法:
- String getFieldName():获取表单项的name的属性值。
- String getName():获取文件字段的文件名。如果是普通字段,则返回null
- String getString():获取字段的内容。如果是普通字段,则是它的value值;如果是文件字段,则是文件内容。
- String getContentType():获取上传的文件类型,例如text/plain、image。如果是普通字段,则返回null。
- long getSize():获取字段内容的大小,单位是字节。
- boolean isFormField():判断是否是普通表单字段,若是,返回true,否则返回false。
- InputStream getInputStream():获得文件内容的输入流。如果是普通字段,则返回value值的输入流。
前端页面
<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8"%> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Insert title here</title> </head> <body> <form action="uploadServlet" enctype="multipart/form-data" method="post"> <input type="text" name="username"> <input type="password" name="pwd"> <input type="file" name="pic"> <input type="submit"> </form> </body> </html>
UploadServlet
package pers.zhang.servlet; import java.io.File; import java.io.IOException; import java.util.List; import java.util.UUID; 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 UploadServlet extends HttpServlet { protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { doPost(request, response); } protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { DiskFileItemFactory factory=new DiskFileItemFactory(); ServletFileUpload upload=new ServletFileUpload(factory); request.setCharacterEncoding("utf-8"); //文件名中文乱码处理也可以如此写 // upload.setHeaderEncoding("utf-8"); //设置缓冲区大小与临时文件目录 factory.setSizeThreshold(1024*1024*10); File uploadTemp=new File("e:\\uploadTemp"); uploadTemp.mkdirs(); factory.setRepository(uploadTemp); //设置单个文件大小限制 upload.setFileSizeMax(1024*1024*10); //设置所有文件总和大小限制 upload.setSizeMax(1024*1024*30); try { List<FileItem> list=upload.parseRequest(request); System.out.println(list); for (FileItem fileItem:list){ if (!fileItem.isFormField()&&fileItem.getName()!=null&&!"".equals(fileItem.getName())){ String filName=fileItem.getName(); //利用UUID生成伪随机字符串,作为文件名避免重复 String uuid= UUID.randomUUID().toString(); //获取文件后缀名 String suffix=filName.substring(filName.lastIndexOf(".")); //获取文件上传目录路径,在项目部署路径下的upload目录里。若想让浏览器不能直接访问到图片,可以放在WEB-INF下 String uploadPath=request.getSession().getServletContext().getRealPath("/upload"); File file=new File(uploadPath); file.mkdirs(); //写入文件到磁盘,该行执行完毕后,若有该临时文件,将会自动删除 fileItem.write(new File(uploadPath,uuid+suffix)); } } } catch (Exception e) { e.printStackTrace(); } } }
测试
控制台打印:
[name=null, StoreLocation=e:\uploadTemp\upload_9e72474_16ddcccabe6__8000_00000000.tmp, size=5bytes, isFormField=true, FieldName=username, name=null, StoreLocation=e:\uploadTemp\upload_9e72474_16ddcccabe6__8000_00000001.tmp, size=6bytes, isFormField=true, FieldName=pwd, name=C:\Users\19798\Desktop\test.txt, StoreLocation=e:\uploadTemp\upload_9e72474_16ddcccabe6__8000_00000002.tmp, size=20bytes, isFormField=false, FieldName=pic]
项目部署路径下upload文件夹:
使用fileUpload组件实现文件上传除了上面的那些方法之外还要注意的:
- 文件名中文乱码处理:servletFileUpload.setHeaderEncoding(“utf-8”) 或 request.setCharacterEncoding(“utf-8”);
- 表单普通字段中文乱码处理:new String(str.getBytes(“iso-8859-1”,“utf-8”));
- 设置内存缓冲区的大小,默认为10KB:diskFileItemFactory.setSizeThreshold(1024*1024);
- 指定临时文件目录,如果单个文件的大小超过内存缓冲区,该文件将会临时缓存在此目录下:diskFileItemFactory.setRepository(file);
- 设置单个文件大小限制,如果有某个文件超过此大小,将抛出FileUploadBase.FileSizeLimitExceededException:servletFileUpload.setFileSizeMax(1024102410);
- 设置所有文件,也就是请求大小限制,如果文件总和超过此大小,将抛出FileUploadBase.SizeLimitExceededException:servletFileUpload.setSizeMax(1024102420);
- 利用UUID生成伪随机字符串作为文件名避免重复:UUID.randomUUID().toString();
- 将文件写到硬盘上。写完之后,系统会自动将放在临时文件目录的该文件删除:fileItem.write(new File(path,fileName));
另外:如果没有指定临时文件目录,默认采用系统默认的临时文件路径,可以通过System.getProperty(“java.io.tmpdir”)获取,Tomcat系统默认临时目录为“<tomcat安装目录>/temp/”。
Apache文件上传组件在解析上传数据中的每个字段内容时,需要临时保存解析出的数据,以便在后面进行数据的进一步处理(保存在磁盘特定位置或插入数据库)。因为Java虚拟机默认可以使用的内存空间是有限的,超出限制时将会抛出“java.lang.OutOfMemoryError”错误。如果上传的文件很大,例如800M的文件,在内存中将无法临时保存该文件内容,Apache文件上传组件转而采用临时文件来保存这些数据;但如果上传的文件很小,例如600个字节的文件,显然将其直接保存在内存中性能会更加好些。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持我们。