jsp 文件上传

jsp 可以与 html form 标签一起使用，来允许用户上传文件到服务器。上传的文件可以是文本文件或图像文件或任何文档。

本章节我们使用 servlet 来处理文件上传，使用到的文件有：

upload.jsp : 文件上传表单。
message.jsp : 上传成功后跳转页面。
uploadservlet.java : 上传处理 servlet。
需要引入的 jar 文件：commons-fileupload-1.3.2、commons-io-2.5.jar。

结构图如下所示：

接下来我们详细介绍。

创建一个文件上传表单

下面的 html 代码创建了一个文件上传表单。以下几点需要注意：

表单 method 属性应该设置为 post 方法，不能使用 get 方法。
表单 enctype 属性应该设置为 multipart/form-data.
表单 action 属性应该设置为在后端服务器上处理文件上传的 servlet 文件。下面的实例使用了 uploadservlet servlet 来上传文件。
上传单个文件，您应该使用单个带有属性 type="file" 的 <input .../> 标签。为了允许多个文件上传，请包含多个 name 属性值不同的 input 标签。输入标签具有不同的名称属性的值。浏览器会为每个 input 标签关联一个浏览按钮。

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>
<h1>文件上传实例 - 硕编程</h1>
<form method="post" action="/tomcattest/uploadservlet" enctype="multipart/form-data">
    选择一个文件:
    <input type="file" name="uploadfile" />
    <br/><br/>
    <input type="submit" value="上传" />
</form>
</body>
</html>

编写后台 servlet

以下是 uploadservlet 的源代码，同于处理文件上传，在这之前我们先确保依赖包已经引入到项目的 web-inf/lib 目录下：

下面的实例依赖于 fileupload，所以一定要确保在您的 classpath 中有最新版本的 commons-fileupload.x.x.jar 文件。可以从 http://commons.apache.org/proper/commons-fileupload/ 下载。
fileupload 依赖于 commons io，所以一定要确保在您的 classpath 中有最新版本的 commons-io-x.x.jar 文件。可以从 http://commons.apache.org/proper/commons-io/ 下载。

你可以直接下载本站提供的两个依赖包：

uploadservlet 的源代码如下所示：

package com.yapf.test;

import java.io.file;
import java.io.ioexception;
import java.io.printwriter;
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;
 

/**
 * servlet implementation class uploadservlet
 */

// 如果不配置 web.xml ，可以使用下面的代码
// @webservlet("/uploadservlet")
public class uploadservlet extends httpservlet {
    private static final long serialversionuid = 1l;
     
    // 上传文件存储目录
    private static final string upload_directory = "upload";
 
    // 上传配置
    private static final int memory_threshold   = 1024 * 1024 * 3;  // 3mb
    private static final int max_file_size      = 1024 * 1024 * 40; // 40mb
    private static final int max_request_size   = 1024 * 1024 * 50; // 50mb
 
    /**
     * 上传数据及保存文件
     */
    protected void dopost(httpservletrequest request,
        httpservletresponse response) throws servletexception, ioexception {
        // 检测是否为多媒体上传
        if (!servletfileupload.ismultipartcontent(request)) {
            // 如果不是则停止
            printwriter writer = response.getwriter();
            writer.println("error: 表单必须包含 enctype=multipart/form-data");
            writer.flush();
            return;
        }
 
        // 配置上传参数
        diskfileitemfactory factory = new diskfileitemfactory();
        // 设置内存临界值 - 超过后将产生临时文件并存储于临时目录中
        factory.setsizethreshold(memory_threshold);
        // 设置临时存储目录
        factory.setrepository(new file(system.getproperty("java.io.tmpdir")));
 
        servletfileupload upload = new servletfileupload(factory);
         
        // 设置最大文件上传值
        upload.setfilesizemax(max_file_size);
         
        // 设置最大请求值 (包含文件和表单数据)
        upload.setsizemax(max_request_size);
        
        // 中文处理
        upload.setheaderencoding("utf-8"); 

        // 构造临时路径来存储上传的文件
        // 这个路径相对当前应用的目录
        string uploadpath = getservletcontext().getrealpath("/") + file.separator + upload_directory;
       
         
        // 如果目录不存在则创建
        file uploaddir = new file(uploadpath);
        if (!uploaddir.exists()) {
            uploaddir.mkdir();
        }
 
        try {
            // 解析请求的内容提取文件数据
            @suppresswarnings("unchecked")
            list<fileitem> formitems = upload.parserequest(request);
 
            if (formitems != null && formitems.size() > 0) {
                // 迭代表单数据
                for (fileitem item : formitems) {
                    // 处理不在表单中的字段
                    if (!item.isformfield()) {
                        string filename = new file(item.getname()).getname();
                        string filepath = uploadpath + file.separator + filename;
                        file storefile = new file(filepath);
                        // 在控制台输出文件的上传路径
                        system.out.println(filepath);
                        // 保存文件到硬盘
                        item.write(storefile);
                        request.setattribute("message",
                            "文件上传成功!");
                    }
                }
            }
        } catch (exception ex) {
            request.setattribute("message",
                    "错误信息: " + ex.getmessage());
        }
        // 跳转到 message.jsp
        getservletcontext().getrequestdispatcher("/message.jsp").forward(
                request, response);
    }
}

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>
    <center>
        <h2>${message}</h2>
    </center>
</body>
</html>

编译和运行 servlet

编译上面的 servlet uploadservlet，并在 web.xml 文件中创建所需的条目，如下所示：

<?xml version="1.0" encoding="utf-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    xsi:schemalocation="http://java.sun.com/xml/ns/javaee
        http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    id="webapp_id" version="2.5">
  <servlet>
    <display-name>uploadservlet</display-name>
    <servlet-name>uploadservlet</servlet-name>
    <servlet-class>com.yapf.test.uploadservlet</servlet-class>
  </servlet>
   
  <servlet-mapping>
    <servlet-name>uploadservlet</servlet-name>
    <url-pattern>/tomcattest/uploadservlet</url-pattern>
  </servlet-mapping>
</web-app>

现在尝试使用您在上面创建的 html 表单来上传文件。当您在浏览器中访问：http://localhost:8080/tomcattest/upload.jsp ，演示如下所示：

JSP基础