JSP 輸出語法全面解析

JSP 提供了多種輸出內容到響應流的方式，每種方式都有其特定的使用場景和特點。以下是 JSP 輸出語法的詳細解析。

總結

• JSP直接編寫普通字符串
  • 翻譯到service方法的out.write(“這里面”)
• <%%>
  • 翻譯到service方法體內部，里面是一條一條Java語句
• <%！%>
  • 翻譯到service方法體外部
• <%=%>
  • 翻譯到service方法體內部，翻譯為：out.print();
• <%@page contentType=“text/html;charset=UTF-8”%>
  • page指令，通過contentType屬性用來設置響應的內容類型。

一、JSP 輸出方式概覽

輸出方式	語法	特點	適用場景
表達式輸出	<%= %>	簡單直接，自動轉換為字符串	簡單變量輸出
out 對象輸出	<% out.print(); %>	顯式控制輸出	條件輸出、循環輸出
EL 表達式	${}	簡潔，自動空值處理	屬性值輸出
JSTL 標簽	<c:out>	安全，可防止 XSS	需要轉義的用戶輸入
指令包含輸出	<%@ include %>	靜態包含，編譯時合并	復用頁面片段

二、詳細語法解析

1. JSP 表達式輸出 (Expression)

語法：<%= expression %>

特點：

• 表達式會被計算并轉換為字符串
• 自動添加到輸出流中
• 不需要分號結尾

示例：

<%String name = "張三";int age = 25;java.util.Date now = new java.util.Date();
%><p>姓名: <%= name %></p>
<p>年齡: <%= age %></p>
<p>當前時間: <%= now %></p>
<p>計算表達式: <%= 10 + 5 * 2 %></p>
<p>方法調用: <%= name.toUpperCase() %></p>

底層原理：
表達式會被轉換為 Servlet 中的 out.print() 調用：

out.print(name);
out.print(age);
// ...

2. out 對象輸出

語法：<% out.print(expression); %>

特點：

• 顯式控制輸出
• 可以在腳本片段中使用
• 需要分號結尾

示例：

<%String[] colors = {"紅色", "綠色", "藍色"};for(String color : colors) {out.print("<li>" + color + "</li>");}// 條件輸出boolean isAdmin = true;if(isAdmin) {out.print("<button>管理功能</button>");}
%>

3. EL 表達式輸出 (Expression Language)

語法：${expression}

特點：

• 簡潔易讀
• 自動處理 null 值（不會拋出異常）
• 支持屬性訪問和方法調用
• 支持各種運算符

示例：

<!-- 屬性訪問 -->
<p>用戶: ${user.name}</p>
<p>年齡: ${user.age}</p><!-- 集合訪問 -->
<p>第一個元素: ${items[0]}</p>
<p>Map值: ${map.key}</p><!-- 運算符 -->
<p>結果: ${10 + 5 * 2}</p>
<p>比較: ${user.age > 18}</p>
<p>條件: ${not empty user ? user.name : '游客'}</p><!-- 方法調用 -->
<p>長度: ${user.name.length()}</p>

4. JSTL 標簽輸出

語法：<c:out value="${expression}" />

特點：

• 自動轉義 HTML 特殊字符，防止 XSS 攻擊
• 支持默認值設置
• 更安全的內容輸出

示例：

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><!-- 基本輸出 -->
<c:out value="${user.name}" /><!-- 帶默認值 -->
<c:out value="${user.email}" default="未設置郵箱" /><!-- 禁用轉義 (謹慎使用) -->
<c:out value="${htmlContent}" escapeXml="false" /><!-- 條件輸出 -->
<c:if test="${not empty user}"><c:out value="${user.name}" />
</c:if>

5. 指令包含輸出

語法：<%@ include file="path" %>

特點：

• 靜態包含，在編譯時合并文件內容
• 共享相同的變量和上下文
• 適用于復用公共頁面片段

示例：

<!-- header.jsp -->
<header><h1>網站標題</h1><nav>導航菜單</nav>
</header><!-- main.jsp -->
<%@ include file="header.jsp" %>
<main><p>主內容區域</p>
</main>
<%@ include file="footer.jsp" %>

三、輸出語法對比與選擇

性能比較

方式	性能	說明
表達式輸出	高	直接轉換為 out.print()
out 對象輸出	高	直接調用 out 方法
EL 表達式	中	需要解析表達式
JSTL 標簽	中低	需要標簽庫支持

安全性比較

方式	安全性	說明
表達式輸出	低	直接輸出，可能 XSS
out 對象輸出	低	直接輸出，可能 XSS
EL 表達式	中	自動空值處理，但可能 XSS
JSTL 標簽	高	默認轉義，防止 XSS

四、最佳實踐與示例

1. 安全輸出示例

<%// 用戶輸入可能包含惡意腳本String userInput = "<script>alert('XSS')</script>安全內容";
%><!-- 危險：直接輸出 -->
<p><%= userInput %></p> <!-- 會執行腳本! --><!-- 安全：使用 JSTL 轉義 -->
<p><c:out value="${userInput}" /></p> <!-- 顯示為文本 --><!-- 安全：手動轉義 -->
<%String safeOutput = userInput.replace("&", "&amp;").replace("<", "&lt;").replace(">", "&gt;").replace("\"", "&quot;").replace("'", "&#39;");
%>
<p><%= safeOutput %></p>

2. 復雜數據輸出

<%// 復雜對象class User {public String name;public int age;public String[] hobbies;public User(String name, int age, String[] hobbies) {this.name = name;this.age = age;this.hobbies = hobbies;}}User user = new User("李四", 30, new String[]{"閱讀", "運動", "音樂"});pageContext.setAttribute("currentUser", user);
%><!-- 使用 EL 表達式 -->
<h2>用戶信息</h2>
<p>姓名: ${currentUser.name}</p>
<p>年齡: ${currentUser.age}</p>
<p>愛好: <c:forEach items="${currentUser.hobbies}" var="hobby" varStatus="status">${hobby}<c:if test="${not status.last}">, </c:if></c:forEach>
</p><!-- 使用腳本和表達式 -->
<h2>用戶信息</h2>
<p>姓名: <%= user.name %></p>
<p>年齡: <%= user.age %></p>
<p>愛好: <%for(int i = 0; i < user.hobbies.length; i++) {out.print(user.hobbies[i]);if(i < user.hobbies.length - 1) {out.print(", ");}}%>
</p>

3. 條件輸出示例

<%boolean isLoggedIn = true;String userRole = "admin";int messageCount = 0;
%><!-- 使用腳本 -->
<%if(isLoggedIn) {out.print("<p>歡迎回來!</p>");} else {out.print("<p>請先登錄</p>");}
%><!-- 使用表達式和三元運算符 -->
<p><%= isLoggedIn ? "歡迎回來!" : "請先登錄" %></p><!-- 使用 EL 表達式 -->
<p>${isLoggedIn ? "歡迎回來!" : "請先登錄"}</p><!-- 使用 JSTL -->
<c:choose><c:when test="${isLoggedIn && userRole == 'admin'}"><p>歡迎管理員!</p></c:when><c:when test="${isLoggedIn}"><p>歡迎回來!</p></c:when><c:otherwise><p>請先登錄</p></c:otherwise>
</c:choose><!-- 條件顯示消息數量 -->
<c:if test="${messageCount > 0}"><p>您有 ${messageCount} 條新消息</p>
</c:if>

五、常見錯誤與解決方法

1. 表達式語法錯誤

<!-- 錯誤：表達式中有分號 -->
<p><%= name; %></p>  <!-- 編譯錯誤 --><!-- 正確 -->
<p><%= name %></p>

2. 空指針異常

<%String nullValue = null;
%><!-- 錯誤：可能空指針 -->
<p><%= nullValue.length() %></p>  <!-- 運行時異常 --><!-- 正確：使用 EL 表達式 -->
<p>${nullValue.length()}</p>  <!-- 輸出空字符串，不報錯 --><!-- 正確：使用條件判斷 -->
<p><%= nullValue != null ? nullValue.length() : "空值" %></p>

3. HTML 轉義問題

<%String text = "歡迎使用<br>標簽";
%><!-- 錯誤：可能意外渲染 HTML -->
<p><%= text %></p>  <!-- "br" 會被瀏覽器解析為換行 --><!-- 正確：使用 JSTL 轉義 -->
<p><c:out value="${text}" /></p>  <!-- 顯示原始文本 -->

六、性能優化建議

1. 減少腳本片段使用：盡量使用 EL 表達式和 JSTL

2. 避免在循環中創建對象：

   <!-- 不佳 -->
   <% for(int i = 0; i < 100; i++) { %><%= new java.util.Date() %>  <!-- 每次循環創建新對象 -->
   <% } %><!-- 優化 -->
   <% java.util.Date now = new java.util.Date(); %>
   <% for(int i = 0; i < 100; i++) { %><%= now %>  <!-- 復用同一對象 -->
   <% } %>
   

3. 使用適當的作用域：合理使用 page、request、session 和 application 作用域

總結

JSP 提供了多種輸出語法，各有優缺點：

1. 表達式輸出 (<%= %>)：簡單直接，適合簡單輸出
2. out 對象輸出：靈活控制，適合復雜邏輯
3. EL 表達式 (${})：簡潔安全，適合屬性訪問
4. JSTL 標簽 (<c:out>)：最安全，適合用戶輸入
5. 指令包含：代碼復用，適合頁面片段

最佳實踐推薦：

• 優先使用 EL 表達式和 JSTL 標簽
• 對用戶輸入內容始終進行轉義
• 避免在 JSP 中編寫復雜業務邏輯
• 合理選擇變量的作用域

通過合理選擇和組合這些輸出方式，可以編寫出既安全又高效的 JSP 頁面。