文件上传之commons-fileupload(1)

转自:http://blog.csdn.net/yerenyuan_pku/article/details/52401180

文件上传概述

实现web开发中的文件上传功能,需完成如下二步操作:

  • 在web页面中添加上传输入项。
  • 在servlet中读取上传文件的数据,并保存到本地硬盘中。

那如何在web页面中添加上传输入项呢?
我们可以这样回答:<input type=“file”>标签用于在web页面中添加文件上传输入项,设置文件上传输入项时须注意:

  • 必须要设置input输入项的name属性,否则浏览器将不会发送上传文件的数据。
  • 必须把form的enctype属值设为multipart/form-data。设置该值后,浏览器在上传文件时,将把文件数据附带在http请求消息体中,并使用MIME协议对上传的文件进行描述,以方便接收方对上传数据进行解析和处理。

现在我们设计一个这样的文件上传页面——upload.jsp。

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!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>Insert title here</title>
</head>
<body>
    <form action="${pageContext.request.contextPath }/UploadServlet" enctype="multipart/form-data" method="post">
        上传用户:<input type="text" name="username"><br/>
        上传文件1:<input type="file" name="file1"><br/>
        上传文件2:<input type="file" name="file2"><br/>
        <input type="submit" value="上传">
    </form>
</body>
</html>
  
  

    此时表单的提交方式应该为POST,因为请求方式为POST方式,则可以在请求的实体内容中向服务器发送数据,即文件数据将附带在http请求消息体中。
    接下来我们就要编写UploadServlet,该Servlet用于处理文件上传请求。若UploadServlet的代码写成这样:

    public class UploadServlet extends HttpServlet {
    
        protected void doGet(HttpServletRequest request, HttpServletResponse response)
                throws ServletException, IOException {
    
            // 如果表单类型为multipart/form-data的话,在servlet中注意就不能采用传统方式获取数据
            String username = request.getParameter("username");
            System.out.println(username);
    
        }
    
        protected void doPost(HttpServletRequest request, HttpServletResponse response)
                throws ServletException, IOException {
            doGet(request, response);
        }
    
    }
      
      

      这时我们输入上传用户名和两个文件,Eclipse的控制台输出null。这说明了如果表单类型为multipart/form-data的话,在servlet中就不能采用传统方式获取数据。
      若我们使用Firefox浏览器的Firebug工具对该请求进行监测,则会看到:
      这里写图片描述
      接下来如何在Servlet中读取文件上传数据,并保存到本地硬盘中呢?
      答案应该是这样的:Request对象提供了一个getInputStream方法,通过这个方法可以读取到客户端提交过来的数据。但由于用户可能会同时上传多个文件,在servlet端编程直接读取上传数据,并分别解析出相应的文件数据是一项非常麻烦的工作。
      明了之后,我们把UploadServlet修改为:

      public class UploadServlet extends HttpServlet {
      
          protected void doGet(HttpServletRequest request, HttpServletResponse response)
                  throws ServletException, IOException {
      
              InputStream in = request.getInputStream();
              int len = 0;
              byte[] buffer = new byte[1024];
              while ((len=in.read(buffer)) > 0) {
                  System.out.println(new String(buffer, 0, len));
              }
      
          }
      
          protected void doPost(HttpServletRequest request, HttpServletResponse response)
                  throws ServletException, IOException {
              doGet(request, response);
          }
      
      }
        
        

        这时我们再次输入上传用户名和两个文件,Eclipse的控制台输出如下:

        -----------------------------24566388929294
        Content-Disposition: form-data; name="username"
        
        aaa
        -----------------------------24566388929294
        Content-Disposition: form-data; name="file1"; filename="涓婁紶鏂囦欢1.txt"
        Content-Type: text/plain
        
        aaaaaaaaaa
        -----------------------------24566388929294
        Content-Disposition: form-data; name="file2"; filename="涓婁紶鏂囦欢2.txt"
        Content-Type: text/plain
        
        bbbbbbbbb
        -----------------------------24566388929294--
          
          

          这时我们在servlet端编程直接读取上传数据,并分别解析出相应的文件数据是一项非常麻烦的工作。为方便用户处理文件上传数据,Apache开源组织提供了一个用来处理表单文件上传的一个开源组件( Commons-fileupload ),该组件性能优异,并且其API使用极其简单,可以让开发人员轻松实现web文件上传功能,因此在web开发中实现文件上传功能,通常使用Commons-fileupload组件实现。
          使用Commons-fileupload组件实现文件上传,需要导入该组件相应的支撑jar包:Commons-fileupload和commons-io。commons-io不属于文件上传组件的开发jar文件,但Commons-fileupload组件从1.1版本开始,它工作时需要commons-io包的支持。
          我们从网上下载了这两个jar包。

          • commons-fileupload.jar
          • commons-io-2.5.jar

          大家需要的话可以从网上下载哟!

          fileupload组件工作流程

          fileupload组件工作流程如图所示:
          这里写图片描述

          核心API—DiskFileItemFactory

          DiskFileItemFactory是创建FileItem对象的工厂,这个工厂类常用方法有:

          • public void setSizeThreshold(int sizeThreshold):设置内存缓冲区的大小,默认值为10K。当上传文件大于缓冲区大小时, fileupload组件将使用临时文件缓存上传文件。
          • public void setRepository(java.io.File repository):指定临时文件目录,默认值为System.getProperty("java.io.tmpdir")
          • public DiskFileItemFactory(int sizeThreshold, java.io.File repository):构造函数。

          核心API—ServletFileUpload

          ServletFileUpload负责处理上传的文件数据,并将表单中每个输入项封装成一个FileItem对象中。常用方法有:

          • boolean isMultipartContent(HttpServletRequest request):判断上传表单是否为multipart/form-data类型。
          • List parseRequest(HttpServletRequest request):解析request对象,并把表单中的每一个输入项包装成一个FileItem对象,并返回一个保存了所有FileItem的list集合。
          • setFileSizeMax(long fileSizeMax):设置上传文件的最大值。
          • setSizeMax(long sizeMax):设置上传文件总量的最大值。
          • setHeaderEncoding(java.lang.String encoding):设置编码格式。
          • setProgressListener(ProgressListener pListener)。

          文件上传案例

          首先我们要在项目中加入Apache的commons-fileupload文件上传组件的相关Jar包。
          接着编写文件上传页面——upload.jsp。

          <%@ page language="java" contentType="text/html; charset=UTF-8"
              pageEncoding="UTF-8"%>
          <!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>Insert title here</title>
          </head>
          <body>
              <form action="${pageContext.request.contextPath }/UploadServlet2" enctype="multipart/form-data" method="post">
                  上传用户:<input type="text" name="username"><br/>
                  上传文件1:<input type="file" name="file1"><br/>
                  上传文件2:<input type="file" name="file2"><br/>
                  <input type="submit" value="上传">
              </form>
          </body>
          </html>
            
            

            最后我们要编写处理文件上传的Servlet。初次编写这样的Servlet,心里也会发慌,因为不知道怎么下手,但是我们可以按照下面的步骤将它撸出来。

            1. 创建DiskFileItemFactory对象[,设置缓冲区大小和临时文件目录],也即创建解析工厂。
            2. 使用DiskFileItemFactory对象创建ServletFileUpload对象[,并设置上传文件的大小限制],也即创建解析器。
            3. 调用ServletFileUpload.parseRequest方法解析request对象,得到一个保存了所有上传内容的List对象。
            4. 对list进行迭代,每迭代一个FileItem对象,调用其isFormField方法判断是否是上传文件。
              • 为普通表单字段,则调用getFieldName、getString方法得到字段名和字段值。
              • 为上传文件,则调用getInputStream方法得到数据输入流,从而读取上传数据。

            4个步骤下来,我们的UploadServlet2就写好了。

            public class UploadServlet2 extends HttpServlet {
            
                protected void doGet(HttpServletRequest request, HttpServletResponse response)
                        throws ServletException, IOException {
            
                    try {
                        DiskFileItemFactory factory = new DiskFileItemFactory();
                        ServletFileUpload upload = new ServletFileUpload(factory);
            
                        List<FileItem> list = upload.parseRequest(request);
                        for (FileItem item : list) {
                            if (item.isFormField()) {
                                // 为普通输入项的数据
                                String inputName = item.getFieldName();
                                String inputValue = item.getString();
                                System.out.println(inputName + "=" + inputValue);
                            } else {
                                // 代表当前处理的item里面封装的是上传文件
            
                                // IE6——C:\Users\wang sheng\Desktop\上传文件2.txt
                                // IE7——上传文件2.txt
                                String fileName = item.getName().substring(item.getName().lastIndexOf("\\")+1); 
                                InputStream in = item.getInputStream();
                                int len = 0;
                                byte[] buffer = new byte[1024];
                                FileOutputStream out = new FileOutputStream("c:\\"+fileName);
                                while ((len=in.read(buffer)) > 0) {
                                    out.write(buffer, 0, len);
                                }
                                in.close();
                                out.close();
                            }
                        }
            
                    } catch (Exception e) {
                        throw new RuntimeException(e);
                    }
                }
            
                protected void doPost(HttpServletRequest request, HttpServletResponse response)
                        throws ServletException, IOException {
                    doGet(request, response);
                }
            
            }
              
              

              若当前处理的FileItem对象封装的是上传文件:

              • 若用IE6浏览器上传文件,则在Servlet端中的代码item.getName()获取的是诸如C:\Users\wang sheng\Desktop\上传文件2.txt这样的文件名。
              • 若用IE7及以上版本的浏览器上传文件,则在Servlet端中的代码item.getName()获取的是诸如上传文件2.txt这样的文件名。

              至此,一个文件上传案例就写好了,但以上掌握的知识在实际开发中是不够看的,所以我们应该深入地学习下去。

              • 0
                点赞
              • 1
                收藏
                觉得还不错? 一键收藏
              • 0
                评论
              评论
              添加红包

              请填写红包祝福语或标题

              红包个数最小为10个

              红包金额最低5元

              当前余额3.43前往充值 >
              需支付:10.00
              成就一亿技术人!
              领取后你会自动成为博主和红包主的粉丝 规则
              hope_wisdom
              发出的红包
              实付
              使用余额支付
              点击重新获取
              扫码支付
              钱包余额 0

              抵扣说明:

              1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
              2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

              余额充值