Expression Language (EL) 專為 JSP 頁面設計,提供**簡潔的數據訪問與表達式計算能力**,替代 Scriptlet 中的 Java 代碼,實現「零 Java 代碼」模板頁面。JSP 2.0 起成為標準規範,默認啟用。
${expression}1. [] . // 屬性/集合訪問
2. () // 分組/函數調用
3. - (unary) ! not empty // 一元運算
4. * / div % mod // 乘除
5. + - (binary) // 加減
6. < > <= >= lt gt le ge // 關系
7. == != eq ne // 相等
8. && and // 邏輯與
9. || or // 邏輯或
10. ? : // 三元 ${cond ? yes : no}
| 運算符 | 行為 | 示例 | |
|---|---|---|---|
| empty | 前綴運算符,判斷 null/空串/空集合/空Map/長度0數組 | ${empty list} → true | |
| div / mod | 除法/取餘,避免與路徑分隔符衝突 | ${10 div 3} = 3.33, ${10 mod 3} = 1 | |
| eq/ne/lt/gt/le/ge | 字母形式關系運算符,避免 XML 轉義 | ${age ge 18} | |
| and/or/not | 邏輯運算符字母形式 | ${not empty list and user.active} | |
| ? : | 三元運算,EL 獨有 (JSP 2.2+) | ${user.vip ? 'VIP' : '普通'} |
| 對象 | 映射來源 | 等價 Java 代碼 | 典型用例 |
|---|---|---|---|
| pageScope | PageContext (PAGE_SCOPE) | pageContext.getAttribute(name, PAGE_SCOPE) | ${pageScope.tempVar} |
| requestScope | ServletRequest | request.getAttribute(name) | ${requestScope.formData} |
| sessionScope | HttpSession | session.getAttribute(name) | ${sessionScope.currentUser} |
| applicationScope | ServletContext | application.getAttribute(name) | ${applicationScope.appConfig} |
| param | 單值請求參數 | request.getParameter(name) | ${param.id} |
| paramValues | 多值請求參數 | request.getParameterValues(name) | ${paramValues.ids[0]} |
| header | 單值請求頭 | request.getHeader(name) | ${header['User-Agent']} |
| headerValues | 多值請求頭 | request.getHeaders(name) | ${headerValues.Accept} |
| cookie | Cookie 對象 Map | Arrays.stream(request.getCookies()).collect(...) | ${cookie.JSESSIONID.value} |
| initParam | 上下文初始化參數 | application.getInitParameter(name) | ${initParam.dbUrl} |
| pageContext | PageContext 對象本身 | pageContext | ${pageContext.request.contextPath} |
${username} 依次搜索:`pageScope` → `requestScope` → `sessionScope` → `applicationScope`,找到即返回,**不拋異常,未找到返回空串**。
${user.name} // Bean 屬性 → user.getName()
${user['name']} // Map/Bean 通用,支持特殊鍵名
${user.address.city} // 鏈式訪問,中間 null 安全返回空串
${list[0]} // List/數組 索引訪問
${map.key} // Map 鍵訪問
${map['key.with.dot']} // 包含特殊字符的鍵
${fn:length(list)} // JSTL 函數獲取長度
package com.example.el;
public class StringUtils {
public static String truncate(String str, int len) {
if (str == null) return "";
return str.length() > len ? str.substring(0, len) + "..." : str;
}
public static String formatMoney(long cents) {
return String.format("¥%,.2f", cents / 100.0);
}
public static boolean containsIgnoreCase(String src, String target) {
return src != null && target != null && src.toLowerCase().contains(target.toLowerCase());
}
}
/WEB-INF/tlds/el-functions.tld<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.1" xmlns="https://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="https://java.sun.com/xml/ns/javaee web-jsptaglibrary_2_1.xsd">
<tlib-version>1.0</tlib-version>
<short-name>elfn</short-name>
<uri>https://example.com/el-functions</uri>
<function>
<name>truncate</name>
<function-class>com.example.el.StringUtils</function-class>
<function-signature>java.lang.String truncate(java.lang.String, int)</function-signature>
</function>
<function>
<name>formatMoney</name>
<function-class>com.example.el.StringUtils</function-class>
<function-signature>java.lang.String formatMoney(long)</function-signature>
</function>
<function>
<name>containsIgnoreCase</name>
<function-class>com.example.el.StringUtils</function-class>
<function-signature>java.lang.Boolean containsIgnoreCase(java.lang.String, java.lang.String)</function-signature>
</function>
</taglib>
<%@ taglib prefix="elfn" uri="https://example.com/el-functions" %>
<!-- 或 uri="/WEB-INF/tlds/el-functions.tld" -->
<p>摘要: ${elfn:truncate(article.content, 200)}</p>
<p>價格: ${elfn:formatMoney(product.priceInCents)}</p>
<c:if test="${elfn:containsIgnoreCase(user.bio, 'java')}">
<span class="tag">Java 開發者</span>
</c:if>
<%@ page isELIgnored="true" %> <!-- 頁面級 -->
<!-- web.xml 全局 -->
<jsp-config>
<jsp-property-group>
<url-pattern>*.jsp</url-pattern>
<el-ignored>true</el-ignored>
</jsp-property-group>
</jsp-config>
<!-- TLD 定義函數簽名為無參靜態方法 -->
<function-signature>java.lang.String getStatusName()</function-signature>
<!-- Java -->
public enum OrderStatus { PAID("已支付"), SHIPPED("已發貨");
private String name;
public String getStatusName() { return name; }
}
<!-- JSP -->
${elfn:getStatusName(order.status)}
model.addAttribute("fmtDate", new SimpleDateFormat("yyyy-MM-dd").format(date))${elfn:formatDate(date, 'yyyy-MM-dd')}<fmt:formatDate value="${date}" pattern="yyyy-MM-dd"/> (推薦)<!-- 方案 1: JSTL c:out (默認轉義) -->
<c:out value="${user.input}"/>
<!-- 方案 2: EL 函數 -->
${fn:escapeXml(user.input)}
<!-- 方案 3: Spring MVC 標籤 -->
<spring:escapeBody htmlEscape="true">${user.input}</spring:escapeBody>
${user.nickname ?: '匿名用戶'} <-- EL 3.0 Elvis 運算符 (Tomcat 9+/Jetty 9.4+) -->
${not empty user.nickname ? user.nickname : '匿名用戶'} <-- 通用寫法 -->
${fn:substring(user.bio, 0, 50)} <-- 截取 -->
<pre>${pageScope}</pre> (輸出 Map toString)