Java 實現跨頁面下載進度條顯示的技術方案與替代思路

問題背景

在 Web 開發中，常見的需求是：用戶在頁面 A 點擊下載按鈕後，能否在頁面 B 顯示該文件的下載名稱與實時進度條？開發者希望使用 Java 實現這一功能，但在網上搜尋許多資料後，卻難以找到可直接落地的代碼示例。

核心難點分析

要在不同頁面間共享下載進度，本質上屬於「跨請求/跨會話的狀態同步」問題。Java Web 應用基於 HTTP 協議的無狀態特性，單純靠 Servlet/JSP 難以直接將後台下載線程的進度實時推送到另一個前端頁面。早期嘗試使用 ActiveX 控件（如回答中提到的）雖然理論上可行，但 Java 開發 ActiveX 門檻極高，且瀏覽器兼容性差、安全限制多，已非主流方案。

可行的技術路徑

方案一：WebSocket + 後台任務追蹤（推薦）

採用「輪詢」或「長連接」機制：

• 頁面 A 發起下載請求後，後台生成唯一任務 ID，將下載任務提交到線程池執行，並將進度寫入 Redis 或內存 Map（Key=任務 ID，Value=進度信息）。
• 頁面 B 打開時攜帶任務 ID，通過 WebSocket 或定時 AJAX 輪詢後台接口獲取進度，動態渲染進度條。
• 下載完成後，前端提示用戶並提供下載鏈接。

方案二：Server-Sent Events (SSE)

若僅需單向推送（服務端→客戶端），SSE 實現更簡單，瀏覽器原生支持，斷線自動重連，適合進度條場景。

方案三：成熟組件庫集成

直接使用 PrimeFaces、RichFaces 等 JSF 組件庫自帶的 <p:fileDownload> + <p:poll> 或 <p:socket>，幾行配置即可實現跨頁進度顯示，避免重複造輪子。

代碼示例：基於 Spring Boot + WebSocket 的極簡實現

@Controller
public class DownloadController {
    // 內存存儲進度，生產環境建議用 Redis
    private static final Map progressMap = new ConcurrentHashMap<>();

    @GetMapping("/startDownload")
    @ResponseBody
    public String startDownload(HttpSession session) {
        String taskId = UUID.randomUUID().toString();
        progressMap.put(taskId, 0);
        // 模擬異步下載任務
        new Thread(() -> {
            for (int i = 0; i <= 100; i += 10) {
                progressMap.put(taskId, i);
                try { Thread.sleep(500); } catch (InterruptedException ignored) {}
            }
        }).start();
        return taskId; // 返回任務 ID 給前端跳轉頁面 B 使用
    }

    @GetMapping("/progress/{taskId}")
    @ResponseBody
    public Integer getProgress(@PathVariable String taskId) {
        return progressMap.getOrDefault(taskId, -1);
    }
}

前端頁面 B 通過 setInterval 請求 /progress/{taskId} 並更新 <progress> 標籤即可。

總結與建議

Java 實現跨頁下載進度條的關鍵在於「任務 ID 傳遞」與「進度存儲/推送機制」的分離。放棄 ActiveX 等過時技術，擁抱 WebSocket/SSE 或成熟組件庫，才是高效、可維護的工程選擇。