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、获取到上传内容时，对其存储位置进行设置

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