在 JSP 頁面轉換為 Servlet 後,out 隱含對象對應 javax.servlet.jsp.JspWriter 實例,繼承自 java.io.Writer。它是頁面輸出的核心管道,理解其緩衝區行為對性能調優、避免 IllegalStateException 至關重要。
| 方法 | 說明 |
|---|---|
clear() | 清空緩衝區,不輸出至客戶端 |
clearBuffer() | 清空緩衝區,並將內容輸出至客戶端 |
close() | 關閉輸出流 |
flush() | 強制刷新緩衝區至客戶端 |
getBufferSize() | 返回緩衝區大小(字節) |
getRemaining() | 返回緩衝區剩餘空間 |
isAutoFlush() | 返回 page 指令 autoFlush 設定值 |
newLine() | 輸出換行符 |
print(...) | 輸出數據,不換行 |
println(...) | 輸出數據並換行 |
<%@ page autoFlush="true|false" %>
flush() 前不創建 PrintWriter,響應提交延遲至首次刷新。PrintWriter,需顯式 flush() 輸出;緩衝區滿拋 IOException。| 場景 | 建議設置 | 理由 |
|---|---|---|
| 常規頁面、模板引擎輸出 | autoFlush="true", buffer="8kb/16kb" | 平衡響應延遲與網絡傳輸效率 |
| 大文件下載、流式傳輸 | autoFlush="false", buffer="none" 或極小 | 實時性優先,避免緩衝區佔用大內存 |
| 需在提交前修改 Header/Cookie | autoFlush="true" + 足夠 buffer | 確保緩衝區未滿前可調用 response.setHeader/addCookie |
out 與 response.getOutputStream()。response.isCommitted() 或增大 buffer。<jsp:include flush="true"> 強制刷新;forward 前需 clear() 避免殘留輸出。掌握 out 的緩衝區生命週期,是從「能跑通」走向「高性能、穩健」JSP 開發的關鍵一步。