ByteArrayOutputStream 捕獲輸出。HttpServletResponseWrapper 重寫 getOutputStream()、getWriter() 指向捕獲流。RequestDispatcher.include() 執行目標 JSP,輸出導向捕獲流。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>");
}
}
<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>
<%@ 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,建議配置外部儲存目錄。新專案建議採用 **SSG (Static Site Generation)** 框架:Next.js (React)、Nuxt.js (Vue)、Astro、Hugo 等,建置階段直接產出靜態 HTML,部署至 CDN/靜態託管,完全移除 Servlet 容器依賴。舊專案可漸進式引入此 Servlet 方案作為過渡。