JavaWeb 文件上传下载-阿里云开发者社区

文件上传下载对于一个网站来说，重要性不言而喻。今天来分享一个JavaWeb方式实现的文件上传下载的小例子。

项目依赖

这个小例子是使用JavaWeb的JSP+Servlet实现的。另外使用了一些第三方的jar包。现列举如下：

apache-commons-fileupload.jar+apache-commons-io.jar: 开源的一套便于使用的组件
jstl.jar + standard.jar：模板语言jsp中将会用到的支持
stringutil.jar ：这个是我自己写的一个对string的简单的操作jar。下载地址 https://github.com/guoruibiao/File_Upload_Download/blob/master/WebContent/WEB-INF/lib/stringutils.jar

以上这些依赖，都很容易获得。当然也可以在我的repository中直接获取。地址如下：https://github.com/guoruibiao/File_Upload_Download/blob/master/WebContent/WEB-INF/lib。

项目目录

在开始项目之前，给出一个项目目录可以使得我们的思路更加的清晰。

工作流程

对于新手而言。对web.xml的配置可能摸不着头脑，下面给大家画个图吧。

Created with Raphaël 2.1.0URL链接根据url-pattern找到同级的servlet-name根据servlet-name可以获取其父标签servlet-mapping，然后获取到servlet-mapping的兄弟节点servlet根据servlet-mapping的servlet-name就可以获取到与之同名的servlet标签的内容。从servlet标签中获取到servlet-class属性的值，然后通过反射技术在tomcat容器中加载相应的类。进行一系列的业务逻辑操作。将获取到的数据传给jsp页面模板用户获取视图

文件上传

在开始编码之前，我们还需要了解一些比较基础的知识。可能你会觉得有点啰嗦了，但是为了照顾到不了解这些的童鞋，我还是多说几句吧:-)

表单处的设置

如果我们要想做一个上传文件功能，毫无疑问需要通过表单进行。因此，我们需要遵守一点规则。

<form
        action="${pageContext.request.contextPath }/servlet/UploadHandleServlet"
        enctype="multipart/form-data" method="post">
        上传用户：<input type="text" name="username"><br> 上传文件1：<input
            type="file" name="file1"><br> 上传文件2：<input type="file"
            name="file2"><br> <input type="submit" value="提交">
    </form>

以这个表单为例，我们不难发现。

enctype="multipart/form-data"
这行代码，其作用就是告诉服务器，我们的这个表单将用于文件上传处理。

服务器端

通过表单来实现上传固然很方便，但是除了文件项之外的表单项怎么处理呢？这时我们就需要了解一下，关于apache-commons-fileupload的文件处理了。


try {
            // 使用Apache上传组件处理文件上传的步骤
            // 1、创建一个DIskFileItemFactory工厂
            DiskFileItemFactory factory = new DiskFileItemFactory();
            // 2、创建一个文件上传解析器
            ServletFileUpload uploadparser = new ServletFileUpload(factory);
            // 3、解决上传文件的中文乱码；判断提交上来的数据是否是上传表单的数据
            uploadparser.setHeaderEncoding("UTF-8");
            if (!ServletFileUpload.isMultipartContent(request)) {
                // 不是表单数据，则按照传统方式获取数据
                return;
            }
            // 4、使用ServletFileUpload解析器解析上传的数据，解析结果返回的是一个List<File>集合，每个Item对应一个表单的输入项
            List<FileItem> files = uploadparser.parseRequest(request);
            for (FileItem fileitem : files) {
                // 如果fileitem中封装的是普通的输入项的数据
                if (fileitem.isFormField()) {
                    String name = fileitem.getFieldName();
                    // 解决普通输入项的数据的中文乱码问题
                    String value = fileitem.getString("UTF-8");
                    System.out.println(name + "  =   " + value);
                } else {// 如果fileitem里面封装的是上传的文件，则是用处理文件的方式处理
                    String filename = fileitem.getName();
                    System.out.println(fileitem);
                    if (filename == null || filename.trim().equals("")) {
                        continue;
                    }
                    // 注意：不同的浏览器提交的文件名是不一样的，有些浏览器提交上来的文件是带有其客户端本机路径的，有些则不带。所以我们要对上传文件处理，只得到文件名称即可
                    filename = StringUtils.getFileName(filename);
                    // 获取fileitem的上传文件的输入流
                    InputStream is = fileitem.getInputStream();
                    // 创建一个文件输出流
                    FileOutputStream fos = new FileOutputStream(savePath + "\\" + filename);
                    // 创建一个缓冲区
                    byte[] buffer = new byte[1024];
                    // 判断输入流中的数据是否已经读完的标识
                    int len = 0;
                    while ((len = is.read(buffer)) > 0) {
                        // 将数据写入到服务器的对应的文件中
                        fos.write(buffer, 0, len);
                    }
                    is.close();
                    fos.close();
                    fileitem.delete();
                    message = new String("Upload Success!".getBytes(), "UTF-8");

                }
            }

        } catch (Exception e) {
            message = new String("Upload Failed!".getBytes(), "UTF-8") + e;
            e.printStackTrace();
        }

上传功能的实现

好了，下面开始上传功能的实现。

upload.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>文件上传</title>
</head>
<body>
    <form
        action="${pageContext.request.contextPath }/servlet/UploadHandleServlet"
        enctype="multipart/form-data" method="post">
        上传用户：<input type="text" name="username"><br> 上传文件1：<input
            type="file" name="file1"><br> 上传文件2：<input type="file"
            name="file2"><br> <input type="submit" value="提交">
    </form>

</body>
</html>

message.jsp

在软件使用的过程中，为了给用户一个更加友好的用户体验，我们添加了一个与用户单方面交互（简单的提示作用）的页面。用来传递代码过程的必要信息。

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>消息提示</title>
</head>
<body>${message }
</body>
</html>

UploadHandleServlet

package controller;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;

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 org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

import stringutil.StringUtils;

public class UploadHandleServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;

    public UploadHandleServlet() {
        super();
    }

    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        // TODO Auto-generated method stub
        response.getWriter().append("Served at: ").append(request.getContextPath());
        // 得到上传文件的保存目录，将上传的文件存放到外界不能直接访问的WEB-INF目录下
//      String savePath = this.getServletContext().getRealPath("/WEB-INF/upload");
        String savePath = "E://Code/jee/File_upload_download/WebContent/WEB-INF/upload";
        File file = new File(savePath);
        // 判断上传文件的目录是否存在
        if (!file.exists() && !file.isDirectory()) {
            System.out.println(savePath + "  Need to Make Directory named ‘upload’！");
            // 开始创建目录
            file.mkdir();
        }

        // 消息提示
        String message = "";
        try {
            // 使用Apache上传组件处理文件上传的步骤
            // 1、创建一个DIskFileItemFactory工厂
            DiskFileItemFactory factory = new DiskFileItemFactory();
            // 2、创建一个文件上传解析器
            ServletFileUpload uploadparser = new ServletFileUpload(factory);
            // 3、解决上传文件的中文乱码；判断提交上来的数据是否是上传表单的数据
            uploadparser.setHeaderEncoding("UTF-8");
            if (!ServletFileUpload.isMultipartContent(request)) {
                // 不是表单数据，则按照传统方式获取数据
                return;
            }
            // 4、使用ServletFileUpload解析器解析上传的数据，解析结果返回的是一个List<File>集合，每个Item对应一个表单的输入项
            List<FileItem> files = uploadparser.parseRequest(request);
            for (FileItem fileitem : files) {
                // 如果fileitem中封装的是普通的输入项的数据
                if (fileitem.isFormField()) {
                    String name = fileitem.getFieldName();
                    // 解决普通输入项的数据的中文乱码问题
                    String value = fileitem.getString("UTF-8");
                    System.out.println(name + "  =   " + value);
                } else {// 如果fileitem里面封装的是上传的文件，则是用处理文件的方式处理
                    String filename = fileitem.getName();
                    System.out.println(fileitem);
                    if (filename == null || filename.trim().equals("")) {
                        continue;
                    }
                    // 注意：不同的浏览器提交的文件名是不一样的，有些浏览器提交上来的文件是带有其客户端本机路径的，有些则不带。所以我们要对上传文件处理，只得到文件名称即可
                    filename = StringUtils.getFileName(filename);
                    // 获取fileitem的上传文件的输入流
                    InputStream is = fileitem.getInputStream();
                    // 创建一个文件输出流
                    FileOutputStream fos = new FileOutputStream(savePath + "\\" + filename);
                    // 创建一个缓冲区
                    byte[] buffer = new byte[1024];
                    // 判断输入流中的数据是否已经读完的标识
                    int len = 0;
                    while ((len = is.read(buffer)) > 0) {
                        // 将数据写入到服务器的对应的文件中
                        fos.write(buffer, 0, len);
                    }
                    is.close();
                    fos.close();
                    fileitem.delete();
                    message = new String("Upload Success!".getBytes(), "UTF-8");

                }
            }

        } catch (Exception e) {
            message = new String("Upload Failed!".getBytes(), "UTF-8") + e;
            e.printStackTrace();
        }
        request.setAttribute("message", message);
        request.getRequestDispatcher("/message.jsp").forward(request, response);
    }

    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        // TODO Auto-generated method stub
        doGet(request, response);
    }

}

web.xml配置

<servlet>
        <servlet-name>UploadHandleServlet</servlet-name>
        <servlet-class>controller.UploadHandleServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>UploadHandleServlet</servlet-name>
        <url-pattern>/servlet/UploadHandleServlet</url-pattern>
    </servlet-mapping>

结果展示

文件上传

上传结果

文件浏览

要想实现下载功能，我们需要先给用户一个引导，那就是咱们的网站上有什么。所以我们需要对网站上提供下载的文件夹一个遍历。

思路如下：

Created with Raphaël 2.1.0定位到upload文件夹让业务逻辑在servlet中完成，获得存储了文件信息的Map集合将集合交给JSP页面进行展示用户获得页面视图

ListFileServlet.java

package controller;

import java.io.File;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.util.HashMap;
import java.util.Map;

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 stringutil.StringUtils;


/**
 * Servlet implementation class ListFileServlet
 */
@WebServlet("/ListFileServlet")
public class ListFileServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;

    /**
     * @see HttpServlet#HttpServlet()
     */
    public ListFileServlet() {
        super();
        // TODO Auto-generated constructor stub
    }

    /**
     * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse
     *      response)
     */
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        // TODO Auto-generated method stub
        response.getWriter().append("Served at: ").append(request.getContextPath());
        // 获取上传文件的目录
        String uploadPath = "E://Code/jee/File_upload_download/WebContent/WEB-INF/upload";
        // 存储要下载的文件名
        Map<String, String> filenameMap = new HashMap<String, String>();
        // 递归遍历filePath下面的所有的文件和目录，将文件的文件名称存储到Map集合中
        listFile(new File(uploadPath), filenameMap);
        // 将集合存入域找那个，方便页面展示层获取数据
        request.setAttribute("filenameMap", filenameMap);
        request.getRequestDispatcher("/listfiles.jsp").forward(request, response);
    }

    public void listFile(File file, Map<String, String> filenameMap) {
        // 如果file代表的不是一个文件，而是一个目录
        if (!file.isFile()) {
            // 列出该目录下面的所有的文件和目录
            File[] files = file.listFiles();
            // 遍历files[] 数组
            for (File f : files) {
                // 递归
                listFile(f, filenameMap);
            }
        } else {
            // 使用自己的那个strigutil来获取文件的名称，而不是路径名称
            String realName = StringUtils.getFileName(file.getName());
            try {
                filenameMap.put(new String(file.getName().getBytes("iso8859-1"),"UTF-8"), realName);
            } catch (UnsupportedEncodingException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            }
        }


    }

    /**
     * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse
     *      response)
     */
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        // TODO Auto-generated method stub
        doGet(request, response);
    }

}

listfiles.jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<!DOCTYPE HTML>
<html>
<head>
<title>下载文件显示页面</title>
</head>

<body>
    <!-- 遍历Map集合 -->
    <c:forEach var="me" items="${filenameMap}">
        <c:url value="/servlet/DownLoadServlet" var="downurl">
            <c:param name="filename" value="${me.key}"></c:param>
        </c:url>
         ${me.value}<a href="${downurl}">Download now?</a>
        <br />
    </c:forEach>
</body>
</html>

web.xml配置

<servlet>
        <servlet-name>ListFileServlet</servlet-name>
        <servlet-class>controller.ListFileServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>ListFileServlet</servlet-name>
        <url-pattern>/servlet/ListFileServlet</url-pattern>
    </servlet-mapping>

截图结果

文件列表

注意

这里有几点容易出错的地方，大家需要注意。

路径问题

由于使用this.getServletContext().getRealPath("/WEB-INF/upload");的过程中出现了一些问题，所以我这里使用了绝对路径，大家可以自己的情况随意选择。

JSTL使用

在使用JSTL标签库的时候，千万不要忘记引入相关的jar包。然后在JSP页面上方填写相应的声明。还有就是URI属性不要写错咯。是<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>

模板变量

在<c:forEach>标签内部，使用的<c:param name="filename" value="${me.key}"></c:param>参数一定不要写错了。因为等会我们会根据这里面的name="filename"属性来唯一确定我们要下载的文件的信息。

文件下载

文件下载的功能本身并不难，核心就是告诉浏览器header是什么，然后通过一个流操作，将要进行下载的数据发送给客户端浏览器即可。

DownLoadServlet.java

package controller;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.net.URLEncoder;

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 stringutil.StringUtils;

/**
 * Servlet implementation class DownLoadServlet
 */
@WebServlet("/DownLoadServlet")
public class DownLoadServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;

    /**
     * @see HttpServlet#HttpServlet()
     */
    public DownLoadServlet() {
        super();
        // TODO Auto-generated constructor stub
    }

    /**
     * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse
     *      response)
     */
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        // TODO Auto-generated method stub
        // 得到要下载的文件名
        String filename = request.getParameter("filename");
        filename = new String(filename.getBytes("iso8859-1"), "UTF-8");
        // 上传的文件都是保存在刚才的那个upload的文件夹下.

        String fileSaveRootPath = "E://Code/jee/File_upload_download/WebContent/WEB-INF/upload";
        // 通过文件名找出文件所在的目录
        // 由于路径有点问题，这里采用绝对路径来进行处理
        // String filePath =
        // findFileSavePathByFileName(filename,fileSaveRootPath);
        String filePath = fileSaveRootPath;
        // 得到要下载的文件
        File file = new File(filePath + "\\" + filename);
        // 如果文件不存在
        if (!file.exists()) {
            request.setAttribute("message", "The File you want to download doesn't exists!");
            request.getRequestDispatcher("/message.jsp").forward(request, response);
            return;
        }
        // 处理文件名
        String realname = StringUtils.getFileName(filename);
        // 设置响应头
        response.setHeader("content-disposition", "attachment;filename=" + URLEncoder.encode(realname, "UTF-8"));
        // 读取要下载的文件，保存到文件输入流
        FileInputStream fis = new FileInputStream(filePath + "\\" + filename);
        // 创建输入流
        OutputStream os = response.getOutputStream();
        // 创建缓冲区
        byte[] buffer = new byte[1024];
        int len = 0;
        while ((len = fis.read(buffer)) > 0) {
            os.write(buffer, 0, len);
        }
        fis.close();
        os.close();

    }

    private String findFileSavePathByFileName(String filename, String fileSaveRootPath) {
        int hashcode = filename.hashCode();
        int dir1 = hashcode & 0xf; // 0--15
        int dir2 = (hashcode & 0xf0) >> 4; // 0--15
        String dir = fileSaveRootPath + "\\" + dir1 + "\\" + dir2;
        File file = new File(dir);
        if (!file.exists()) {
            // 创建目录
            file.mkdir();
        }
        return dir;
    }

    /**
     * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse
     *      response)
     */
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        // TODO Auto-generated method stub
        doGet(request, response);
    }

}

web.xml配置

<servlet>
        <servlet-name>DownLoadServlet</servlet-name>
        <servlet-class>controller.DownLoadServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>DownLoadServlet</servlet-name>
        <url-pattern>/servlet/DownLoadServlet</url-pattern>
    </servlet-mapping>

截图展示

下载界面

下载结果

总结

最后关于整个项目的总结。使用apache-commons-fileupload组件确实是很方便，它可以方便的将表单中上传的数据封装到一个List<fileItem>中，我们只需要对这个集合进行遍历操作，就可以随意的设置自己需要的内容。

最后，希望大家看完之后都能有所收获。让自己的网站的功能更加的丰富。

完整的项目下载地址如下： https://github.com/guoruibiao/File_Upload_Download/。欢迎拍砖 :-)

JavaWeb 文件 上传 下载

项目依赖

项目目录

工作流程

文件上传

表单处的设置

服务器端

上传功能的实现

upload.jsp

message.jsp

UploadHandleServlet

web.xml配置

结果展示

文件浏览

ListFileServlet.java

listfiles.jsp

web.xml配置

截图结果

注意

路径问题

JSTL使用

模板变量

文件下载

DownLoadServlet.java

web.xml配置

截图展示

总结

JavaWeb 文件上传下载