JavaBean 是 JSP 與 Java 邏輯解耦的核心載體。JSP 提供三大標準動作標籤 <jsp:useBean>、<jsp:setProperty>、<jsp:getProperty> 實現 Bean 的實例化、屬性注入與輸出。本文深度解析標籤屬性、作用域語義、自動類型轉換與進階用法。
<jsp:useBean
id="beanInstanceName" -- 必填,頁面/作用域變數名 (區分大小寫)
class="package.ClassName" -- 實體類全名 (實例化用)
type="package.InterfaceOrSuper" -- 宣告型別 (可為介面/父類),配合 class 使用
scope="page | request | session | application" -- 作用域,預設 page
beanName="package.ClassName | serializedBean.ser" -- 可序列化 Bean 或 java.beans.Beans.instantiate 路徑
>
<!-- 體內容:僅在 Bean 新建立時執行 (初始化邏輯) -->
<jsp:setProperty name="beanInstanceName" property="*" />
</jsp:useBean>
<jsp:setProperty
name="beanInstanceName" -- 必填,對應 useBean id
property="propertyName | *" -- 單一屬性名 或 * (自動匹配所有請求參數)
value="explicitValue" -- 明確指定值 (EL/Scriptlet 可用 ${expr} / <%= %>)
param="requestParamName" -- 來源請求參數名 (預設同 property)
/>
property="*" 魔法:自動遍歷 Request 參數,名稱與 Bean 屬性名**完全匹配** (大小寫敏感) 者,調用對應 Setter 並自動類型轉換 (String → int/boolean/Date 等)。
<jsp:getProperty name="beanInstanceName" property="propertyName" />
等同 out.print(bean.getPropertyName()),自動轉字串、處理 null (輸出空字串)、HTML 轉義 (取決於容器實作,建議搭配 JSTL <c:out> 顯式控制)。
package com.example.model;
import java.time.LocalDate;
import java.util.regex.Pattern;
public class UserForm {
private String username;
private String email;
private Integer age;
private LocalDate birthDate;
private String errorMessage; // 驗證錯誤訊息
// 標準 Getter/Setter
public String getUsername() { return username; }
public void setUsername(String username) { this.username = username; }
// ... email, age, birthDate 同理
public String getErrorMessage() { return errorMessage; }
public void setErrorMessage(String errorMessage) { this.errorMessage = errorMessage; }
// 業務驗證
public boolean validate() {
if (username == null || username.trim().length() < 3) {
errorMessage = "用戶名至少 3 字元";
return false;
}
if (email == null || !Pattern.matches("^[\\w.-]+@[\\w.-]+\\.\\w{2,}$", email)) {
errorMessage = "Email 格式錯誤";
return false;
}
if (age == null || age < 1 || age > 120) {
errorMessage = "年齡需 1~120 之間";
return false;
}
return true;
}
}
<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<%@ taglib prefix="c" uri="jakarta.tags.core" %>
<html><body>
<h2>用戶註冊</h2>
<!-- 1. 宣告 Bean,scope=request 表單提交後同請求可用 -->
<jsp:useBean id="userForm" class="com.example.model.UserForm" scope="request" />
<!-- 2. 自動將請求參數繫結至 Bean (property="*") -->
<jsp:setProperty name="userForm" property="*" />
<form method="post">
用戶名: <input name="username" value="${userForm.username}" /><br/>
Email: <input name="email" value="${userForm.email}" /><br/>
年齡: <input name="age" value="${userForm.age}" /><br/>
<input type="submit" value="提交" />
</form>
<!-- 3. 提交後驗證並顯示結果 -->
<c:if test="${param.username != null}"> <!-- 判斷是否為表單提交 -->
<c:choose>
<c:when test="${userForm.validate()}">
<div style="color:green">註冊成功!</div>
<table>
<tr><th>屬性</th><th>值</th></tr>
<tr><td>用戶名</td><td><jsp:getProperty name="userForm" property="username" /></td></tr>
<tr><td>Email</td><td><jsp:getProperty name="userForm" property="email" /></td></tr>
<tr><td>年齡</td><td><jsp:getProperty name="userForm" property="age" /></td></tr>
</table>
</c:when>
<c:otherwise>
<div style="color:red">錯誤: ${userForm.errorMessage}</div>
</c:otherwise>
</c:choose>
</c:if>
</body></html>
| Scope | 生命週期 | 適用場景 | JSP/Servlet 存取方式 |
|---|---|---|---|
| page | 單次 JSP 處理期間 (含 include) | 頁面內暫存計算結果、迴圈索引 | pageContext.getAttribute() / 直接變數名 |
| request | 單次 HTTP 請求 (含 forward/include) | Controller → View 傳遞資料、表單回顯 | request.get/setAttribute() |
| session | 用戶會話期間 (預設 30 分鐘無操作) | 登入用戶資訊、購物車、權限、多步驟精靈 | session.get/setAttribute() |
| application | Web 應用存活期間 (重啟失效) | 全域配置、字典表、共用快取、計數器 | application.get/setAttribute() |
鐵律:選擇**最窄**能滿足需求的 Scope。請求級資料切勿放入 Session,否則造成記憶體洩漏、集群同步開銷、並發修改競態。
<jsp:useBean id="dao" type="com.example.dao.UserDAO" class="com.example.dao.UserDAOImpl" scope="application" />
UserDAO 介面型別引用,解耦實作類。class 可省略 (僅 type)。<jsp:useBean id="config" beanName="com.example.ConfigBean.ser" scope="application" type="com.example.ConfigBean" />
Beans.instantiate 支援從 `.ser` 檔案反序列化或實例化類別 (含 Applet/舊版 Bean)。
容器內建編輯器支援:String → boolean/Boolean、byte/Byte、short/Short、int/Integer、long/Long、float/Float、double/Double、java.math.BigDecimal、java.util.Date (格式 yyyy-MM-dd)、java.sql.Date/Time/Timestamp、Class、Enum。自訂類型需註冊 PropertyEditor (較少用,現代改用 EL/Converter)。
| 現象 | 原因 | 解決 |
|---|---|---|
| 屬性不生效 / 為 null | 請求參數名與 Bean 屬性名不匹配 (大小寫、下劃線 vs 駝峰) | 檢查 HTML name 屬性、Bean Setter 名稱;用 ${param} 印出所有參數對比 |
| ClassCastException | 同 id 不同 scope 衝突、或 type 與實際類別不符 | 統一 id 命名規範;檢查 class/type 繼承關係 |
| 重複初始化邏輯執行 | <jsp:setProperty> 放在 <jsp:useBean> 體內,但 Bean 已存在 | 移至體外單獨執行,或改用 <c:set target="${userForm}" property="*" /> (JSTL 總執行) |
| 日期/數字轉換失敗 | 輸入格式不符合預設 PropertyEditor | 在 Bean Setter 內自行解析、或用 Spring MVC / Jakarta MVC 完整綁定框架 |
// Spring MVC Controller 等價邏輯
@PostMapping("/register")
public String register(@Valid @ModelAttribute("userForm") UserForm form, BindingResult bindingResult) {
if (bindingResult.hasErrors()) return "register"; // 自動回顯錯誤
userService.register(form);
return "redirect:/success";
}
@ModelAttribute 替代 jsp:useBean + setProperty property="*",支援 JSR-303 Bean Validation (@NotNull, @Size, @Email)、巢狀物件綁定、集合綁定、類型格式化 (@DateTimeFormat)。jsp:useBean/setProperty/getProperty 是 JSP 早期實現「邏輯與視圖分離」的標準化嘗試。雖現代框架以更強大的綁定/驗證/類型轉換機制取代,但理解其**作用域語義、自動繫結規則、生命週期控制**,對維護存量 JSP 系統、閱讀經典教材、設計自定義標籤/EL 函式仍具核心價值。