萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Struts 核心依賴包詳解:commons 系列與核心組件

Struts 1.x 必備 JAR 包清單

JAR 包來源/用途核心功能
struts.jarStruts 核心Controller、Action、Form Bean、標籤庫、配置解析
commons-beanutils.jarApache Commons動態存取 JavaBean 屬性(反射封裝),省去手寫 get/set
commons-digester.jarApache CommonsXML→Java 物件映射,Struts 用於解析 struts-config.xml
commons-fileupload.jarApache Commonsmultipart/form-data 檔案上傳解析,支援大檔、進度監聽
commons-validator.jarApache Commons驗證框架核心:驗證規則、錯誤訊息、國際化支援
jakarta-oro.jarApache ORO正則表達式引擎(Perl5/AWK/glob),Validator 依賴
commons-collections.jarApache Commons擴充集合框架:MultiMap, BidiMap, LRUMap, 區間樹等
commons-logging.jarApache Commons日誌門面:自動發現 Log4j → JUL → SimpleLog

深度解析關鍵組件

commons-digester:XML 配置解析引擎

  • 規則基礎:ObjectCreateRule、SetPropertiesRule、SetNextRule、CallMethodRule
  • Struts 內建規則解析 <action>、<form-bean>、<forward> 等元素
  • DTD 驗證:struts-config.dtd 確保配置格式正確

commons-validator:聲明式驗證框架

<!-- validator-rules.xml 內建驗證器 -->
<validator name="required" classname="org.apache.commons.validator.FieldChecks"
           method="validateRequired" methodParams="java.lang.Object,org.apache.commons.validator.Field" />
<validator name="email" classname="org.apache.commons.validator.FieldChecks"
           method="validateEmail" ... />

<!-- validation.xml 表單驗證規則 -->
<form name="userForm">
    <field property="email" depends="required,email">
        <arg key="userForm.email" />
    </field>
</form>

commons-logging:日誌適配器機制

// 類路徑檢測順序
1. Log4j (log4j.jar + log4j.properties/xml)
2. JDK 1.4+ java.util.logging (JUL)
3. SimpleLog (內建,輸出至 System.err)

建議:生產環境明確引入 log4j2 或 slf4j + logback,排除 commons-logging 避免類載入衝突。

常見版本衝突與解決

問題原因解決
ClassNotFoundException缺少依賴 JARMaven/Gradle 管理傳遞依賴
NoSuchMethodError多版本 JAR 共存dependency:tree 分析,排除舊版
Log4j 配置不生效commons-logging 綁定錯誤排除 commons-logging,用 jcl-over-slf4j
Digester 解析失敗DTD 不可達/版本不符確保 struts.jar 版本與 DTD 一致

現代化替代

Struts 1 已 EOL。新專案建議:

  • Spring Boot + Spring MVC(內建 Tomcat、自動配置、Starter 依賴)
  • Spring Boot 2.3+ 已移除對 commons-logging 的強依賴,預設 Logback
  • 檔案上傳:spring-boot-starter-web 內建 MultipartFile + CommonsMultipartResolver
  • 驗證:spring-boot-starter-validation (Bean Validation 2.0 / Hibernate Validator)
copyright © 萬盛學電腦網 all rights reserved