Java Web之上传文件

　　本篇文章你会学到

　　1. Apache FileUpload组件

　　2.上传文件保存的路径和名称问题

　　3.缓存大小和临时目录

　　4.控制文件上传的格式

　　先讲一个简单的例子，一个注册页面，有账号，邮箱，和头像这三个，JSP代码如下：

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

<html>

<head>

    <title>文件上传</title>

</head>

<body>

<h3>文件上传</h3>

<form action="/upload" method="post">

    账号：<input type="text" name="username"/><br>

    邮箱：<input type="email" name="email"><br>

    头像：<input type="file" name="headimg"><br>

    <input type="submit" value="注册">

</form>

</body>

</html>

然后我们的浏览器是这样的

我现在输入账号，邮箱和选择一张图片，用Servlet来接收，看看我的Servlet代码

package main.com.vae.Upload;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.util.List;

@WebServlet("/upload")

public class UploadServlet extends HttpServlet {

    @Override

    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {

        req.setCharacterEncoding("utf-8");

        String name=req.getParameter("username");

        String email=req.getParameter("email");

        String headimg=req.getParameter("headimg");

        System.out.println(name + email + headimg);

    }

}

你会发现，账号，邮箱都是对的，但是头像这个获取的是图片的名字，而不是一个图片。

所以我们的解决办法是使用二进制流的形式传输过来，这样就可以获取图片的二进制流文件了，我们需要在form表单加一个东西

这个就是说让表单以二进制流的形式传输内容。加了这个之后，我们再次去执行一下注册，发现获取的参数全部变成null了

这个说明了一个问题：

req.getParameter 无法获取二进制流的文件

不用二进制流，req.getParameter只能获取图片的名称，使用二进制流，req.getParameter又不能获取二进制流格式的文件，那怎么办呢？很简单，答案是不使用req.getParameter

Apache FileUpload组件

引入正题，我们使用Apache的FileUpload组件来做文件上传的处理，首先你要下载这个组件，我直接在maven仓库里面搜了一下，然后放到maven里面获取了

我们的JSP不需要改什么，我们的Servlet这样写：

package main.com.vae.Upload;

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.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.util.List;

@WebServlet("/upload")

public class UploadServlet extends HttpServlet {

    @Override

    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {

        req.setCharacterEncoding("utf-8");

        String name=req.getParameter("username");

        String email=req.getParameter("email");

        String headimg=req.getParameter("headimg");

        System.out.println(name + email + headimg);

        //解析和检查请求，是否是post方式，是否是二进制流格式

        Boolean isMultipart=ServletFileUpload.isMultipartContent(req);

        if (!isMultipart) {

            return; //如果不是就不用上传了

        }

        try {

            //创建FileItemFactory对象

            FileItemFactory factory=new DiskFileItemFactory();

            //创建文件上传的处理器

            ServletFileUpload upload=new ServletFileUpload(factory);

            //解析请求

            List<FileItem> items=upload.parseRequest(req);

            //迭代出每一个FileItem

            for (FileItem item : items) {

                String fileName = item.getFieldName();

                if (item.isFormField()) {

                    //普通的表单控件

                    String value = item.getString("utf-8");

                    System.out.println(fileName + "->" + value);

                } else {

                    //上传文件的控件

                    System.out.println(fileName + "->" + item.getName()); //一个的标签的name，一个是文件的name

                    item.write(new File("E:/", item.getName())); //把上传的文件保存到某个文件中

                }

            }

            }

            catch (Exception e){

            e.printStackTrace();

        }

    }

}

大概就是这样，测试之后是ok的

上面就已经实现了文件上传的功能了，但是有几个问题需要修正一下

1.我获取的文件名是图片的名字，IE6获取的文件名是加绝对路径的图片名称。这是第一个问题，浏览器版本问题。

2.文件保存名称问题，例如我上传的图片是小女孩.jpg 我现在又上传了一个另外的小女孩图片名还是小女孩.jpg 虽然两张图片的内容不一样，但是会覆盖。

3.文件保存路径问题，我不可能保存文件在一个写死的路径E盘吧。

1.获取文件名的浏览器版本问题

解决办法：Apache FileUpload为我们提供了3个方法，我们使用第一个就行，只获取文件的名称

 String parh="c:/vae/piecture/小女孩.jpg";

 //1.获取文件名称,获取的是 小女孩.jpg

 FilenameUtils.getName(parh);

 //2.获取文件的名称，但是不包括拓展名 获取的是 小女孩

 FilenameUtils.getBaseName(parh);

 //3.获取文件的拓展名 获取的是jpg

 FilenameUtils.getExtension(parh);

2.文件保存名称问题

解决办法：使用UUID通用唯一识别码，这个UUID貌似可以创建不相同的ID出来

 String RandomName = UUID.randomUUID().toString()+"."+FilenameUtils.getExtension(item.getName());

但是我有一个问题啊，我的头像或者其他文件，采用了UUID之后，是名字不会重复了，也不会覆盖文件了。但是我读取的时候怎么找？我怎么知道一大堆UUID文件里面哪个是我的头像？

这个地方存疑。

3.文件保存路径问题

在做项目的时候，肯定不会指定保存到E盘，C盘什么的，肯定是保存在这个项目里面的某个文件夹的

我们在这里会使用Servlet的getServletContext().getRealPath这个方法来获取一个路径，然后保存在upload文件夹下面，这个问题我们要想清楚，必须先明白我们Java Web项目的目录结构

具体的看我这篇文章：Java Web的项目目录结构

以下是更新过的代码：

package com.vae.Upload;

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 org.apache.commons.io.FilenameUtils;

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.util.List;

import java.util.UUID;

@WebServlet("/upload")

public class UploadServlet extends HttpServlet {

    @Override

    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {

        req.setCharacterEncoding("utf-8");

        String name=req.getParameter("username");

        String email=req.getParameter("email");

        String headimg=req.getParameter("headimg");

        System.out.println(name + email + headimg);

        //解析和检查请求，是否是post方式，是否是二进制流格式

        Boolean isMultipart=ServletFileUpload.isMultipartContent(req);

        if (!isMultipart) {

            return; //如果不是就不用上传了

        }

        try {

            //创建FileItemFactory对象

            FileItemFactory factory=new DiskFileItemFactory();

            //创建文件上传的处理器

            ServletFileUpload upload=new ServletFileUpload(factory);

            //解析请求

            List<FileItem> items=upload.parseRequest(req);

            //迭代出每一个FileItem

            for (FileItem item : items) {

                String fileName = item.getFieldName();

                if (item.isFormField()) {

                    //普通的表单控件

                    String value = item.getString("utf-8");

                    System.out.println(fileName + "->" + value);

                } else {

                    //上传文件的控件

                    String RandomName = UUID.randomUUID().toString()+"."+FilenameUtils.getExtension(item.getName());

                    System.out.println(fileName + "->" + FilenameUtils.getName(item.getName())); //一个的标签的name，一个是文件的name

                    String path=super.getServletContext().getRealPath("/upload");

                    System.out.println(path);

                    item.write(new File(path, RandomName)); //把上传的文件保存到某个文件中

                }

            }

            }

            catch (Exception e) {

                e.printStackTrace();

            }

    }

}

我们可以看到，我们把图片保存的路径是upload文件夹，我的项目结构是这样的

最后，介绍一下缓存

缓存大小和临时目录

我们在上传文件的时候，有一个缓存大小的设置的，如果缓存小于10kb的话，会直接加载进内存，如果缓存大于10kb的话，会存到临时目录里面，等待着下一步存进某个路径的操作。

我们看一下怎么设置缓存的大小和临时目录。不要修改临时目录，没必要

            //创建FileItemFactory对象

            FileItemFactory factory=new DiskFileItemFactory();

            //设置缓存区大小,默认大小是10kb，

            ((DiskFileItemFactory) factory).setSizeThreshold(20*1024);

            //设置临时目录，默认是Tomcat下的temp，不建议设置

            //((DiskFileItemFactory) factory).setRepository(临时目录不建议修改);

怎么判断文件是否在内存中

System.out.println(item.isInMemory());//判断文件资源是否在内存中

临时目录默认的是Tomcat的temp文件夹，我们来看看我的文件夹里面是什么样的

可以看到，我上面上传的图片都在，只不过他们的后缀都变成了tmp，我修改一个后缀为png，打开看看，还是我的图片

控制文件的上传格式

思路是这样的，比如我限制为上传的文件格式必须是图片，我要先把图片的后缀名都列出来，然后获取我上传文件的后缀名，比较一下，如果不在图片后缀列表里面就返回给浏览器一个消息提示，然后结束方法。

思路是这样，具体看代码：

 //设置允许接收的文件的格式，我这里设置为只能是图片

    private static final String ALLWED_IMAGE_TYPE ="png,jpg,gif,jpeg";

 //----------------先获取上传文件的拓展名

String ext = FilenameUtils.getExtension(item.getName());

String [] allowedImagetype=ALLWED_IMAGE_TYPE.split(",");

//-----------------判断上传文件的拓展名在不在我设定的范围之内,不在的话提醒并且结束方法

if (!Arrays.asList(allowedImagetype).contains(ext)) {

req.setAttribute("errorMsg","你上传的不是图片，请重新上传");

req.getRequestDispatcher("/input.jsp").forward(req,resp);

return;

}

前端的JSP要接收一下消息

<span style="color: red">${errorMsg}</span>

看一下效果：

文件上传类抽取

因为文件上传这个类会经常的用到，所以最好抽取成一个类，这样的话可复用

首先我们新建一个类，叫FileUtil

package com.vae.Upload;

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 org.apache.commons.io.FilenameUtils;

import javax.servlet.http.HttpServletRequest;

import java.io.File;

import java.util.Arrays;

import java.util.List;

import java.util.UUID;

public class FileUtil {

    //设置允许接收的文件的格式，我这里设置为只能是图片

    private static final String ALLWED_IMAGE_TYPE ="png,jpg,gif,jpeg";

    public static void upload(HttpServletRequest req) {

        //解析和检查请求，是否是post方式，默认是二进制流格式

        Boolean isMultipart=ServletFileUpload.isMultipartContent(req);

        if (!isMultipart) {

            return; //如果不是就不用上传了

        }

        try {

            //创建FileItemFactory对象

            FileItemFactory factory=new DiskFileItemFactory();

            //设置缓存区大小,默认大小是10kb，

            ((DiskFileItemFactory) factory).setSizeThreshold(20*1024);

            //设置临时目录，默认是Tomcat下的temp，不建议设置

            //((DiskFileItemFactory) factory).setRepository(临时目录不建议修改);

            //创建文件上传的处理器

            ServletFileUpload upload=new ServletFileUpload(factory);

            //解析请求

            List<FileItem> items=upload.parseRequest(req);

            //迭代出每一个FileItem

            for (FileItem item : items) {

                String fileName = item.getFieldName();

                if (item.isFormField()) {

                    //普通的表单控件

                    String value = item.getString("utf-8");

                    System.out.println(fileName + "->" + value);

                } else {

                    //----------------先获取上传文件的拓展名

                    String ext = FilenameUtils.getExtension(item.getName());

                    String [] allowedImagetype=ALLWED_IMAGE_TYPE.split(",");

                    //-----------------判断上传文件的拓展名在不在我设定的范围之内,不在的话提醒并且结束方法

                    if (!Arrays.asList(allowedImagetype).contains(ext)) {

                        throw  new LogicException("你上传的不是图片，请重新上传图片");

                    }

                    //上传文件的控件

                    String RandomName = UUID.randomUUID().toString()+"."+FilenameUtils.getExtension(item.getName());

                    System.out.println(fileName + "->" + FilenameUtils.getName(item.getName())); //一个的标签的name，一个是文件的name

                    String path=req.getServletContext().getRealPath("/upload");

                    System.out.println(path);

                    item.write(new File(path, RandomName)); //把上传的文件保存到某个文件中

                    //System.out.println(item.isInMemory());//判断文件资源是否在内存中

                }

            }

        }

        //Exception会捕捉我们的LogicException异常提示，所以我们在上面写一个，便于把LogicException异常返回给Servlet

        catch (LogicException e){

            throw e;

        }

        catch (Exception e) {

            e.printStackTrace();

        }

    }

}

这个是我写好的，里面的亮点有

1.我们无法在进行跳转了，跳转是Servlet的事，所以这里为了使得我们的FileUtil类和Servlet之间进行通信，我们采用了 throw Exception的方法，throw和return其实是一样的，只不过retuen是返回的数据类型，throw返回的是异常信息类型的

2.super.getServletContext 这个可以获取路径，但是只能在Servlet里面使用，我们的FileUtil类不是Servlet，所以采用了另外一种方法，就是req也可以这样去获取路径

3.两个catch，Exception的catch会把我们1里面抛出的异常给捕获了，那我们还怎么传递异常给Servlet，所以我们在上面又新加了一个异常，叫LogicException，这样的话，我们可以在

LogicException异常里面再次上抛，抛给我们的Servlet

我们新建一个异常类，叫LogicException，这就是我们上面使用的异常类，继承这两个方法就可以了，这个没啥细说的

package com.vae.Upload;

public class LogicException extends RuntimeException{

    /**

     *

     * @param message 异常的信息，可以自定义的

     */

    public LogicException(String message) {

        super(message);

    }

    /**

     *

     * @param message 异常的信息

     * @param cause   异常的根本原因

     */

    public LogicException(String message, Throwable cause) {

        super(message, cause);

    }

}

最好，看看我们的Servlet

package com.vae.Upload;

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;

@WebServlet("/upload")

public class UploadServlet extends HttpServlet {

    @Override

    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {

        try {

            FileUtil.upload(req);

        }catch (LogicException e){

            //拿到我们的LogicException异常信息

            String Msg=e.getMessage();

            req.setAttribute("errorMsg",Msg);

            req.getRequestDispatcher("/input.jsp").forward(req,resp);

        }

    }

}

文件的大小限制

上面有一个是缓存文件大小限制，这个仅仅是决定你的文件是保存在内存中还是保存在临时目录里面，下面讲的这个文件上传大小限制，是，超过这个范围就不让你上传了

有两个：

1.单个文件上传大小限制

2.所有文件上传大小限制

    //单个文件上传大小限制为2M

     upload.setFileSizeMax(1024*1024*2);

    //这次请求上传文件的大小(整个表单)限制为3M

     upload.setSizeMax(1024*1024*3);

还要捕捉异常，传给自定义的异常类

     catch (FileUploadBase.FileSizeLimitExceededException e){

            throw new LogicException("单个文件的上传大小不得超过2M");

        }

        catch (FileUploadBase.SizeLimitExceededException e){

            throw  new LogicException("所有上传文件的大小不得超过3M");

        }