| JAR 包 | 來源/用途 | 核心功能 |
|---|---|---|
| struts.jar | Struts 核心 | Controller、Action、Form Bean、標籤庫、配置解析 |
| commons-beanutils.jar | Apache Commons | 動態存取 JavaBean 屬性(反射封裝),省去手寫 get/set |
| commons-digester.jar | Apache Commons | XML→Java 物件映射,Struts 用於解析 struts-config.xml |
| commons-fileupload.jar | Apache Commons | multipart/form-data 檔案上傳解析,支援大檔、進度監聽 |
| commons-validator.jar | Apache Commons | 驗證框架核心:驗證規則、錯誤訊息、國際化支援 |
| jakarta-oro.jar | Apache ORO | 正則表達式引擎(Perl5/AWK/glob),Validator 依賴 |
| commons-collections.jar | Apache Commons | 擴充集合框架:MultiMap, BidiMap, LRUMap, 區間樹等 |
| commons-logging.jar | Apache Commons | 日誌門面:自動發現 Log4j → JUL → SimpleLog |
ObjectCreateRule、SetPropertiesRule、SetNextRule、CallMethodRule<action>、<form-bean>、<forward> 等元素struts-config.dtd 確保配置格式正確<!-- 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>
// 類路徑檢測順序
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 | 缺少依賴 JAR | Maven/Gradle 管理傳遞依賴 |
| NoSuchMethodError | 多版本 JAR 共存 | dependency:tree 分析,排除舊版 |
| Log4j 配置不生效 | commons-logging 綁定錯誤 | 排除 commons-logging,用 jcl-over-slf4j |
| Digester 解析失敗 | DTD 不可達/版本不符 | 確保 struts.jar 版本與 DTD 一致 |
Struts 1 已 EOL。新專案建議:
spring-boot-starter-web 內建 MultipartFile + CommonsMultipartResolverspring-boot-starter-validation (Bean Validation 2.0 / Hibernate Validator)