java servlet使用uploadfile实现文件上传的功能

comons包导入IDEA失败？文件上传后在工程中相应的文件夹下找不到上传的文件？

近期想要基于hadoop分布式系统开发一个云盘项目。前些时候已经给IDEA配置好了tomcat的环境，配置好了java servlet的运行环境。这两天自己摸索着实现了一个简单的文件上传功能。在这个过程遇到了一些坑，在这里记录一下。

一、资源准备

需要下载下面两个jar包。

comons-fileupload.jar下载地址:http://commons.apache.org/proper/commons-fileupload/download_fileupload.cgi

commons-io.jar下载地址http://commons.apache.org/proper/commons-io/download_io.cgi

选择.zip压缩包下载，下载完成后进行解压缩。不能直接把zip包导进去！！！

文件夹里面的commons-fileupload-1.3.3.jar和commons-io-2.5.jar才是我们真正需要的jar包

注意：因为之前一直以为jar包本质上就是一个压缩包，所以我在下载完两个.zip文件后直接把它给导入工程，发现不行。又把.zip的后缀改成了jar,导入工程，还是不行。后面摸索着才发现，这真特么就是个压缩包，里面包含很多说明文档。。。

二、建工程

javaweb工程的创建，详情参考：《如何用intellij idea新建一个java web+Servlet项目》

1、把文件上传需要的两个jar包导入lib文件夹下

2、在src文件夹下右击创建一个java文件

代码内容如下：

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;

public class UploadServlet extends HttpServlet {

    public void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        //得到上传文件的保存目录，将上传的文件存放于WEB-INF目录下，不允许外界直接访问，保证上传文件的安全
        String savePath = this.getServletContext().getRealPath("/WEB-INF/upload");
        System.out.println(this.getServletContext().getRealPath("/WEB-INF/upload"));
        File file = new File(savePath);
        //判断上传文件的保存目录是否存在
        if (!file.exists() && !file.isDirectory()) {
            System.out.println(savePath+"目录不存在，需要创建");
            //创建目录
            file.mkdir();
        }
        //消息提示
        String message = "";
        try{
            //使用Apache文件上传组件处理文件上传步骤：
            //1、创建一个DiskFileItemFactory工厂
            DiskFileItemFactory factory = new DiskFileItemFactory();
            //2、创建一个文件上传解析器
            ServletFileUpload upload = new ServletFileUpload(factory);
            //解决上传文件名的中文乱码
            upload.setHeaderEncoding("UTF-8");
            //3、判断提交上来的数据是否是上传表单的数据
            if(!ServletFileUpload.isMultipartContent(request)){
                //按照传统方式获取数据
                return;
            }
            //4、使用ServletFileUpload解析器解析上传数据，解析结果返回的是一个List<FileItem>集合，每一个FileItem对应一个Form表单的输入项
            List<FileItem> list = upload.parseRequest(request);
            for(FileItem item : list){
                //如果fileitem中封装的是普通输入项的数据
                if(item.isFormField()){
                    String name = item.getFieldName();
                    //解决普通输入项的数据的中文乱码问题
                    String value = item.getString("UTF-8");
                    //value = new String(value.getBytes("iso8859-1"),"UTF-8");
                    System.out.println(name + "=" + value);
                }else{//如果fileitem中封装的是上传文件
                    //得到上传的文件名称，
                    String filename = item.getName();
                    System.out.println(filename);
                    if(filename==null || filename.trim().equals("")){
                        continue;
                    }
                    //注意：不同的浏览器提交的文件名是不一样的，有些浏览器提交上来的文件名是带有路径的，如：  c:\a\b\1.txt，而有些只是单纯的文件名，如：1.txt
                    //处理获取到的上传文件的文件名的路径部分，只保留文件名部分
                    filename = filename.substring(filename.lastIndexOf("\\")+1);
                    //获取item中的上传文件的输入流
                    InputStream in = item.getInputStream();
                    //创建一个文件输出流
                    FileOutputStream out = new FileOutputStream(savePath + "\\" + filename);
                    //创建一个缓冲区
                    byte buffer[] = new byte[1024];
                    //判断输入流中的数据是否已经读完的标识
                    int len = 0;
                    //循环将输入流读入到缓冲区当中，(len=in.read(buffer))>0就表示in里面还有数据
                    while((len=in.read(buffer))>0){
                        //使用FileOutputStream输出流将缓冲区的数据写入到指定的目录(savePath + "\\" + filename)当中
                        out.write(buffer, 0, len);
                    }
                    //关闭输入流
                    in.close();
                    //关闭输出流
                    out.close();
                    //删除处理文件上传时生成的临时文件
                    item.delete();
                    message = "文件上传成功！";
                }
            }
        }catch (Exception e) {
            message= "文件上传失败！";
            e.printStackTrace();

        }
        request.setAttribute("message",message);
        request.getRequestDispatcher("/message.jsp").forward(request, response);
    }

    public void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        doGet(request, response);
    }
}

3、修改index.jsp的代码

<%@ page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head>
  <title>文件上传</title>
</head>

<body>
<form action="UploadServlet" 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>

4、在相同的位置再新建一个message.jsp

代码如下：

<%@ page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head>
    <title>消息提示</title>
</head>

<body>
${message}
</body>
</html>

5、修改web.xml的内容

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    <servlet>
        <servlet-name>UploadServlet</servlet-name>
        <servlet-class>UploadServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>UploadServlet</servlet-name>
        <url-pattern>/UploadServlet</url-pattern>
    </servlet-mapping>
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
</web-app>

三、运行调试

1、文件下载位置

由于我刚开始并没有在项目中的WEB-INF下创建upload文件夹，它会自动帮我创建，但是工程里面看不到。导致我一直以为我的程序有问题，文件没有上传成功。后面我输出了这个文件存储的真实路径。到真实路径中去看了，发现文件已经被上传了。

2、页面如下

3、IDEA中的交互界面

我们发现工程中还是没有upload这个文件夹。

不要急，我们去真实路径下找看看

会发现文件已经上传成功。

 

四、总结

我之前以为上传的文件无法在工程里面看到是因为我没有在工程中先创建相应的文件夹（比如：upload）。但是后面我新建了一个工程，先建好了upload文件夹。然而上传的文件依然无法在工程中看到，目前还不是很清楚原因。