Apache Commons FileUpload实现文件上传

Posted 2022-01-30 lukelook

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Apache Commons FileUpload实现文件上传相关的知识，希望对你有一定的参考价值。

一、Apache Commons-FileUpload简介

Apache Commons是一个专注于可重用Java组件的所有方面的 Apache 项目。
Apache Commons项目由三个部分组成：

Commons Proper - 可重用Java组件的存储库。
The Commons Sandbox - 用于Java组件开发的工作区。
The Commons Dormant - 当前不活动的组件存储库。

Commons-FileUpload是Commons Proper中的一个组件，该组件依赖于Commons-IO ，Commons-IO也是 Commons Proper中的一个组件。
Commons FileUpload的JAR包下载
Commons IO的JAR包下载

二.maven依赖

<!-- upload file -->
        <!-- https://mvnrepository.com/artifact/commons-fileupload/commons-fileupload -->
        <dependency>
            <groupId>commons-fileupload</groupId>
            <artifactId>commons-fileupload</artifactId>
            <version>1.3.1</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/commons-io/commons-io -->
        <dependency>
            <groupId>commons-io</groupId>
            <artifactId>commons-io</artifactId>
            <version>2.4</version>
        </dependency>

三.前端界面

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
    <% String path = request.getContextPath(); %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>upload</title>
</head>
<br>
<br>

<form action="<%=path%>/device/uploadFile" method ="post" enctype="multipart/form-data">
    <input type ="file" name ="doc1"><br><br>
    <input type ="file" name ="doc2"><br><br>
    <input type ="text" name = info><br><br>
    <input type ="password" name ="password"><br><br>
    
    <input type="submit" value="提交">
</form>

<body>

</body>
</html>

四.后台代码

@RequestMapping(value="/uploadFile")
    public String uploadFile(final HttpServletRequest request, final HttpServletResponse response)         
    
        request.setAttribute("msg", "Not first time!");        
         //创建一个“硬盘文件条目工厂”对象
        DiskFileItemFactory factory = new DiskFileItemFactory();
        //设置阈值，设置JVM一次能够处理的文件大小（默认吞吐量是10KB）
        factory.setSizeThreshold(DiskFileItemFactory.DEFAULT_SIZE_THRESHOLD);
        //设置临时文件的存储位置（文件大小大于吞吐量的话就必须设置这个值，比如文件大小：1GB ，一次吞吐量：1MB）
         factory.setRepository(new File("d:\\\\test"));
        //创建核心对象
         ServletFileUpload fileUpload = new ServletFileUpload(factory);
        //设置最大可支持的文件大小（10MB）
         fileUpload.setFileSizeMax(1024*1024*10);
        //设置转换时使用的字符集
         fileUpload.setHeaderEncoding("UTF-8");
         if(ServletFileUpload.isMultipartContent(request))
             try 
                List<FileItem> fileItems = fileUpload.parseRequest(request);
                for ( FileItem fileItem : fileItems) 
                    if(fileItem.isFormField())//判断该FileItem为一个普通的form元素
                        //获取字段名
                        String fieldName = fileItem.getFieldName();
                        //获取字段值，并解决乱码
                        String fieldValue = fileItem.getString("UTF-8");
                        System.out.println(fieldName +" : " + fieldValue);
                        
                    else//判断该FileItem为一个文件
                        
                        System.out.println("Start to uplaod file!");
                        //获取文件名
                        String fileName = fileItem.getName();
                        System.out.println("fileName : " + fileName);
                        //获取文件大小
                        long fileSize = fileItem.getSize();
                        System.out.println("fileSize : " + fileSize);
                        
                        fileItem.write(new File("D://test//upload"+File.separator +fileName));
                    
                
             catch (FileUploadException e) 
                // TODO Auto-generated catch block
                e.printStackTrace();
             catch (UnsupportedEncodingException e) 
                // TODO Auto-generated catch block
                e.printStackTrace();
             catch (Exception e) 
                // TODO Auto-generated catch block
                e.printStackTrace();
            
         
        
    return "device/uploadFile";

五。异常

catch(FileUploadBase.SizeLimitExceededException ex)
                out.print("上传失败，文件太大，单个文件的最大限制是："+upload.getSizeMax()+"bytes!");

1.其中需要注意的是流的操作，和File类的操作，mkdirs()和mkdir()的区别是什么？它们都是用来创建文件夹的，区别在mkdirs能创建多级目录，而mkdir()只能创建当前的文件夹，如果发现上一层目录并还没有创建时，它也会无动于衷，什么也不干，也就不能创建当前文件夹，必须先要创建了上一级文件夹才可以。

2.上面还有很多的问题需要解决，比如上传文件名的乱码问题，比如单表内容的乱码问题，比如上传文件同名问题，如果上传的文件很大，该如何进行处理，比如，放在同一级目录下的文件过多如何处理。每次都自己手动写输出流，将内容存到指定位置，太过麻烦，等等问题，现在写一个加强版，在解决上面所有的问题。

3.上传文件名乱码问题：使用servletFileUpload.setHeaderEncoding("UTF-8");或者request.setCharacterEncoding("UTF-8")都可以

4.表单内容乱码问题：使用getString("utf-8")即可，也就是在获取内容时，就可以设置码表。

5.上传文件同名问题：使用UUID.randomUUID().toString().replace("-", "").获得一个独一无二的32位数字

6.使用FileUtils.copyInputStreamToFile(is, file);来将内容输出到指定路径文件中去，mkdirs() 自动创建目录

7.同一级目录下的文件过多问题：创建多级目录，通过文件名的hashcode的值，hashCode为int型，占4个字节，一个字节占8位，也就是占32位，将其分组，4位4位一组，就能分8组，每一次代表一层目录，也就能够分8层目录，每一层中，有可以创建16种不同的文件夹。这样算下来，就能有很多很多个文件夹了，每个文件夹下面都可以存很多文件，看我们的业务需求，来决定要创建几层目录，就从hashcode中拿几组数据出来。原理图如下

　　　　　　　　　　　　技术图片

生成两级目录

public class StringUtils 

    /**
     * 生成二级目录
     * @param fileName  abc.txt
     * @return  /4/5
     */
    public static String getDir(String fileName) 
        //1 hashCode值
        int hashCode = fileName.hashCode();
        System.out.println(hashCode);
        //2 第一层 0xf表示15的16进制数。
        int dir1 = hashCode & 0xf;
        //3 第二层目录
        int dir2 = hashCode >>> 4 & 0xf;
        
        //4 拼写
        return "/" + dir1 + "/" + dir2;
    
    
    public static void main(String[] args) 
        System.out.println(getDir("abc.txt"));

总结上传：

　　　　　　　　其实理解了也不是很难，就是上传文件后的处理比较麻烦，各种小问题，存储过程最为麻烦。

　　　　　　　　1、创建工厂类

　　　　　　　　2、使用核心类，

　　　　　　　　3、解析request请求，

　　　　　　　　4、遍历请求体的内容，将上传内容和普通表单内容都获取出来

　　　　　　　　5、获取到上传内容时，对其存储位置进行设置

　　　　　　　　其中很多细节问题都在上面已经说清楚了，代码中也有很多注释。

以上是关于Apache Commons FileUpload实现文件上传的主要内容，如果未能解决你的问题，请参考以下文章

Apache Commons FileUpload实现文件上传

Spring MVC - AngularJS - 文件上传 - org.apache.commons.fileupload.FileUploadException

Apache Commons FileUpload??????????????????

The import org.apache.commons.fileupload cannot be resolved

java.lang.NoClassDefFoundError: org/apache/commons/fileupload/FileItemFactory

文件上传之Apache commons fileupload使用