JavaWeb文件上传

文件上传对页面的要求

• 1、必须使用表单，不能使用超链接；
• 2、表单的method必须是POST,不能是GET；
• 3、表单的enctype必须为multipart/form-data;
• 4、在表单中添加file表单字段，即<input type="file" name=""……>

例如：

<form action="<c:url value='/UploadServlet'/>" method="post" enctype="multipart/form-data">
    名称：<input type="text" name="username"/><br/>
    文件：<input type="file" name="image"/>
    <input type="submit" value="上传"/>
</form>

文件表单（多部件表单体）概述

例如上面的jsp表单包含两个表单项，一个表单项一个部件

一个部件中包含自己的请求头和空行，以及请求体。

普通表单：

> 1个头：Content-Disposition：包含name="xxxx"，即表单项名称。
  > 体就是表单项的值

文件表单：

> 2个头：
    * Content-Disposition：包含name="xxxx"，即表单项名称；还有一个filename="xxx"，表示上传文件的名称
    * Content-Type：它是上传文件的MIME类型，例如：image/pjpeg，表示上传的是图片，图上中jpg扩展名的图片。
  > 体就是上传文件的内容。

盗用教程给的图例

文件上传对servlet的要求

request.getParametere("xxx");这个方法在表单为enctype="multipart/form-data"时，它作废了。它永远都返回null

对于文件表单，可以使用request.getInputStream()方法获取ServletInputStream对象，这个ServletInputStream对象对应整个表单的正文部分（从第一个分隔线开始，到最后）。我们自己解析太麻烦。apache为我们提供了commons-fileupload解析工具

 

commons-fileupload解析工具使用

需要jar包

1. commons-fileupload.jar，核心包；
2. commons-io.jar，依赖包。

使用方法

相关类：

• 工厂：DiskFileItemFactory
• 解析器：ServletFileUpload
• 表单项：FileItem

三步骤：

1. 创建工厂：DiskFileItemFactory factory = new DiskFileItemFactory();
2. 创建解析器：ServletFileUpload sfu = new ServletFileUpload(factory);
3. 使用解析器来解析request，得到FileItem集合：List<FileItem> fileItemList = sfu.parseRequest(request);

fileupload工具会解析request，把表单数据封装到一个list<FileItem>中，每一个FileItem中封装一个表单项。

FileItem包含的方法

• boolean isFormField()：是否为普通表单项！返回true为普通表单项，如果为false即文件表单项！
• String getFieldName()：返回当前表单项的名称；
• String getString(String charset)：返回表单项的值；
• String getName()：返回上传的文件名称
• long getSize()：返回上传文件的字节数
• InputStream getInputStream()：返回上传文件对应的输入流
• void write(File destFile)：把上传的文件内容保存到指定的文件中。
• String getContentType();

servlet处理类：UploadServlet.java

@WebServlet(name = "/UploadServlet",urlPatterns = "/UploadServlet")
public class UploadServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        request.setCharacterEncoding("utf-8");
        response.setContentType("text/html;charset=utf-8");
        

        //创建工厂
        DiskFileItemFactory factory=new DiskFileItemFactory();
        //创建解析器
        ServletFileUpload sfu=new ServletFileUpload(factory);
        //使用解析器来解析request
        try {
            List<FileItem> fileItemList = sfu.parseRequest(request);
            //普通表单
            FileItem fileItem1=fileItemList.get(0);
            //文件表单
            FileItem fileItem2=fileItemList.get(1);
            
            //输出到客户端
            response.getWriter().println("表单项名："+fileItem1.getFieldName()+","
                    +"表单类型："+fileItem1.getContentType()+","
                    +"表单名"+fileItem1.getName()+"<br/>");

            response.getWriter().println("表单项名："+fileItem1.getFieldName()+","+
                            "文件名:"+fileItem2.getName()+","+
                    fileItem2.getSize()+","+fileItem2.getContentType()+"<br/>");

            //保存为G:/java.jpg
            fileItem2.write(new File("G:/java.jpg"));
        } catch (FileUploadException e) {
            e.printStackTrace();
        } catch (Exception e) {
            e.printStackTrace();
        }


    }

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

    }
}

 

上传细节

上传文件必须保存到WEB-INF下：

不让浏览器访问到（防止一些恶意上传一些jsp页面，操作服务器）

文件命名问题：

有些浏览器上传文件名是绝对路径，需要切割

//处理文件名为绝对路径问题：G:\develop\c\file.xxx
int index=fileName.lastIndexOf("//");//获取最后一个\的下标，如果不存在返回-1
if (index!=-1) {
    //取文件名的真正名字
    fileName=fileName.substring(index+1);
}

文件名乱码或普通表单乱码，两种方式可以解决

> request.setCharacterEncoding("utf-8");//优先级低
> servletFileUpload.setHeaderEncoding("utf-8");//优先级高

文件同名问题：为每个文件名称前加一个uuid

> filename = CommonUtils.uuid() + "_" + filename;

文件目录打散

不能在一个目录下放太多文件，否则打开打开文件夹很慢

> 首字符打散：使用文件的首字母做为目录名称，例如：abc.txt，那么我们把文件保存到a目录下。如果a目录这时不存在，那么创建之。（文件夹太少）
> 时间打散：使用当前日期做为目录。（文件夹太多）
> 哈希打散：（推荐）
      * 通过文件名称得到int值，即调用hashCode()
      * 它int值转换成16进制0~9, A~F
      * 获取16进制的前两位用来生成目录，目录为二层！例如：1B2C3D4E5F，/1/B/保存文件。

//哈希打散目录代码        
        //创建工厂
        DiskFileItemFactory factory=new DiskFileItemFactory();
        //创建解析器
        ServletFileUpload sfu=new ServletFileUpload(factory);
        
        try {
            //用解析器来解析request，并得到文件项列表
            List<FileItem> fileItemList = sfu.parseRequest(request);
            //得到文件项
            FileItem fileItem1=fileItemList.get(1);

            /**
             * 采用两级目录，将文件存储在WEB-INF目录下的files下：
             * 1、获取文件名，处理绝对路径问题，并添加uuid
             * 2、通过hashcode()方法得到文件名对应的int值，并转化成十六进制
             * 3、获取/WEB-INF/files目录路径，并添加十六进制的前两位到目录链中，创建目录
             * 4、保存文件到该目录中
             */
            String fileName=fileItem1.getName();

            //处理文件名为绝对路径问题：G:\develop\c\file.xxx
            int index=fileName.lastIndexOf("//");//获取最后一个\的下标，如果不存在返回-1
            if (index!=-1) {
                //取文件名的真正名字
                fileName=fileName.substring(index+1);
            }

            //处理重名问题：添加uuid
            String saveName=CommonUtils.uuid()+"_"+fileName;

            //获取文件名hashcode()
            int hasd=saveName.hashCode();

            //将文件名hashcode转化成十六进制
            String hex=Integer.toHexString(hasd);

            //获取/WEB-INF/files路径
            String root=request.getServletContext().getRealPath("/WEB-INF/files");

            //将文件十六进制的前两位添加到目录链中
            File dirFile=new File(root+"/"+hex.charAt(0)+"/"+hex.charAt(1));

            //创建目录链，如果目录不存在就创建，如果存在就不操作
            dirFile.mkdirs();


            //创建目录文件
            File destFile=new File(dirFile,saveName);
            //保存目录
            fileItem1.write(destFile);

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

文件上传大小限制

单个文件限制

> sfu.setFileSizeMax(100*1024)：限制单个文件大小为100KB
    > 上面的方法调用，必须在解析开始之前调用！
    > 如果上传的文件超出限制，在parseRequest()方法执行时，会抛出异常！FileUploadBase.FileSizeLimitExceededException
整个请求所有数据大小限制
    > sfu.setSizeMax(1024 * 1024);//限制整个表单大小为1M
    > 这个方法也是必须在parseRequest()方法之前调用
    > 如果上传的文件超出限制，在parseRequest()方法执行时，会抛出异常！FileUploadBase.SizeLimitExceededException

 缓存大小与临时目录

缓存大小：超出多大，才向硬盘保存！默认为10KB
临时目录：向硬盘的什么目录保存。设置缓存大小与临时目录：new DiskFileItemFactory(20*1024, new File("G:/temp"))

 

Servlet3.0中自带处理上传

使用Servlet3.0上传文件时，可以使用注解：@MultipartConfig 

Servet3.0提供了：javax.servlet.http.Part类来处理上传文件

在jsp中的表单要求和上面不变

在servlet中getParameter()方法可以正常使用

使用request.getPart("字段名")，得到Part实例

• String getContentType()：获取上传文件的MIME类型
• String getName()：获取表单项的名称，不是文件名称
• String getHeader(String header)：获取指定头的值
• long getSize()：获取上传文件的大小
• InputStream getInputStream()：获取上传文件的内容
• void write(String fileName)：把上传文件保存到指定路径下

实例代码：

<form action="<c:url value="/AServlet"/>" method="post" enctype="multipart/form-data">
    用户名：<input name="username" type="text"/>
    图  片：<input type="file" name="image"/>
    <input type="submit" value="提交"/>
</form>

@WebServlet(name = "AServlet",urlPatterns = "/AServlet")
@MultipartConfig
public class AServlet extends HttpServlet {

    public void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        //设置编码
        request.setCharacterEncoding("utf-8");
        response.setContentType("text/html;charset=utf-8");

        //获取普通表单项参数
        String username=request.getParameter("username");

        //获取文件表单项参数
        Part part=request.getPart("image");
        System.out.println(part.getName());//表单项名称
        System.out.println(part.getContentType());//文件类型
        System.out.println(part.getHeader("Content-Disposition"));//获取头
        System.out.println(part.getSize());//文件大小

    }
}

输出：

image
image/png
form-data; name="image"; filename="捕获.PNG"
48242

Part方法中没有获取上传文件名的功能，这里可以从内容头中获取

String fileName=part.getHeader("Content-Disposition");
int start=fileName.lastIndexOf("filename=\"")+10;
int end=fileName.length()-1;
System.out.println(fileName.substring(start,end));

 

验证代码（csdn）