萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

HTML 轉 JSP 頁面完整指南:頁面指令、編碼設定、EL 表達式與標籤庫

將靜態 HTML 頁面遷移為 JSP(Jakarta Server Pages),需處理頁面指令、字元編碼、Scriptlet 與 EL 表達式轉換、JSTL 標籤庫引入等關鍵步驟。本文提供完整遷移清單與對照範例。

一、JSP 頁面基本骨架

<%@ 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 回應標頭編碼
  • 兩者**必須一致**,否則中文亂碼
  • 舊版 Tomcat 7/8 用 uri="https://java.sun.com/jsp/jstl/core"

二、常見 HTML → JSP 轉換對照表

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 變數注入

三、字元編碼完整設定(防亂碼三部曲)

  1. JSP 頁面指令:<%@ page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>
  2. HTML meta:<meta charset="UTF-8">
  3. 3. 伺服器/資料庫:URIEncoding="UTF-8" (Tomcat server.xml)、DB 連線 characterEncoding=UTF-8

常見錯誤:JSP 儲存為 Big5/GBK,但 pageEncoding 寫 UTF-8 → 編譯錯誤或亂碼。

四、Scriptlet(<% %>)vs EL(${})vs JSTL(<c:>)

寫法範例優/缺點建議
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=trueweb.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/Gradle)

<!-- 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 範本檔,新頁面直接複製修改,確保一致性。

copyright © 萬盛學電腦網 all rights reserved