萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 使用 JavaBean 完整實戰:useBean、setProperty、getProperty 標籤詳解

JavaBean 是 JSP 與 Java 邏輯解耦的核心載體。JSP 提供三大標準動作標籤 <jsp:useBean>、<jsp:setProperty>、<jsp:getProperty> 實現 Bean 的實例化、屬性注入與輸出。本文深度解析標籤屬性、作用域語義、自動類型轉換與進階用法。

一、 核心三標籤語法與屬性完整表

1. <jsp:useBean> — 尋找或建立 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>

2. <jsp:setProperty> — 設定 Bean 屬性

<jsp:setProperty 
    name="beanInstanceName"         -- 必填,對應 useBean id
    property="propertyName | *"     -- 單一屬性名 或 * (自動匹配所有請求參數)
    value="explicitValue"           -- 明確指定值 (EL/Scriptlet 可用 ${expr} / <%= %>)
    param="requestParamName"        -- 來源請求參數名 (預設同 property)
/>

property="*" 魔法:自動遍歷 Request 參數,名稱與 Bean 屬性名**完全匹配** (大小寫敏感) 者,調用對應 Setter 並自動類型轉換 (String → int/boolean/Date 等)。

3. <jsp:getProperty> — 輸出 Bean 屬性值

<jsp:getProperty name="beanInstanceName" property="propertyName" />

等同 out.print(bean.getPropertyName()),自動轉字串、處理 null (輸出空字串)、HTML 轉義 (取決於容器實作,建議搭配 JSTL <c:out> 顯式控制)。

二、 實戰範例:表單提交 → Bean 驗證 → 顯示結果

1. JavaBean 定義 (POJO + 驗證邏輯)

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;
    }
}

2. JSP 頁面 (單檔案完整示範)

<%@ 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) 深度解析與選型

Scope生命週期適用場景JSP/Servlet 存取方式
page單次 JSP 處理期間 (含 include)頁面內暫存計算結果、迴圈索引pageContext.getAttribute() / 直接變數名
request單次 HTTP 請求 (含 forward/include)Controller → View 傳遞資料、表單回顯request.get/setAttribute()
session用戶會話期間 (預設 30 分鐘無操作)登入用戶資訊、購物車、權限、多步驟精靈session.get/setAttribute()
applicationWeb 應用存活期間 (重啟失效)全域配置、字典表、共用快取、計數器application.get/setAttribute()
鐵律:選擇**最窄**能滿足需求的 Scope。請求級資料切勿放入 Session,否則造成記憶體洩漏、集群同步開銷、並發修改競態。

四、 進階特性與避坑指南

1. type 屬性實現介面導向

<jsp:useBean id="dao" type="com.example.dao.UserDAO" class="com.example.dao.UserDAOImpl" scope="application" />
  • 頁面/Scriptlet 以 UserDAO 介面型別引用,解耦實作類。
  • 若 Bean 已存在於 application 域,class 可省略 (僅 type)。

2. beanName 載入序列化 Bean / Beans.instantiate

<jsp:useBean id="config" beanName="com.example.ConfigBean.ser" scope="application" type="com.example.ConfigBean" />

Beans.instantiate 支援從 `.ser` 檔案反序列化或實例化類別 (含 Applet/舊版 Bean)。

3. 自動類型轉換規則 (PropertyEditor)

容器內建編輯器支援: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)。

4. 常見錯誤與除錯

現象原因解決
屬性不生效 / 為 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 完整綁定框架

五、 現代化演進:從 JSP 標籤到 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)。
  • 視圖層使用 Thymeleaf/FreeMarker/JSP (EL/JSTL) 渲染,零 Scriptlet。

結語

jsp:useBean/setProperty/getProperty 是 JSP 早期實現「邏輯與視圖分離」的標準化嘗試。雖現代框架以更強大的綁定/驗證/類型轉換機制取代,但理解其**作用域語義、自動繫結規則、生命週期控制**,對維護存量 JSP 系統、閱讀經典教材、設計自定義標籤/EL 函式仍具核心價值。

copyright © 萬盛學電腦網 all rights reserved