文件上传-FileUpload

文件上传即从本地磁盘文件中通过IO写入服务器的操作。一般存在一下几种方法完成，例如：Servlet3.0，JSPSmartUpload，FileUpload，框架。本篇章主要介绍FileUpload。

文件上传的三要素

• 表单的提交方式必须为POST；
• 表单的文件上传表单项中必须有name属性，例如：<input type="file" name="upload"/>
• 表单的enctype属性的值必须是multipart/form-data

enctype为表单提交时所采取的传输编码方式，默认为application/x-www-form-urlencode，在默认情况下对于上传的文件只能获取一个文件名。为了能够传输文件内容就需要采用multipart/form-data，此时提交表单后请求体中会对文件进行解析，若为其他属性直接获取它的值，不同的属性会以分割线分割，具体可看一下示例。

在使用默认方式提交表单时，只能显示文件名称

使用multipart/form-data时，可以看到请求头中的Content-Type中的方式改为了multipart/form-data，并描述了分隔符（boundary），结果如下：

FileUpload的功能创建

FileUpload是Apache提供的开源框架，需要在项目中导入jar包。

核心类：

• DiskFileItemFactory：磁盘文件项工厂，是文件上传的核心类，其他操作都依靠该对象进行
• ServletFileUpload：服务解析类，用于解析Servlet服务中的request请求，可以调用该类的方法parseRequest(HttpServletRequest request)解析请求中的参数，返回一个List集合类型为FileItem
• FileItem：请求参数的实体类，用于存放参数。可以调用getString(String encoding)方法获取普通属性的值，getName()获取属性的名称。对于文件参数可以通过isFormField()方法判断，返回为true为普通属性，false为文件属性。FileItem类提供了获取文件输入流的方法getInputStream()用于文件IO操作。

其他具体方法可参考FileUpload API

示例：

package com.fileupload;

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

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.List;

@WebServlet("/uploadServlet")
public class UploadServlet extends HttpServlet {
    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        req.setCharacterEncoding("utf-8");
        // 创建磁盘项目工厂
        DiskFileItemFactory diskFileItemFactory = new DiskFileItemFactory();

        // 创建解析类
        ServletFileUpload servletFileUpload = new ServletFileUpload(diskFileItemFactory);

        try {
            // 获取请求中的属性
            List<FileItem> list = servletFileUpload.parseRequest(req);

            // 循环遍历属性中的值
            for (FileItem fileItem : list) {
                // 判断是否为文件属性
                if (fileItem.isFormField()) {
                    String name = fileItem.getFieldName();
                    String value = fileItem.getString();

                    System.out.println(name + "-" + value);
                } else {
                    // 获取文件的文件名
                    String fileName = fileItem.getName();
                    // 获取文件大小
                    long fileSize = fileItem.getSize();

                    System.out.println("文件名为" + fileName + ",文件大小为" + fileSize);

                    // 获取文件的输入流
                    InputStream inputStream = fileItem.getInputStream();

                    // 创建存放文件的路径
                    String path = getServletContext().getRealPath("/upload");
                    System.out.println(path);

                    // 创建输出流
                    OutputStream outputStream = new FileOutputStream(path + "\\" + fileName);
                    int len = 0;
                    byte[] bytes = new byte[1024];
                    while ((len = inputStream.read(bytes)) != -1) {
                    	// 输出流写入文件
                        outputStream.write(bytes, 0, len);
                    }

                    // 关闭输入输出流
                    inputStream.close();
                    outputStream.close();

                    // 返回页面
                    resp.setContentType("text/html;charset=utf-8");
                    resp.getWriter().println("<img src='" + req.getContextPath() + "/upload/" + fileName + "' alt=''>");
                }
            }
        } catch (FileUploadException e) {
            e.printStackTrace();
        }
    }
}