JavaWeb 案例6— 使用 commons-fileupload.jar 实现文件上传

一、文件上传

　　文件的上传和下载，是非常常见的功能，在很多的系统中，或软件中都经常使用文件的上传和下载

　　文件的上传主要分为下面几步：

　　1、前台页面需要一个 form 标签，里面的 method 为 post 请求；

　　2、在 form 标签必须添加 encType属性，且属性值必须是 multipart/form-data值；

　　3、在 form 标签中使用 input type=file 添加上传的文件；

　　4、在服务器编写代码（Servlet程序）接收，处理上传的数据。

　　　　注意点：

　　　　　　1. 请求必须是 post，因为 get 请求有长度限制；

　　　　　　2. encType=multipart/form-data 表示提交的数据，是以多段（每一个表单项一个数据段）的形式进行拼接，然后以二进制流的形式发送给服务器的；

　　　　　　3. 在服务器端必须以流的方式接收数据；

二、文件上传之 HTTP 协议的说明

　　　　

 

三、Commons-fileupload.jar 常用 API 

　　 注意：commons-fileupload.jar 包需要依赖 commons-io.jar这个包，所以需要在项目中引入两个包。

　　1、常用API与类

FileItemFactory      表单项工厂接口
ServletFileUpload    文件上传类，用于解析上传的数据
FileItem             表单项类，表示每一个表单项

boolean ServletFileUpload.isMultipartContent(HttpServletRequest request)   判断当前上传的数据格式是否是多段的格式，只有是多段数据，才能使用该方式
public List<FileItem> parseRequest(HttpServletRequest request)             解析上传的数据，返回包含 表单项的 List 集合
boolean FileItem.isFormField() 　　　　　　判断当前这个表单项，是否是普通的表单项，还是上传的文件类型，true 表示普通类型的表单项；false 表示上传的文件类型
String FileItem.getFieldName() 　　　　　　获取表单项的 name 属性值
String FileItem.getString()       　　　　获取当前表单项的值；

String FileItem.getName()　　　　　　　　  获取上传的文件名
void FileItem.write( file )　　　　　　　　将上传的文件写到 参数 file 所指向存取的硬盘位置 

　　

　　2、流程图

　　　　　　

四、案例

　　上传文件的表单：

<form action="uploadServlet" method="post" enctype="multipart/form-data">
　　用户名： <input type="text" name="username" /> <br>
　　照片： <input type="file" name="photo" > <br>
　　<input type="submit" value="上传">
</form>

　　解析上传的数据的 Servlet

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileItemFactory;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.IOException;
import java.util.List;

public class UploadServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        //解决中文乱码
        request.setCharacterEncoding("UTF-8");

        //1. 先判断上传的的数据是否多段数据（只有是多段的数据，才是文件上传的）
        if ( ServletFileUpload.isMultipartContent(request) ) {

            //创建 FileItemFactory 工厂实现类
            FileItemFactory fileItemFactory = new DiskFileItemFactory();
            // 2. 创建用于解析上传数据的工具类
            ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);

            try {
                // 3. 解析 上传的数据，得到每一个表单项 FiltItem
                List<FileItem> list = servletFileUpload.parseRequest(request);

                //循环判断，每一个表单项，是普通类型，还是上传的文件
                for (FileItem fileItem : list) {

                    // 是普通表单项
                    if ( fileItem.isFormField() ) {
                        String fieldName = fileItem.getFieldName();
                        String value = fileItem.getString("UTF-8");

                        System.out.println("表单项的name属性值 = " + fieldName);
                        System.out.println("表单项的value属性值 = " + value);
                    } else {
                        //是上传的文件
                        String name = fileItem.getFieldName();
                        String fieldName = fileItem.getName();

                        System.out.println("表单项的name属性值 = " + name);
                        System.out.println("上传的文件名 = " + fieldName);

                        // 将数据写到指定的位置
                        fileItem.write(new File( "F:\" + fileItem.getName()));
                    }
                }

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

        }


    }

　　注意：

　　　　这样的上传还有一个小问题，当上传多个同名同类型的文件时，后上传的文件会覆盖掉原来上传的文件，为了解决这一问题，可以在文件名前面加入当前时间的毫秒值即可。

　　防止文件覆盖，将数据存储可改成下面这种写法：

fileItem.write(new File( "F:\" + System.currentTimeMillis() + fileItem.getName()));