使用FileUpload元件實作檔案上傳

使用FileUpload元件實作檔案上傳

檔案上傳在web應用中非常普遍，要在servlet/jsp環境中實作檔案上傳功能非常容易，因為網上已經有許多用java開發的元件用于檔案上傳，本文以commons-fileupload元件為例，為servlet/jsp應用添加檔案上傳功能。

下載下傳後解壓zip包，将commons-fileupload-1.0.jar複制到tomcat的webapps/你的webapp/WEB-INF/lib/下，如果目錄不存在請自建目錄。

建立一個servlet: Upload.java用于檔案上傳：

import java.io.*;

import java.util.*;

import javax.servlet.*;

import javax.servlet.http.*;

import org.apache.commons.fileupload.*;

public class Upload extends HttpServlet {

    private String uploadPath = "C://upload//"; // 用于存放上傳檔案的目錄

    private String tempPath = "C://upload//tmp//"; // 用于存放臨時檔案的目錄

    public void doPost(HttpServletRequest request, HttpServletResponse response)

        throws IOException, ServletException

    {

    }

}

當servlet收到浏覽器發出的Post請求後，在doPost()方法中實作檔案上傳。以下是示例代碼：

public void doPost(HttpServletRequest request, HttpServletResponse response)

    throws IOException, ServletException

{

    try {

        DiskFileUpload fu = new DiskFileUpload();

        // 設定最大檔案尺寸，這裡是4MB

        fu.setSizeMax(4194304);

        // 設定緩沖區大小，這裡是4kb

        fu.setSizeThreshold(4096);

        // 設定臨時目錄：

        fu.setRepositoryPath(tempPath);

        // 得到所有的檔案：

        List fileItems = fu.parseRequest(request);

        Iterator i = fileItems.iterator();

        // 依次處理每一個檔案：

        while(i.hasNext()) {

            FileItem fi = (FileItem)i.next();

            // 獲得檔案名，這個檔案名包括路徑：

            String fileName = fi.getName();

            if(fileName!=null) {

                // 在這裡可以記錄使用者和檔案資訊

                // ...

                // 寫入檔案a.txt，你也可以從fileName中提取檔案名：

                fi.write(new File(uploadPath + "a.txt"));

            }

        }

        // 跳轉到上傳成功提示頁面

    catch(Exception e) {

        // 可以跳轉出錯頁面

如果要在配置檔案中讀取指定的上傳檔案夾，可以在init()方法中執行：

public void init() throws ServletException {

    uploadPath = ....

    tempPath = ....

    // 檔案夾不存在就自動建立：

    if(!new File(uploadPath).isDirectory())

        new File(uploadPath).mkdirs();

    if(!new File(tempPath).isDirectory())

        new File(tempPath).mkdirs();

編譯該servlet，注意要指定classpath，確定包含commons-upload-1.0.jar和tomcat/common/lib/servlet-api.jar。

配置servlet，用記事本打開tomcat/webapps/你的webapp/WEB-INF/web.xml，沒有的話建立一個。典型配置如下：

<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE web-app

    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

<web-app>

    <servlet>

        <servlet-name>Upload</servlet-name>

        <servlet-class>Upload</servlet-class>

    </servlet>

    <servlet-mapping>

        <url-pattern>/fileupload</url-pattern>

    </servlet-mapping>

</web-app>

配置好servlet後，啟動tomcat，寫一個簡單的html測試：

<form action="fileupload" method="post"

enctype="multipart/form-data" name="form1">

  <input type="file" name="file">

  <input type="submit" name="Submit" value="upload">

</form>

注意action="fileupload"其中fileupload是配置servlet時指定的url-pattern。