萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

使用 Servlet 將 JSP 頁面渲染輸出為靜態 HTML 檔案

應用場景

  • 靜態化首頁/商品頁/文章頁,減少動態渲染壓力。
  • 生成離線報表、郵件模板、PDF 前置 HTML。
  • CDN 快取靜態檔案,提升全球訪問速度。

核心原理

  1. Servlet 接收請求,建立 ByteArrayOutputStream 捕獲輸出。
  2. 包裝 HttpServletResponseWrapper 重寫 getOutputStream()、getWriter() 指向捕獲流。
  3. 使用 RequestDispatcher.include() 執行目標 JSP,輸出導向捕獲流。
  4. 將捕獲內容寫入檔案系統,並可選擇重導向至靜態檔。

完整 Servlet 實作

package com.example.util;

import jakarta.servlet.*;
import jakarta.servlet.http.*;
import java.io.*;

public class JspToHtmlServlet extends HttpServlet {
  private static final String CONTENT_TYPE = "text/html; charset=UTF-8";

  @Override
  protected void doGet(HttpServletRequest req, HttpServletResponse resp) 
      throws ServletException, IOException {
    // 目標 JSP 路徑 (WebApp 相對路徑)
    String jspPath = "/index.jsp";
    // 輸出 HTML 檔案路徑 (伺服器絕對路徑)
    String htmlPath = getServletContext().getRealPath("/static/index.html");
    
    // 1. 捕獲輸出流
    ByteArrayOutputStream baos = new ByteArrayOutputStream();
    ServletOutputStream sos = new ServletOutputStream() {
      @Override public void write(int b) { baos.write(b); }
      @Override public void write(byte[] b, int off, int len) { baos.write(b, off, len); }
      @Override public boolean isReady() { return true; }
      @Override public void setWriteListener(WriteListener l) {}
    };
    PrintWriter pw = new PrintWriter(new OutputStreamWriter(baos, "UTF-8"));

    // 2. 包裝 Response
    HttpServletResponse wrapped = new HttpServletResponseWrapper(resp) {
      @Override public ServletOutputStream getOutputStream() { return sos; }
      @Override public PrintWriter getWriter() { return pw; }
      @Override public void setContentType(String type) { super.setContentType(CONTENT_TYPE); }
    };

    // 3. 執行 JSP (include 而非 forward,保持請求屬性)
    RequestDispatcher rd = getServletContext().getRequestDispatcher(jspPath);
    rd.include(req, wrapped);

    // 4. 刷新並寫入檔案
    pw.flush();
    try (FileOutputStream fos = new FileOutputStream(htmlPath)) {
      baos.writeTo(fos);
    }

    // 5. 回應結果
    resp.setContentType(CONTENT_TYPE);
    resp.getWriter().println("靜態化完成:<a href='/static/index.html'>查看生成檔案</a>");
  }
}

web.xml 配置

<servlet>
  <servlet-name>jspToHtml</servlet-name>
  <servlet-class>com.example.util.JspToHtmlServlet</servlet-class>
</servlet>
<servlet-mapping>
  <servlet-name>jspToHtml</servlet-name>
  <url-pattern>/generate-html</url-pattern>
</servlet-mapping>

測試用 index.jsp

<%@ page contentType="text/html;charset=UTF-8" %>
<html><head><title>測試頁面</title></head><body>
<h1>動態生成時間:<%= new java.util.Date() %></h1>
<p>模擬耗時運算:<%
  long sum = 0;
  for (int i = 0; i < 1000000; i++) sum += i;
  out.print(sum);
%></p>
</body></html>

進階增強

增強點實作方式
支援多個 JSP 批量靜態化掃描目錄、讀取配置檔、多執行緒並行處理
增量靜態化比對 JSP 修改時間與 HTML 檔案時間,僅更新變更頁面
模板引擎替代Thymeleaf/Freemarker/Velocity 直接輸出字串,無需 Servlet 容器
CDN 推送生成後調用 CDN API 預熱/刷新快取
佇列非同步請求寫入 MQ,Worker 消費生成 HTML,回調通知前端
斷點續傳/失敗重試記錄任務狀態,支援手動/自動重試

注意事項

  • 絕對路徑:getRealPath() 在 WAR 未解壓環境可能回傳 null,建議配置外部儲存目錄。
  • 編碼一致:JSP、Servlet、檔案寫入皆使用 UTF-8。
  • 靜態資源引用:生成 HTML 中的 CSS/JS/圖片路徑需為絕對路徑或 CDN 域名。
  • 動態內容:個性化推薦、購物車、用戶資訊等**不適合**全頁靜態化,採用 ESI/片段快取/AJAX 拉取。
  • 清理機制:部署新版本時需清理舊靜態檔,避免殘留垃圾檔案。

現代架構建議

新專案建議採用 **SSG (Static Site Generation)** 框架:Next.js (React)、Nuxt.js (Vue)、Astro、Hugo 等,建置階段直接產出靜態 HTML,部署至 CDN/靜態託管,完全移除 Servlet 容器依賴。舊專案可漸進式引入此 Servlet 方案作為過渡。

copyright © 萬盛學電腦網 all rights reserved