web--使用fileupload进行文件上传

红太狼 2021-08-13 18:01 381阅读 0赞

#### FileUpload文件上传 ####

fileUpload是apache的commons组件提供的上传组件，它最主要的工作就是帮我们解析request.getInpustream()。

使用fileUpload组件首先需要引入两个jar包：

*  commons-fileUpload.jar
 *  commons-io.jar  
    fileUpload的核心类有DiskFileItemFactory、ServletFileUpload、FileItem。

**使用fileUpload固定步骤：**

1.  创建工厂类：DiskFileItemFactory factory=new DiskFileItemFactory();
2.  创建解析器：ServletFileUpload upload=new ServletFileUpload(factory);
3.  使用解析器解析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();
            }
    	}
    
    }

#### 测试 ####

![在这里插入图片描述][20191018105655373.png]  
**控制台打印：**

[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文件夹：**  
![在这里插入图片描述][20191018110501613.png]  
**使用fileUpload组件实现文件上传除了上面的那些方法之外还要注意的：**

1.  文件名中文乱码处理：servletFileUpload.setHeaderEncoding(“utf-8”) 或 request.setCharacterEncoding(“utf-8”);
2.  表单普通字段中文乱码处理：new String(str.getBytes(“iso-8859-1”,“utf-8”));
3.  设置内存缓冲区的大小，默认为10KB：diskFileItemFactory.setSizeThreshold(1024\*1024);
4.  指定临时文件目录，如果单个文件的大小超过内存缓冲区，该文件将会临时缓存在此目录下：diskFileItemFactory.setRepository(file);
5.  设置单个文件大小限制，如果有某个文件超过此大小，将抛出FileUploadBase.FileSizeLimitExceededException：servletFileUpload.setFileSizeMax(1024*1024*10);
6.  设置所有文件，也就是请求大小限制，如果文件总和超过此大小，将抛出FileUploadBase.SizeLimitExceededException：servletFileUpload.setSizeMax(1024*1024*20);
7.  利用UUID生成伪随机字符串作为文件名避免重复：UUID.randomUUID().toString();
8.  将文件写到硬盘上。写完之后，系统会自动将放在临时文件目录的该文件删除：fileItem.write(new File(path,fileName));

另外：如果没有指定临时文件目录，默认采用系统默认的临时文件路径，可以通过System.getProperty(“java.io.tmpdir”)获取，Tomcat系统默认临时目录为“<tomcat安装目录>/temp/”。

Apache文件上传组件在解析上传数据中的每个字段内容时，需要临时保存解析出的数据，以便在后面进行数据的进一步处理（保存在磁盘特定位置或插入数据库）。因为Java虚拟机默认可以使用的内存空间是有限的，超出限制时将会抛出“java.lang.OutOfMemoryError”错误。如果上传的文件很大，例如800M的文件，在内存中将无法临时保存该文件内容，Apache文件上传组件转而采用临时文件来保存这些数据；但如果上传的文件很小,例如600个字节的文件,显然将其直接保存在内存中性能会更加好些。

[20191018105655373.png]: /images/20210813/41b3fb372cad4b6ba10e8d6f19880508.png
[20191018110501613.png]: /images/20210813/cf8d2f430b764a85b004c9bc2d276747.png