java web文件上传——FileUpload

文件上传分析

1.普通表单提交默认enctype="application/x-www-form-urlencoded"；但是当表单中存在文件类型时，需要设置enctype="multipart/form-data"，它不对字符进行编码，用于发送二进制的文件（即所有文件类型，如视频、图片、音乐、文档都可以用此类型entype）；还有一种enctype="text/plain"用于发送纯文本内容。

2.表单请求方式必须为post。

3.接收时不能再用request.getParameter()，而是request.getInputStream()解析二进制流，得到ServletInputStream对象。

 

接下来我们来看看上传一个t文件接收到的二进制流转化为字符串是什么：

（1）表单提交页面:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>



    



    
    
    
    

（2）接收文件流UploadServlet:

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.IOException;
import java.io.InputStream;

@WebServlet("/UploadServlet")
public class UploadServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        //获取复杂表单的输入流
        InputStream in=request.getInputStream();

        //输入流转化为字符串
        byte[] b=new byte[1024];
        in.read(b);
        System.out.println(new String(b));
    }

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doPost(request,response);
    }
}

运行项目：

（1）表单填写：

test.txt中的内容是：

hello world
好好学习，天天向上

（2）点击提交，运行结果：

------WebKitFormBoundaryzRSPAU9UKnMzdAUZ
Content-Disposition: form-data; name="username"

hello 灏忛奔
------WebKitFormBoundaryzRSPAU9UKnMzdAUZ
Content-Disposition: form-data; name="pwd"

12345
------WebKitFormBoundaryzRSPAU9UKnMzdAUZ
Content-Disposition: form-data; name="pic"; filename="test.txt"
Content-Type: text/plain

锘縣ello world
濂藉ソ瀛︿範锛屽ぉ澶╁悜涓?

------WebKitFormBoundaryzRSPAU9UKnMzdAUZ--

分析：------WebKitFormBoundaryzRSPAU9UKnMzdAUZ--是分隔符，用于分隔表单的每一个字段。运行结果中有中文乱码后续会处理。将二进制流转化为字符串除了上面用的read()方法，还可以用org.apache.commons.io.IOUtils.toString(in)，不过要导入jar包。

 

FileUpload文件上传

1.FileUpload分析

fileUpload是apache的commons组件提供的上传组件，它最主要的工作就是帮我们解析request.getInpustream()。可以参考在线API文档：http://tool.oschina.net/apidocs/apidoc?api=commons-fileupload

使用fileUpload组件首先需要引入两个jar包：

• commons-fileUpload.jar
• commons-io.jar

fileUpload的核心类有DiskFileItemFactory、ServletFileUpload、FileItem。

使用fileUpload固定步骤：

1. 创建工厂类：DiskFileItemFactory factory=new DiskFileItemFactory();
2. 创建解析器：ServletFileUpload upload=new ServletFileUpload(factory);
3. 使用解析器解析request对象：List list=upload.parseRequest(request);

一个FileItem对象对应一个表单项。FileItem类有如下方法：

• String getFieldName()：获取表单项的name的属性值。
• String getName()：获取文件字段的文件名。如果是普通字段，则返回null
• String getString()：获取字段的内容。如果是普通字段，则是它的value值；如果是文件字段，则是文件内容。
• String getContentType()：获取上传的文件类型，例如text/plain、image。如果是普通字段，则返回null。
• long getSize()：获取字段内容的大小，单位是字节。
• boolean isFormField()：判断是否是普通表单字段，若是，返回true，否则返回false。
• InputStream getInputStream()：获得文件内容的输入流。如果是普通字段，则返回value值的输入流。

 

表单提交页面同上，修改UploadServlet的代码如下：

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 sun.misc.IOUtils;

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.IOException;
import java.io.InputStream;
import java.util.List;

@WebServlet("/UploadServlet")
public class UploadServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        DiskFileItemFactory factory=new DiskFileItemFactory();
        ServletFileUpload upload=new ServletFileUpload(factory);
        try {
            List list=upload.parseRequest(request);
            for (FileItem fileItem:list){
                System.out.println("fieldName:"+fileItem.getFieldName());
                System.out.println("name:"+fileItem.getName());
                System.out.println("string:"+fileItem.getString());
                System.out.println("contentType:"+fileItem.getContentType());
                System.out.println("size:"+fileItem.getSize()+"byte");
                System.out.println("isFieldForm:"+fileItem.isFormField());
                System.out.println("inputStream:"+ org.apache.commons.io.IOUtils.toString(fileItem.getInputStream()));
                System.out.println("*************");
            }
        } catch (FileUploadException e) {
            e.printStackTrace();
        }
    }

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doPost(request,response);
    }
}

运行结果：

（1）填写表单：

（2）test.txt同上，点击提交结果：

fieldName:username
name:null
string:hello ?°?é±?
contentType:null
size:12byte
isFieldForm:true
inputStream:hello 灏忛奔
*************
fieldName:pwd
name:null
string:12345
contentType:null
size:5byte
isFieldForm:true
inputStream:12345
*************
fieldName:pic
name:test.txt
string:???hello world
???????????? ?¤??¤???????

contentType:text/plain
size:43byte
isFieldForm:false
inputStream:锘縣ello world
濂藉ソ瀛︿範 澶╁ぉ鍚戜笂

*************

2.FileUpload实现文件上传

使用fileUpload组件实现文件上传除了上面的那些方法之外还要注意的：

1. 文件名中文乱码处理：servletFileUpload.setHeaderEncoding("utf-8") 或 request.setCharacterEncoding("utf-8");
2. 表单普通字段中文乱码处理：new String(str.getBytes("iso-8859-1","utf-8"));
3. 设置内存缓冲区的大小，默认为10KB：diskFileItemFactory.setSizeThreshold(1024*1024);
4. 指定临时文件目录，如果单个文件的大小超过内存缓冲区，该文件将会临时缓存在此目录下：diskFileItemFactory.setRepository(file);
5. 设置单个文件大小限制，如果有某个文件超过此大小，将抛出FileUploadBase.FileSizeLimitExceededException：servletFileUpload.setFileSizeMax(1024*1024*10);
6. 设置所有文件，也就是请求大小限制，如果文件总和超过此大小，将抛出FileUploadBase.SizeLimitExceededException：servletFileUpload.setSizeMax(1024*1024*20);
7. 利用UUID生成伪随机字符串作为文件名避免重复：UUID.randomUUID().toString();
8. 将文件写到硬盘上。写完之后，系统会自动将放在临时文件目录的该文件删除：fileItem.write(new File(path,fileName));

注：如果没有指定临时文件目录，默认采用系统默认的临时文件路径，可以通过System.getProperty("java.io.tmpdir")获取，Tomcat系统默认临时目录为“/temp/”。

Apache文件上传组件在解析上传数据中的每个字段内容时，需要临时保存解析出的数据，以便在后面进行数据的进一步处理（保存在磁盘特定位置或插入数据库）。因为Java虚拟机默认可以使用的内存空间是有限的，超出限制时将会抛出“java.lang.OutOfMemoryError”错误。如果上传的文件很大，例如800M的文件，在内存中将无法临时保存该文件内容，Apache文件上传组件转而采用临时文件来保存这些数据；但如果上传的文件很小,例如600个字节的文件,显然将其直接保存在内存中性能会更加好些。

 

表单提交页面不变，UploadServlet代码如下：

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadBase;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import sun.misc.IOUtils;

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.File;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
import java.util.UUID;

@WebServlet("/UploadServlet")
public class UploadServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        DiskFileItemFactory factory=new DiskFileItemFactory();
        ServletFileUpload upload=new ServletFileUpload(factory);

        request.setCharacterEncoding("utf-8");
        //文件名中文乱码处理也可以如此写
//        upload.setHeaderEncoding("utf-8");

        //设置缓冲区大小与临时文件目录
        factory.setSizeThreshold(1024*1024*10);
        File uploadTemp=new File("e:\\uploadTemp");
        uploadTemp.mkdirs();
        factory.setRepository(uploadTemp);

        //设置单个文件大小限制
        upload.setFileSizeMax(1024*1024*10);
        //设置所有文件总和大小限制
        upload.setSizeMax(1024*1024*30);

        try {
            List list=upload.parseRequest(request);
            System.out.println(list);
            for (FileItem fileItem:list){
                if (!fileItem.isFormField()&&fileItem.getName()!=null&&!"".equals(fileItem.getName())){
                    String filName=fileItem.getName();
                    //利用UUID生成伪随机字符串，作为文件名避免重复
                    String uuid= UUID.randomUUID().toString();
                    //获取文件后缀名
                    String suffix=filName.substring(filName.lastIndexOf("."));

                    //获取文件上传目录路径，在项目部署路径下的upload目录里。若想让浏览器不能直接访问到图片，可以放在WEB-INF下
                    String uploadPath=request.getSession().getServletContext().getRealPath("/upload");

                    File file=new File(uploadPath);
                    file.mkdirs();
                    //写入文件到磁盘，该行执行完毕后，若有该临时文件，将会自动删除
                    fileItem.write(new File(uploadPath,uuid+suffix));
                    
                }
            }
        }  catch (Exception e) {
            e.printStackTrace();
        }
    }

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doPost(request,response);
    }
}

参考博客：https://blog.csdn.net/fsdadsadas/article/details/73162677

                  https://www.cnblogs.com/lxboy2009/p/5994743.html