文件上传

文件的上传

一、基本概念及注意事项

1、实现web开发中的文件上传功能，需完成如下二步操作：

（1）在web页面中添加上传输入项

（2）在servlet中读取上传文件的数据，并保存到本地硬盘中。

2、<input type=“file”>标签用于在web页面中添加文件上传输入项，设置文件上传输入项时须注意：

（1）必须要设置input输入项的name属性，否则浏览器将不会发送上传文件的数据。

（2）必须把form的enctype属值设为multipart/form-data.设置该值后，浏览器在上传文件时，将把文件数据附带在http请求消息体中，并使用ＭＩＭＥ协议对上传的文件进行描述，以方便接收方对上传数据进行解析和处理。

3、在Servlet中读取文件上传数据，并保存到本地硬盘中：

（1）Request对象提供一个getInputStream方法，通过这个方法可以读取到客户端提交过来的数据。但由于用户可能会同时上传多个文件，在servlet端编程直接读取上传数据，并分别解析出相应的文件数据是一项非常麻烦的工作，示例。

（2）为方便用户处理文件上传数据，Apache开源组织提供了一个用来处理表单文件上传的一个开源组件（Commons-fileupload），该组件性能优异，并且其API使用极其简单，可以让开发人员轻松实现web文件上传功能，因此在web开发中实现文件上传功能，通常使用Commons-fileupload组件实现。

4、使用Commons-fileupload组件实现文件上传，需导入组件相应支撑jar包：Commons-fileupload和commons-io

commons-io 不属于文件上传组件的开发jar文件，但Commons-fileupload组件从1.1版本开始，它工作时需要commons-io包的支持。

二、上传应用：

1、DiskFileItemFactory是创建 FileItem对象的工厂

类常用方法：

（1）public voidsetSizeThreshold(int sizeThreshold)：设置内存缓冲区的大小，默认值为10K。当上传文件大于缓冲区大小时， fileupload组件将使用临时文件缓存上传文件。

（2）public voidsetRepository(java.io.File repository)：指定临时文件目录，默认值为System.getProperty("java.io.tmpdir").

（3）publicDiskFileItemFactory(int sizeThreshold, java.io.File repository)：构造函数

2、ServletFileUpload负责处理上传的文件数据，并将表单中每个输入项封装成一个 FileItem对象中。

常用方法：

（1）booleanisMultipartContent(HttpServletRequest request)：判断上传表单是否为multipart/form-data类型

（2）ListparseRequest(HttpServletRequest request)：解析request对象，并把表单中的每一个输入项包装成一个fileItem对象，并返回一个保存了所有FileItem的list集合。

（3）setFileSizeMax(long fileSizeMax)：设置上传文件的最大值

（4）setSizeMax(long sizeMax)：设置上传文件总量的最大值

（5）setHeaderEncoding(java.lang.String encoding)：设置编码格式

（6）setProgressListener(ProgressListener pListener)

3、文件上传实现步骤

（1）创建DiskFileItemFactory对象，设置缓冲区大小和临时文件目录

（2）使用DiskFileItemFactory对象创建ServletFileUpload对象，并设置上传文件的大小限制。

（3）调用ServletFileUpload.parseRequest方法解析request对象，得到一个保存了所有上传内容的List对象。

（4）对list进行迭代，每迭代一个FileItem对象，调用其isFormField方法判断是否是上传文件

①为普通表单字段，则调用getFieldName、getString方法得到字段名和字段值

②为上传文件，则调用getInputStream方法得到数据输入流，从而读取上传数据。

三、上传文件的处理细节

1、中文文件乱码问题

文件名中文乱码问题，可调用ServletUpLoader的setHeaderEncoding方法，或者设置request的setCharacterEncoding属性

2、 临时文件的删除问题

（1）由于文件大小超出DiskFileItemFactory.setSizeThreshold方法设置的内存缓冲区的大小时，Commons-fileupload组件将使用临时文件保存上传数据，因此在程序结束时，务必调用FileItem.delete方法删除临时文件。

（2）Delete方法的调用必须位于流关闭之后，否则会出现文件占用，而导致删除失败的情况。

3、 文件存放位置

（1）为保证服务器安全，上传文件应保存在应用程序的WEB-INF目录下，或者不受WEB服务器管理的目录。

（2）为防止多用户上传相同文件名的文件，而导致文件覆盖的情况发生，文件上传程序应保证上传文件具有唯一文件名。

（3）为防止单个目录下文件过多，影响文件读写速度，处理上传文件的程序应根据可能的文件上传总量，选择合适的目录结构生成算法，将上传文件分散存储。

四、doGet中代码说明上传步骤及其注意细节

        try{

        //1、创建一个解析器工厂

        DiskFileItemFactoryfactory =newDiskFileItemFactory();

        //细节4：删除临时文件

        //获取临时文件路径

        String tempPath=this.getServletContext().getRealPath("/temp");

        //设置临时文件并传入临时文件

        factory.setRepository(newFile(tempPath));

        //2、得到一个解析器

        ServletFileUploadupload=newServletFileUpload(factory);

        //小细节1：如果上传的文件名是中文，用下面的进行乱码处理

        upload.setHeaderEncoding("utf-8");

        //3、将请求出传入解析器，对请求进行解析

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

        //4.迭代list集合，获取每个输入项的数据

        for(FileItemitem:list){

           //判断是普通输入项还是上传输入项

           if(item.isFormField()){

               //普通输入项

               StringinputName=item.getFieldName();

               //小细节2：对上传的名字进行编码处理

               //方法一：手工处理

               StringinputValue=item.getString("UTF-8");

               /*方法二：String inputValue=item.getString();

               inputValue=new String(inputValue.getBytes("iso8859-1"),"UTF-8");

               */System.out.println(inputName+""+inputValue);

           }else{

               //上传输入项

               StringfileName=item.getName();//获取到上传文件的文件名

               //细节3：判断输入项不为空时进行上传

               if(!fileName.equals("")){

               //获取文件名并处理文件，不带路径

               fileName=fileName.substring(fileName.lastIndexOf("\\")+1);

               //细节6：产生新的保存同名文件的名字

               String saveName=this.generateFileName(fileName);

               InputStreamin=item.getInputStream();

               //细节5：为保证服务器安全，上传文件应保存在应用程序的WEB-INF目录下，或者不受WEB服务器管理的目录。

               String savePath=this.getServletContext().getRealPath("WEB-INF/upload");

               //加入细节七的经改过path路径

               String savePaths=this.generateFilePath(savePath,fileName);

               FileOutputStreamout=newFileOutputStream(savePaths+"\\"+saveName);

               byte[]buf=newbyte[1024];

               intlen=0;

               while((len=in.read(buf))>0){

                   out.write(buf,0,len);

               }

               in.close();

               out.close();

               item.delete();//删除item对应的临时文件，必须在流关闭之后

           }

           }

           request.setAttribute("message","上传成功");

        }

        }catch(Exceptione){

           request.setAttribute("message","上传失败");

        }

        request.getRequestDispatcher("/message.jsp").forward(request,response);

        //不能使用传统方式

        /*//System.out.println(request.getParameter("username"));

        InputStreamin=request.getInputStream();

        byte[]buf=new byte[1024];

        intlen=0;

        while((len=in.read(buf))>0){

           System.out.println(newString(buf,0,len));

        }*/

    }

    //细节6：处理同名文件

    publicString generateFileName(String filename){

        //UUID.randomUUID()随机产生一串加入名字中，避免同名带来的麻烦

        returnUUID.randomUUID().toString()+"_"+filename;

    }

    //细节7：通过上传文件的hashcode产生文件夹分散存放。

    publicString generateFilePath(String path,String filename){

        //需要建立的第一层文件夹

        intdir1=filename.hashCode()&0xf;

        //需要建离得第二次文件夹（移位）

        intdir2=filename.hashCode()>>4&0xf;

        //建立保存的目录

        String savePath=path+"\\"+dir1+"\\"+dir2;

        Filef=new File(savePath);

        if(!f.exists()){

        f.mkdirs();

        }

        returnsavePath;

    }