JSP HttpServletResponse 回應物件完整指南

HttpServletResponse 代表伺服器對客戶端的 HTTP 回應。JSP 隱含物件 response 即為其實例，提供設定狀態碼、標頭、Cookie、輸出流、編碼、緩衝區控制等功能。

HTTP 回應結構

HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Set-Cookie: JSESSIONID=abc123; Path=/; HttpOnly
Cache-Control: no-cache
Content-Length: 1234

<!DOCTYPE html>
<html>...</html>

• 狀態行：版本、狀態碼、原因短語
• 回應標頭：Key-Value 配對
• 空行
• 回應主體：HTML、JSON、圖片、檔案等

核心 API 分類速查

1. 狀態碼與重導向

2. 標頭操作

3. 內容型別與編碼

4. Cookie 管理

5. 輸出流與緩衝區

6. URL 重寫 (支援無 Cookie 環境)

實作範例

1. 輸出 JSON (REST API 常用)

<%@ page contentType="application/json;charset=UTF-8" %>
<%
  response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
  response.setHeader("Pragma", "no-cache");
  response.setDateHeader("Expires", 0);
  
  String json = "{\"status\":\"ok\",\"data\":{\"id\":1,\"name\":\"Demo\"}}";
  out.print(json);
%>

2. 下載檔案 (附件模式)

<%@ page import="java.io.*, jakarta.servlet.http.*" %>
<%
  String filePath = application.getRealPath("/WEB-INF/files/report.pdf");
  File file = new File(filePath);
  
  response.setContentType("application/pdf");
  response.setContentLengthLong(file.length());
  response.setHeader("Content-Disposition", "attachment; filename=\"" + 
      java.net.URLEncoder.encode("報表.pdf", "UTF-8") + "\"");
  
  try (FileInputStream fis = new FileInputStream(file);
       ServletOutputStream sos = response.getOutputStream()) {
    byte[] buf = new byte[4096];
    int len;
    while ((len = fis.read(buf)) > 0) sos.write(buf, 0, len);
  }
%>

3. 圖片驗證碼輸出 (二進位流)

<%@ page import="java.awt.*, java.awt.image.*, javax.imageio.*, jakarta.servlet.*" %>
<%
  response.setContentType("image/png");
  response.setHeader("Cache-Control", "no-store");
  response.setDateHeader("Expires", 0);
  
  // 產生驗證碼圖片邏輯...
  BufferedImage img = new BufferedImage(100, 40, BufferedImage.TYPE_INT_RGB);
  Graphics2D g = img.createGraphics();
  // ... 繪製文字、干擾線 ...
  g.dispose();
  
  ImageIO.write(img, "PNG", response.getOutputStream());
%>

4. 自動刷新頁面 (Refresh 標頭)

<%
  // 5 秒後重導向至首頁
  response.setIntHeader("Refresh", 5);
  // 或 5 秒後重導向指定 URL
  // response.setHeader("Refresh", "5; url=" + request.getContextPath() + "/index.jsp");
%>
<html><body>
  <h2>5 秒後自動跳轉...</h2>
</body></html>

5. 防快取設定 (登入後頁面必須)

<%
  response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate"); // HTTP 1.1
  response.setHeader("Pragma", "no-cache"); // HTTP 1.0
  response.setDateHeader("Expires", 0); // Proxies
%>

JSP out 物件 vs response.getWriter()

• out 是 JspWriter，支援緩衝區控制 (page 指令 buffer、autoFlush)，例外為 IOException。
• response.getWriter() 直接取得 PrintWriter，無 JSP 緩衝區包裝。
• 一般 JSP 使用 out 或 <%= %> 即可；Servlet 中才用 response.getWriter()。

常見錯誤與除錯