Java Web文件上传

参考资料：http://www.cnblogs.com/xdp-gacl/p/4200090.html

一、问题描述

Java Web文件上传需要借助一些第三方库，常用的是借助Apache的包，有两个：

commons-fileupload

commons-io

二、前端代码示例

    <form method="post" id="uploadApkForm" action="uploadapk"
        enctype="multipart/form-data">
        <p>
            文件：<input name="apkFile" type="file" /> <!--有multiple属性时支持选中多个文件同时上传-->
        </p>
        <p>
            版本：<input name="version" type="text" placeholder="请输入版本信息" />
        </p>
    </form>

注：

　enctype="multipart/form-data" 是必须的，表示这是个含文件的form表单；

　若type="file" 的 input标签含有 multiple 属性，则能够在弹出框中同时选中多个文件上传

三、后端代码示例

        try {
            // 判断enctype属性是否为multipart/form-data
            boolean isMultipart = ServletFileUpload.isMultipartContent(request);
            if (!isMultipart) {// 不是文件上传，用传统方法获取数据
                // String userId = request.getParameter("userId");等
                return;
            }

            // 为multipart/form-data
            int maxMemorySize = 1024 * 1000 * 50;// 50MB
            int maxRequestSize = 1024 * 1000 * 100;// 100MB
            String projAbsolutePath = request.getRealPath("");
            String uploadRelativeDir = "upload/apk/";
            String uploadTmpRelativeDir = uploadRelativeDir + "/tmp/";
            File uploadDirObj = new File(projAbsolutePath + uploadRelativeDir);
            if (!uploadDirObj.exists()) {
                uploadDirObj.mkdirs();
            }
            File uploadTmpDirObj = new File(projAbsolutePath + uploadTmpRelativeDir);
            if (!uploadTmpDirObj.exists()) {
                uploadTmpDirObj.mkdirs();
            }

            // Create a factory for disk-based file items
            DiskFileItemFactory factory = new DiskFileItemFactory();

            // 当上传文件太大时，因为虚拟机能使用的内存是有限的，所以此时要通过临时文件来实现上传文件的保存
            // 此方法是设置是否使用临时文件的临界值（单位：字节）
            factory.setSizeThreshold(maxMemorySize);
            // 与上一个结合使用，设置临时文件的路径（绝对路径）
            factory.setRepository(uploadTmpDirObj);

            // Create a new file upload handler
            ServletFileUpload upload = new ServletFileUpload(factory);

            // 解决上传文件名的中文乱码,tomcat8不需要了
            // upload.setHeaderEncoding("UTF-8");

            // 设置上传内容的大小限制（单位：字节）
            upload.setSizeMax(maxRequestSize);

            // Parse the request
            List<FileItem> items = upload.parseRequest(request);
            Iterator<?> iter = items.iterator();
            String fieldName = null;
            FileItem item = null;
            String fileName = null;
            String version = null;
            while (iter.hasNext()) {
                item = (FileItem) iter.next();
                fieldName = item.getFieldName();
                if (item.isFormField()) {// 普通表单字段，版本信息
                    version = item.getString();
                    System.out.println(fieldName + " " + version);
                } else {// 文件字段
                    fileName = item.getName();
                    if (!fileName.endsWith("apk")) {// 不是apk文件
                        System.out.println("不是apk文件");
                        return;
                    }
                    fileName = fileName.substring(fileName.lastIndexOf("\") + 1);
                    String contentType = item.getContentType();
                    boolean isInMemory = item.isInMemory();
                    long sizeInBytes = item.getSize();
                    System.out.println(fileName + " " + contentType + " " + isInMemory + " " + sizeInBytes);
                    item.write(new File(uploadDirObj, fileName));
                }
            }
            apkInfoMapper.insertVersionInfo(version,
                    new SimpleDateFormat("yy-MM-dd HH:mm:ss").format(System.currentTimeMillis()),
                    (uploadRelativeDir + fileName));
        } catch (Exception e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }

　注：

　为保证服务器安全，如果文件不提供下载，上传文件应该放在外界无法直接访问的目录下，如WEB-INF目录下；

　不同的浏览器提交的文件名是不一样的，有些浏览器提交上来的文件名是带有路径的，而有些只是单纯的文件名，要处理获取到的上传文件的文件名的路径部分，只保留文件名部分；

　为防止文件覆盖的现象发生，要为上传文件产生一个唯一的文件名

 四、扩展：利用SpringMVC实现单文件/多文件上传下载

package com.mucfc;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.URLEncoder;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.UUID;

import javax.servlet.ServletContext;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;
import org.springframework.web.multipart.MultipartHttpServletRequest;
import org.springframework.web.multipart.commons.CommonsMultipartFile;
import org.springframework.web.multipart.commons.CommonsMultipartResolver;

@Controller
@RequestMapping("/file")
public class FileController {

    @RequestMapping("/toFile")
    public String toFileUpload() {
        return "fileUpload";
    }

    @RequestMapping("/toFile2")
    public String toFileUpload2() {
        return "fileUpload2";
    }

    /**
     * 方法一上传文件
     */
    @RequestMapping("/onefile")
    public String oneFileUpload(@RequestParam("file") CommonsMultipartFile file, HttpServletRequest request,
            ModelMap model) {

        // 获得原始文件名
        String fileName = file.getOriginalFilename();
        System.out.println("原始文件名:" + fileName);

        // 新文件名
        String newFileName = UUID.randomUUID() + fileName;

        // 获得项目的路径
        ServletContext sc = request.getSession().getServletContext();
        // 上传位置
        String path = request.getRealPath("/img") + "/"; // 设定文件保存的目录

        File f = new File(path);
        if (!f.exists())
            f.mkdirs();
        if (!file.isEmpty()) {
            try {
                FileOutputStream fos = new FileOutputStream(path + newFileName);
                InputStream in = file.getInputStream();
                int b = 0;
                while ((b = in.read()) != -1) {
                    fos.write(b);
                }
                fos.close();
                in.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }

        System.out.println("上传图片到:" + path + newFileName);
        // 保存文件地址，用于JSP页面回显
        model.addAttribute("fileUrl", "img/" + newFileName);
        return "fileUpload";
    }

    /**
     * 方法二上传文件，一次一张
     */
    @RequestMapping("/onefile2")
    public String oneFileUpload2(HttpServletRequest request, HttpServletResponse response) throws Exception {
        CommonsMultipartResolver cmr = new CommonsMultipartResolver(request.getServletContext());
        if (cmr.isMultipart(request)) {
            MultipartHttpServletRequest mRequest = (MultipartHttpServletRequest) (request);
            Iterator<String> files = mRequest.getFileNames();
            while (files.hasNext()) {
                MultipartFile mFile = mRequest.getFile(files.next());
                if (mFile != null) {
                    String fileName = UUID.randomUUID() + mFile.getOriginalFilename();
                    String path = request.getRealPath("") + "/img/" + fileName;
                    System.out.println(path);
                    File localFile = new File(path);
                    if (!localFile.exists()) {
                        localFile.createNewFile();
                    }
                    mFile.transferTo(localFile);
                    request.setAttribute("fileUrl", "img/" + fileName);
                }
            }
        }
        return "fileUpload";
    }

    /**
     * 一次上传多张图片
     */
    @RequestMapping("/threeFile")
    public String threeFileUpload(@RequestParam("file") CommonsMultipartFile files[], HttpServletRequest request,
            ModelMap model) {

        List<String> list = new ArrayList<String>();
        // 获得项目的路径
        ServletContext sc = request.getSession().getServletContext();
        // 上传位置
        String path = sc.getRealPath("/img") + "/"; // 设定文件保存的目录
        File f = new File(path);
        if (!f.exists())
            f.mkdirs();

        for (int i = 0; i < files.length; i++) {
            // 获得原始文件名
            String fileName = files[i].getOriginalFilename();
            System.out.println("原始文件名:" + fileName);
            // 新文件名
            String newFileName = UUID.randomUUID() + fileName;
            if (!files[i].isEmpty()) {
                try {
                    FileOutputStream fos = new FileOutputStream(path + newFileName);
                    InputStream in = files[i].getInputStream();
                    int b = 0;
                    while ((b = in.read()) != -1) {
                        fos.write(b);
                    }
                    fos.close();
                    in.close();
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
            System.out.println("上传图片到:" + path + newFileName);
            list.add("img/" + newFileName);

        }
        // 保存文件地址，用于JSP页面回显
        model.addAttribute("fileList", list);
        return "fileUpload2";

    }

    /**
     * 列出所有的图片
     */
    @RequestMapping("/listFile")
    public String listFile(HttpServletRequest request, HttpServletResponse response) {
        // 获取上传文件的目录
        ServletContext sc = request.getSession().getServletContext();
        // 上传位置
        String uploadFilePath = sc.getRealPath("/img") + "/"; // 设定文件保存的目录
        // 存储要下载的文件名
        Map<String, String> fileNameMap = new HashMap<String, String>();
        // 递归遍历filepath目录下的所有文件和目录，将文件的文件名存储到map集合中
        listfile(new File(uploadFilePath), fileNameMap);// File既可以代表一个文件也可以代表一个目录
        // 将Map集合发送到listfile.jsp页面进行显示
        request.setAttribute("fileNameMap", fileNameMap);
        return "listFile";
    }

    public void listfile(File file, Map<String, String> map) {
        // 如果file代表的不是一个文件，而是一个目录
        if (!file.isFile()) {
            // 列出该目录下的所有文件和目录
            File files[] = file.listFiles();
            // 遍历files[]数组
            for (File f : files) {
                // 递归
                listfile(f, map);
            }
        } else {
            /**
             * 处理文件名，上传后的文件是以uuid_文件名的形式去重新命名的，去除文件名的uuid_部分
             * file.getName().indexOf
             * ("_")检索字符串中第一次出现"_"字符的位置，如果文件名类似于：9349249849-88343-8344_阿_凡_达.avi
             * 那么file.getName().substring(file.getName().indexOf("_")+1)
             * 处理之后就可以得到
             */
            String realName = file.getName().substring(file.getName().indexOf("_") + 1);
            // file.getName()得到的是文件的原始名称，这个名称是唯一的，因此可以作为key，realName是处理过后的名称，有可能会重复
            map.put(file.getName(), realName);
        }
    }

    @RequestMapping("/downFile")
    public void downFile(HttpServletRequest request, HttpServletResponse response) {
        System.out.println("1");
        // 得到要下载的文件名
        String fileName = request.getParameter("filename");
        System.out.println("2");
        try {
            fileName = new String(fileName.getBytes("iso8859-1"), "UTF-8");
            System.out.println("3");
            // 获取上传文件的目录
            ServletContext sc = request.getSession().getServletContext();
            System.out.println("4");
            // 上传位置
            String fileSaveRootPath = sc.getRealPath("/img");

            System.out.println(fileSaveRootPath + "\" + fileName);
            // 得到要下载的文件
            File file = new File(fileSaveRootPath + "\" + fileName);

            // 如果文件不存在
            if (!file.exists()) {
                request.setAttribute("message", "您要下载的资源已被删除！！");
                System.out.println("您要下载的资源已被删除！！");
                return;
            }
            // 处理文件名
            String realname = fileName.substring(fileName.indexOf("_") + 1);
            // 设置响应头，控制浏览器下载该文件
            response.setHeader("content-disposition", "attachment;filename=" + URLEncoder.encode(realname, "UTF-8"));
            // 读取要下载的文件，保存到文件输入流
            FileInputStream in = new FileInputStream(fileSaveRootPath + "\" + fileName);
            // 创建输出流
            OutputStream out = response.getOutputStream();
            // 创建缓冲区
            byte buffer[] = new byte[1024];
            int len = 0;
            // 循环将输入流中的内容读取到缓冲区当中
            while ((len = in.read(buffer)) > 0) {
                // 输出缓冲区的内容到浏览器，实现文件下载
                out.write(buffer, 0, len);
            }
            // 关闭文件输入流
            in.close();
            // 关闭输出流
            out.close();
        } catch (Exception e) {

        }
    }
}

原理：Servlet或Spring（实际上也是依赖Servlet）将收到的文件持久化到默认的临时磁盘目录（用户也可以指定），代码中获取到的File对象即是存在该临时目录的文件对象

另外，关于HTTP POST提交数据的三种常用方式（application/x-www-form-urlencoded、multipart/form-data、application/json）的区别可参阅：https://imququ.com/post/four-ways-to-post-data-in-http.html

五、Spring文件上传

两种方法：

法1：通过@RequestParameter

法2：通过@RequestPart

两种都是用来接收multipart/form-data请求传来的数据，区别：前者可以同时接收文件（multipart）域和普通键值对参数，而后者可以同时接收文件域和更复杂的对象（如json、xml等）。

可参阅：https://stackoverflow.com/questions/16230291/requestpart-with-mixed-multipart-request-spring-mvc-3-2