計算表達式並輸出結果到響應流。轉換為 `out.print(expr)`。
當前時間: <%= new java.util.Date() %>
您的主機: <%= request.getRemoteHost() %>
XML 等價寫法:`
插入任意 Java 代碼至 `_jspService()` 方法。可訪問所有隱含物件。
<%
String queryData = request.getQueryString();
out.println("Attached GET data: " + queryData);
%>
**進階用法:與模板文本交織實現條件輸出**
<% if (Math.random() < 0.5) { %>
Have a nice day!
<% } else { %>
Have a lousy day!
<% } %>
轉換後等效於:
if (Math.random() < 0.5) {
out.println("Have a nice day!");
} else {
out.println("Have a lousy day!");
}
XML 等價:`
在 Servlet 類別層級聲明成員變數、方法 (不在 `_jspService` 內)。
<%! private int accessCount = 0; %>
頁面訪問次數: <%= ++accessCount %>
XML 等價:`
影響 Servlet 類別整體結構,不產生輸出。
| 屬性 | 說明 | 範例 |
|---|---|---|
| import | 導入類/包,可多次使用 | `<%@ page import="java.util.*,java.sql.*" %>` |
| contentType | 響應 MIME 類型與字元集 | `<%@ page contentType="text/html;charset=UTF-8" %>` |
| pageEncoding | JSP 檔案原始碼編碼 | `<%@ page pageEncoding="UTF-8" %>` |
| isThreadSafe | `true`(預設) 多執行緒共用實例;`false` 實作 SingleThreadModel | `<%@ page isThreadSafe="false" %>` |
| session | `true`(預設) 自動建立/綁定 session;`false` 禁用 session 隱含物件 | `<%@ page session="false" %>` |
| buffer | `out` 緩衝區大小,預設 ≥8kb;`none` 關閉緩衝 | `<%@ page buffer="16kb" %>` |
| autoFlush | `true`(預設) 緩衝區滿自動 flush;`false` 拋出異常 (buffer=none 時不可為 false) | `<%@ page autoFlush="false" %>` |
| extends | 指定 Servlet 父類別 (慎用,容器可能已有自定父類) | `<%@ page extends="com.my.BaseServlet" %>` |
| errorPage | 未捕獲異常轉向的錯誤頁面 | `<%@ page errorPage="/error.jsp" %>` |
| isErrorPage | `true` 表示此頁為錯誤頁,可用 exception 隱含物件 | `<%@ page isErrorPage="true" %>` |
| info | Servlet `getServletInfo()` 返回的字串 | `<%@ page info="My JSP Page" %>` |
| language | 腳本語言,預設 `java` | `<%@ page language="java" %>` |
XML 等價:`
**翻譯期包含**:JSP 編譯為 Servlet 時靜態合併目標檔案內容。目標檔可包含 JSP 代碼。適用於靜態頁首/頁尾/導航列,修改後需重新編譯所有引用頁。
| 變量名 | 類型 | 作用域/說明 |
|---|---|---|
| request | HttpServletRequest | 請求範圍,取參數、Header、屬性 |
| response | HttpServletResponse | 響應控制,設標頭、狀態碼、Cookie |
| out | JspWriter (PrintWriter 緩衝版) | 輸出內容,可控制緩衝 |
| session | HttpSession | 會話範圍,自動建立 (除非 page 指令 session=false) |
| application | ServletContext | 應用範圍,全域共享資源、初始化參數 |
| config | ServletConfig | Servlet 初始化參數 |
| pageContext | PageContext | 頁面上下文,封裝其他 8 大物件,提供便利方法 (forward/include/findAttribute) |
| page | Object (this) | 當前 Servlet 實例,極少直接使用 |
| 標籤 | 用途 | 關鍵屬性 |
|---|---|---|
| `jsp:include` | **請求期包含** 動態插入頁面片段 | page, flush="true" |
| `jsp:forward` | 請求轉發至其他資源 | page, 可攜帶 `jsp:param` |
| `jsp:useBean` | 尋找或實例化 JavaBean | id, scope, class, type, beanName |
| `jsp:setProperty` | 設定 Bean 屬性 | name, property, value/param |
| `jsp:getProperty` | 輸出 Bean 屬性值 | name, property |
| `jsp:plugin` | 生成 Applet/JavaBean 的 OBJECT/EMBED 標籤 | type, code, codebase, jreversion... |
| `jsp:param` | 為 include/forward/plugin 提供參數 | name, value |
| `jsp:fallback` | plugin 載入失敗時的替代內容 | — |
| 特性 | include 指令 (`<%@ include %>`) | jsp:include 動作 (` |
|---|---|---|
| 包含時機 | 翻譯期 (編譯時) | 請求期 (執行時) |
| 目標檔案變更 | 需重新編譯引用頁才生效 | 即時生效 |
| 目標檔可含 JSP 代碼 | 是 | 是 (但不能設 HTTP 標頭、改變響應狀態) |
| 效能 | 極高 (合併為單一 Servlet) | 略低 (運行時動態包含) |
| 適用場景 | 靜態片段:頁首、頁尾、版權聲明 | 動態片段:側邊欄、推薦模組、個性化內容 |
<%@ page import="java.util.*" contentType="text/html;charset=UTF-8" %>
<HTML>
<HEAD><TITLE>最新消息</TITLE></HEAD>
<BODY>
<h1>最新消息</h1>
<ol>
<li><jsp:include page="news/item1.jsp" flush="true"/></li>
<li><jsp:include page="news/item2.jsp" flush="true"/></li>
<li><jsp:include page="news/item3.jsp" flush="true"/></li>
<li><jsp:include page="news/item4.jsp" flush="true"/></li>
</ol>
</BODY>
</HTML>
每次請求動態包含最新片段,修改 `item*.jsp` 即時生效,無需重新編譯主頁。