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

---

项目依赖

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

• apache-commons-fileupload.jar+apache-commons-io.jar: 开源的一套便于使用的组件
• jstl.jar + standard.jar： 模板语言jsp中将会用到的支持
• stringutil.jar ： 这个是我自己写的一个对string的简单的操作jar。下载地址

以上这些依赖，都很容易获得。当然也可以在我的repository中直接获取。地址如下：。

项目目录

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

工作流程

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

文件上传

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

表单处的设置

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

     
              上传用户：
      
      
 上传文件1：
      
      
 上传文件2：
      
      
 
          
     

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

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
     
      集合，每个Item对应一个表单的输入项            List
      
        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"%>
         
     
              上传用户：
      
      
 上传文件1：
      
      
 上传文件2：
      
      
 
          
     

message.jsp

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

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%>
     ${message }

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
     
      集合，每个Item对应一个表单的输入项            List
      
        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配置

             
      
       UploadHandleServlet
              
      
       controller.UploadHandleServlet
          
         
             
      
       UploadHandleServlet
              
      
       /servlet/UploadHandleServlet
          
     

结果展示

文件浏览

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

思路如下：

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
     
       filenameMap = new HashMap
      
       ();        // 递归遍历filePath下面的所有的文件和目录，将文件的文件名称存储到Map集合中        listFile(new File(uploadPath), filenameMap);        // 将集合存入域找那个，方便页面展示层获取数据        request.setAttribute("filenameMap", filenameMap);        request.getRequestDispatcher("/listfiles.jsp").forward(request, response);    }    public void listFile(File file, Map
       
         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"%>    
         
             
                  
               
               ${me.value}
      Download now?        
      
    
     

web.xml配置

             
      
       ListFileServlet
              
      
       controller.ListFileServlet
          
         
             
      
       ListFileServlet
              
      
       /servlet/ListFileServlet
          
     

截图结果

注意

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

路径问题

由于使用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配置

             
      
       DownLoadServlet
              
      
       controller.DownLoadServlet
          
         
             
      
       DownLoadServlet
              
      
       /servlet/DownLoadServlet
          
     

截图展示

总结

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

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

完整的项目下载地址如下： 。欢迎拍砖 :-)