文件上传 - Commons FileUpload介绍

概述

FileUpload能够以多种不同的方式使用，具体取决于应用程序的要求。在最简单的情况下，调用单个方法来解析servlet请求，然后处理解析出来的Item集合。此外也可以自定义FileUpload已完全控制各个Item的存储方式，比如设置缓存目录、直接将接收到的Item以流的形式写入数据库等。

FileUpload依赖于Commons IO，因此类路径下要有Commons IO的jar包。当然采用Maven依赖的方式不用担心，maven会自动下载Commons IO包。

FIleUpload使用

上传文件，注意几个问题：

① form表单内，要添加空间<input type="file" name="myfile">
② form表单的内容格式要定义成multipart/form-data格式：<form action="admin/good_add" method="post" enctype="multipart/form-data">
③ 需要类库：1 commons-io.jar ，2 commons-fileupload-1.3.1.jar

接下来我们看下他的用法。

1 创建工厂类

DiskFileItemFactory factory = new DiskFileItemFactory();

FileItemFactory可以设置内容：

● setRepository(File dir)；//设置临时文件存储位置。

● setSizeThreshold(long bytes)；//设置请求大小阈值，当请求大于该值时，接收到的数据是缓存在磁盘中的，否则直接缓存到内存中。

● setFileCleaningTracker(FileCleaningTracker pTracker)；//设置临时文件清理跟踪器

2 创建核心类-文件解析对象

ServletFileUpload upload = new ServletFileUpload(DiskFileItemFactory factory);

ServletFileUpload可以设置内容：

● setSizeMax(long bytes)；//设置整个请求的最大值，大于该值时，不允许传送。

● setFileMaxSize(long bytes)；//设置单个文件的最大值，大于该值时，不允许传送。

● setHeaderEncoding(String charset)；//设置读取每个FileItem的头数据的字符编码，不设置时采用request编码，也没有时采用系统默认编码。

● serProgressListener(ProgressListener pListener)；//设置上传进度监听器

3 解析request请求-进行文件解析后放在List中，因为这个类库支持多个文件上传，因此把结果会存在List中。

List<FileItem> list = upload.parseRequest(request);

FileItem能够获取的内容：

● getContentType()；//获取单个Item的ContentType

● getName()；//获取Item本来的文件名，如果不是文件则为null

● getFieldName()；//获取Item的field名

● getSize()；//获取Item的大小

● get()；//将Item转换成字节数组返回

● isInMemory()；//Item目前是否存在内存中

● isFormField()；//是否是表单域

● getInputStream()；//获取输入流，用于读取Item

上传原理和代码分析

上传：将需要上传的资源，发送给服务器，在服务器中保存下来。

下载：下载资源时，将服务器上的某个资源发送给浏览器。

浏览器端：

注意：enctype=multipart/form-data：该属性表明发送的请求体的内容是多表单元素的，通俗点讲，就是有各种各样的数据，可能有二进制数据，也可能有表单数据，等等。

 <form class="form-horizontal" action="${pageContext.request.contextPath }/admin/good_add" method="post" enctype="multipart/form-data">
     <div class="form-group">
         <label for="input_name" class="col-sm-1 control-label">名称</label>
         <div class="col-sm-6">
             <input type="text" class="form-control" id="input_name" name="name" required="required">
         </div>
     </div>
     <div class="form-group">
         <label for="input_name" class="col-sm-1 control-label">价格</label>
         <div class="col-sm-6">
             <input type="text" class="form-control" id="input_name" name="price">
         </div>
     </div>
     <div class="form-group">
         <label for="input_name" class="col-sm-1 control-label">介绍</label>
         <div class="col-sm-6">
             <input type="text" class="form-control" id="input_name" name="intro">
         </div>
     </div>
     <div class="form-group">
         <label for="input_name" class="col-sm-1 control-label">库存</label>
         <div class="col-sm-6">
             <input type="text" class="form-control" id="input_name" name="stock">
         </div>
     </div>
     <div class="form-group">
         <label for="input_file" class="col-sm-1 control-label">封面图片</label>
         <div class="col-sm-6">
             <input type="file" name="cover" id="input_file" required="required">推荐尺寸: 500 * 500
         </div>
     </div>
     <div class="form-group">
         <label for="input_file" class="col-sm-1 control-label">详情图片1</label>
         <div class="col-sm-6">
             <input type="file" name="image1" id="input_file" required="required">推荐尺寸: 500 * 500
         </div>
     </div>
     <div class="form-group">
         <label for="input_file" class="col-sm-1 control-label">详情图片2</label>
         <div class="col-sm-6">
             <input type="file" name="image2" id="input_file" required="required">推荐尺寸: 500 * 500
         </div>
     </div>
     <div class="form-group">
         <label for="select_topic" class="col-sm-1 control-label">类目</label>
         <div class="col-sm-6">
             <select class="form-control" id="select_topic" name="good.type.id">
                 <c:forEach items="${typeList }" var="t">
                     <option value="${t.id }">${t.name }</option>
                 </c:forEach>
             </select>
         </div>
     </div>
     <div class="form-group">
         <div class="col-sm-offset-1 col-sm-10">
             <button type="submit" class="btn btn-success">提交保存</button>
         </div>
     </div>
 </form>

My Code

使用multipart/form-data会有一个boundary属性，来用将提交的表单数据进行分隔，以用来让服务器知道哪个是我们上传的资源，哪个是普通的表单数据。

 <form action="adctionServlet" method="post" enctype="enctype=multipart/form-data">
     描述：<input type="text" name=""/><br/>
     图片：<input type="file" name="image"/><br/>
     <input type="submit" value="上传"/>
 </form>

服务器端：

使用commons-fileupload进行处理上传内容。

 try {
     DiskFileItemFactory factory = new DiskFileItemFactory();
     ServletFileUpload upload = new ServletFileUpload(factory);

     List<FileItem> list = upload.parseRequest(request);
     Goods goods = new Goods();
     for (FileItem item : list) {

         // 判断itme;true-为普通输入项,false-为文件
         if (item.isFormField()) {

             // 设置商品属性
             switch (item.getFieldName()) {
             case "name":
                 goods.setName(item.getString("utf-8"));
                 break;
             case "price":
                 goods.setPrice(Float.parseFloat(item.getString("utf-8")));
                 break;
             case "intro":
                 goods.setIntro(item.getString("utf-8"));
                 break;
             case "stock":
                 goods.setStock(Integer.parseInt(item.getString("utf-8")));
                 break;
             case "good.type.id":
                 goods.setTypeid(Integer.parseInt(item.getString("utf-8")));
                 break;
             }
         } else {

             if (item.getInputStream().available() <= 0) {
                 continue;
             }
             // 1-获取文件名；2-获取后缀名；3-根据毫秒值设置新的文件名；4-创建保存路径
             String fileName = item.getName();
             fileName = fileName.substring(fileName.indexOf("."));
             fileName = "/" + System.currentTimeMillis() + fileName;
             String path = this.getServletContext().getRealPath("/picture") + fileName;

             // 读取上传
             InputStream in = item.getInputStream();
             FileOutputStream out = new FileOutputStream(path);
             byte[] buff = new byte[1024];
             int len = 0;
             while ((len = in.read(buff)) > 0) {
                 out.write(buff, 0, len);
             }
             in.close();
             out.close();

             // 设置商品属性
             switch (item.getFieldName()) {
             case "cover":
                 goods.setCover("/picture" + fileName);
                 break;
             case "image1":
                 goods.setImage1("/picture" + fileName);
                 break;
             case "image2":
                 goods.setImage2("/picture" + fileName);
                 break;
             }
         }
         item.delete();
     }
 } catch (FileUploadException e) {
     e.printStackTrace();
 }    

My Code

上传的各种问题：

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

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

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

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

 public void doGet(HttpServletRequest request, HttpServletResponse response)
         throws ServletException, IOException {
     try {

         //0.5 检查是否支持文件上传  ,检查请求头Content-Type : multipart/form-data
         if(!ServletFileUpload.isMultipartContent(request)){
             throw new RuntimeException("不要得瑟，没用");
         }

         //1 工厂
         DiskFileItemFactory fileItemFactory = new DiskFileItemFactory();
         // 1.1 设置是否生产临时文件临界值。大于2M生产临时文件。保证：上传数据完整性。
         fileItemFactory.setSizeThreshold(1024 * 1024 * 2);  //2MB
         // 1.2 设置临时文件存放位置
         // * 临时文件扩展名  *.tmp  ，临时文件可以任意删除。
         String tempDir = this.getServletContext().getRealPath("/temp");
         fileItemFactory.setRepository(new File(tempDir));

         //2 核心类
         ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
         // 2.1 如果使用无参构造  ServletFileUpload() ，手动设置工厂
         //servletFileUpload.setFileItemFactory(fileItemFactory);
         // 2.2 单个上传文件大小
         //servletFileUpload.setFileSizeMax(1024*1024 * 2);  //2M
         // 2.3 整个上传文件总大小
         //servletFileUpload.setSizeMax(1024*1024*10);        //10M
         // 2.4 设置上传文件名的乱码
         // * 首先使用  setHeaderEncoding 设置编码
         // * 如果没有设置将使用请求编码 request.setCharacterEncoding("UTF-8")
         // * 以上都没有设置，将使用平台默认编码
         servletFileUpload.setHeaderEncoding("UTF-8");
         // 2.5 上传文件进度，提供监听器进行监听。
         servletFileUpload.setProgressListener(new MyProgressListener());

         //3 解析request  ,List存放 FileItem （表单元素的封装对象，一个<input>对应一个对象）
         List<FileItem> list = servletFileUpload.parseRequest(request);

         //4 遍历集合获得数据
         for (FileItem fileItem : list) {
             // 判断
             if(fileItem.isFormField()){
                 // 5 是否为表单字段（普通表单元素）
                 //5.1.表单字段名称
                 String fieldName = fileItem.getFieldName();
                 System.out.println(fieldName);
                 //5.2.表单字段值 ， 解决普通表单内容的乱码
                 String fieldValue = fileItem.getString("UTF-8");
                 System.out.println(fieldValue);
             } else {
                 //6 上传字段（上传表单元素）
                 //6.1.表单字段名称  fileItem.getFieldName();
                 //6.2.上传文件名
                 String fileName = fileItem.getName();
                 // * 兼容浏览器， IE ： C:\Users\liangtong\Desktop\abc.txt  ; 其他浏览器 ： abc.txt
                 fileName = fileName.substring(fileName.lastIndexOf("\\") + 1);
                 // * 文件重名
                 fileName = UUID.randomUUID().toString().replace("-", "") + fileName;
                 // * 单个文件夹文件个数过多？
                 String subDir = StringUtils.getDir(fileName);

                 System.out.println(fileName);
                 //6.3.上传内容
                 InputStream is = fileItem.getInputStream();
                 String parentDir = this.getServletContext().getRealPath("/WEB-INF/upload");
                 File file = new File(parentDir + subDir,fileName);

                 // 将指定流 写入 到 指定文件中  -- mkdirs() 自动创建目录
                 FileUtils.copyInputStreamToFile(is, file);

                 //7删除临时文件
                 fileItem.delete();
             }
         }

     } catch (Exception e) {
         e.printStackTrace();

         throw new RuntimeException(e);

     }
 }

总结上传：

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

1、创建工厂类

2、使用核心类，

3、解析request请求，

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

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

@部分转载自：https://www.cnblogs.com/whgk/p/6479405.html