JBuilder 2005 Servlet 開發實戰：Excel 文件下載功能完整實現

在 Web 應用中實現「點擊鏈接下載服務器生成的 Excel 文件」是常見需求。本文基於 JBuilder 2005 向導，完整演示從創建 HttpServlet、配置 web.xml、設置響應頭、流式輸出文件、到 JSP 頁面集成的全流程。

1. 向導創建 Servlet

1. File → New → Web → Standard Servlet
2. 類名：ExcelFileServlet，包：bookstore.servlet
3. 覆寫方法：doGet()
4. URL 參數：year (String)、month (String)
5. 訪問路徑：/excelfileservlet

2. 生成的基礎代碼

package bookstore.servlet;

import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
import java.util.*;

public class ExcelFileServlet extends HttpServlet {
    public void init() throws ServletException {}
    
    public void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        String year = request.getParameter("year");
        if (year == null) year = "2005";
        
        String month = request.getParameter("month");
        if (month == null) month = "1";
        
        PrintWriter out = response.getWriter(); // 後續將替換
        // @todo implement GET
    }
    
    public void destroy() {}
}

3. web.xml 自動生成配置

<servlet>
    <servlet-name>excelfileservlet</servlet-name>
    <servlet-class>bookstore.servlet.ExcelFileServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>excelfileservlet</servlet-name>
    <url-pattern>/excelfileservlet</url-pattern>
</servlet-mapping>

4. 核心下載邏輯實現

public void doGet(HttpServletRequest request, HttpServletResponse response)
        throws ServletException, IOException {
    
    // 1. 解析並驗證參數
    int year, month;
    try { year = Integer.parseInt(request.getParameter("year")); }
    catch (NumberFormatException e) { year = 2005; }
    
    try { month = Integer.parseInt(request.getParameter("month")); }
    catch (NumberFormatException e) { month = 1; }
    
    // 2. 構建文件路徑
    String fileName = "log_" + year + "_" + month + ".xls";
    File file = new File("D:/serverLog/" + fileName); // 注意路徑分隔符
    
    // 3. 關鍵：設置響應頭觸發瀏覽器下載對話框
    response.setContentType("application/x-msdownload"); // 或 application/octet-stream
    response.setContentLength((int) file.length());
    response.setHeader("Content-Disposition", "attachment; filename=\"" + fileName + "\"");
    
    // 4. 流式輸出（避免大文件 OOM）
    try (FileInputStream fis = new FileInputStream(file);
         BufferedInputStream bis = new BufferedInputStream(fis);
         OutputStream out = response.getOutputStream()) {
        
        byte[] buffer = new byte[1024];
        int bytesRead;
        while ((bytesRead = bis.read(buffer)) != -1) {
            out.write(buffer, 0, bytesRead);
        }
        out.flush();
    }
    // 無需 catch，Servlet 容器會處理 IOException
}

關鍵技術點解析

5. JSP 頁面集成下載鏈接

<%@ page contentType="text/html; charset=GBK" %>
<%@ taglib uri="https://jakarta.apache.org/taglibs/datetime-1.0" prefix="dt" %>
...
當前時間：<dt:format pattern="MM/dd/yyyy hh:mm"><dt:currentTime/></dt:format>

<!-- 下載鏈接：帶參數指向 Servlet -->
<a href="/webModule/excelfileservlet?year=2005&month=1">
    下載系統啟動日誌 (2025年1月)
</a>

<br>
<a href="quit.jsp">點擊這裡退出系統</a>

進階優化方向

1. 動態生成 Excel：用 Apache POI 在 Servlet 中即時創建 Workbook → 輸出流，無需預存文件
2. 斷點續傳：解析 Range 請求頭，實現 206 Partial Content
3. 大文件異步生成：提交任務返回任務 ID，輪詢/websocket 通知下載
4. 安全控制：校驗用戶權限、防止目錄遍歷攻擊 (../../etc/passwd)
5. 國際化文件名：filename*=UTF-8''%E6%97%A5%E8%AA%8C.xls

常見坑位避雷

• ❌ 用 PrintWriter 輸出二進制 → 字符編碼破壞文件 → 改用 OutputStream
• ❌ 忘記 Content-Length → 瀏覽器無進度條、可能下載不完整
• ❌ 文件路徑硬編碼 → 部署環境不一致失效 → 用 ServletContext.getRealPath() 或配置屬性
• ❌ 大文件一次性 readAllBytes() → OOM → 必須分塊流式輸出
• ❌ 中文文件名未編碼 → 下載文件名亂碼 → RFC 5987 編碼

掌握此模式，文件下載功能「一次寫對，到處可用」。