將靜態 HTML 頁面遷移為 JSP(Jakarta Server Pages),需處理頁面指令、字元編碼、Scriptlet 與 EL 表達式轉換、JSTL 標籤庫引入等關鍵步驟。本文提供完整遷移清單與對照範例。
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>
<%@ taglib prefix="c" uri="jakarta.tags.core" %> <!-- Jakarta EE 9+ -->
<%@ taglib prefix="fmt" uri="jakarta.tags.fmt" %>
<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta charset="UTF-8">
<title><c:out value="${pageTitle}" /></title>
</head>
<body>
<h1><c:out value="${pageTitle}" /></h1>
</body>
</html>
關鍵點:
pageEncoding="UTF-8":JSP 檔案本身編碼(對應編輯器存檔編碼)contentType="text/html; charset=UTF-8":HTTP 回應標頭編碼uri="https://java.sun.com/jsp/jstl/core"| HTML 靜態寫法 | JSP 動態寫法 | 說明 |
|---|---|---|
<title>標題</title> | <title><c:out value="${title}" /></title> | EL 輸出 + XSS 防護 |
<a href="/user/123"> | <a href="<c:url value='/user/${user.id}' />"> | 自動加上 context path |
<img src="/img/logo.png"> | <img src="<c:url value='/img/logo.png' />"> | 同上 |
<input value="John"> | <input value="<c:out value='${user.name}' />"> | 屬性值需雙重引號 |
<span>Hello</span> | <c:out value="${msg}" /> 或 ${msg}(需確保已轉義) | EL 直接輸出不轉義 |
<!-- 註解 --> | <%-- JSP 註解,不輸出到瀏覽器 --%> | 原始碼隱藏 |
<script>var x=1;</script> | <script>var x = <c:out value="${num}" />;</script> | JS 變數注入 |
<%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %><meta charset="UTF-8">URIEncoding="UTF-8" (Tomcat server.xml)、DB 連線 characterEncoding=UTF-8
常見錯誤:JSP 儲存為 Big5/GBK,但 pageEncoding 寫 UTF-8 → 編譯錯誤或亂碼。
| 寫法 | 範例 | 優/缺點 | 建議 |
|---|---|---|---|
| Scriptlet | <% out.print(user.getName()); %> | 邏輯混雜、難維護、不支援 EL 隱性 null 安全 | **棄用** |
| EL 表達式 | ${user.name} | 簡潔、自動轉型、null 安全、但**不轉義 HTML** | 僅用於屬性值/JS 變數/已知安全內容 |
| JSTL <c:out> | <c:out value="${user.name}" /> | **自動 HTML 轉義**、支援 default、escapeXml | **首選**輸出到 HTML 內容 |
| JSTL <c:if/choose/forEach> | 流程控制 | 取代 Scriptlet 邏輯 | 大量使用 |
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>
<%@ taglib prefix="c" uri="jakarta.tags.core" %>
<%@ taglib prefix="fmt" uri="jakarta.tags.fmt" %>
<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta charset="UTF-8">
<title><c:out value="${category.name}" /> - 商品列表</title>
<link rel="stylesheet" href="<c:url value='/css/style.css' />">
</head>
<body>
<nav><a href="<c:url value='/' />">首頁</a> > <c:out value="${category.name}" /></nav>
<table class="product-table">
<thead><tr><th>圖片</th><th>名稱</th><th>價格</th><th>庫存</th></tr></thead>
<tbody>
<c:forEach var="p" items="${products}">
<tr>
<td><img src="<c:url value='/img/${p.image}' />" alt="<c:out value="${p.name}" />" loading="lazy"></td>
<td><a href="<c:url value='/product/${p.id}' />"><c:out value="${p.name}" /></a></td>
<td><fmt:formatNumber value="${p.price}" type="currency" currencyCode="TWD" /></td>
<td><c:choose>
<c:when test="${p.stock gt 0}">有貨 (<c:out value="${p.stock}" />)</c:when>
<c:otherwise><span class="out-of-stock">缺貨</span></c:otherwise>
</c:choose></td>
</tr>
</c:forEach>
</tbody>
</table>
<!-- 分頁 -->
<nav aria-label="分頁">
<c:forEach var="i" begin="1" end="${totalPages}">
<a href="<c:url value='/category/${category.id}'><c:param name='page' value='${i}' /></c:url>"
class="<c:if test="${i == currentPage}">active</c:if>">${i}</a>
</c:forEach>
</nav>
</body>
</html>
| 問題 | 原因 | 解決 |
|---|---|---|
| 中文亂碼 | pageEncoding ≠ 檔案實際編碼 ≠ contentType | 三者統一 UTF-8,編輯器存檔確認 |
| EL 表達式不解析,原樣輸出 | web.xml servlet-version < 2.4 / isELIgnored=true | web.xml 設 <el-ignored>false</el-ignored> 或升級 Servlet 版本 |
| JSTL 標籤不生效 | 缺少 jstl-api / jstl-impl jar,或 uri 錯誤 | Maven 引入 jakarta.servlet.jsp.jstl:jakarta.servlet.jsp.jstl-api / impl |
| 相對路徑 404 | 未加 context path | 全域用 <c:url> 或 ${pageContext.request.contextPath} |
| XSS 漏洞 | 直接用 ${} 輸出使用者輸入 | 統一用 <c:out> 或框架內建轉義(Thymeleaf、Freemarker) |
<!-- Maven -->
<dependency>
<groupId>jakarta.servlet.jsp.jstl</groupId>
<artifactId>jakarta.servlet.jsp.jstl-api</artifactId>
<version>2.0.0</version>
</dependency>
<dependency>
<groupId>org.glassfish.web</groupId>
<artifactId>jakarta.servlet.jsp.jstl</artifactId>
<version>2.0.0</version>
</dependency>
遵循「頁面指令統一編碼、EL/JSTL 取代 Scriptlet、<c:url> 處理路徑、<c:out> 防 XSS」四大原則,HTML 轉 JSP 遷移將順利且安全。建議建立專案專屬的 JSP 範本檔,新頁面直接複製修改,確保一致性。