Struts 源碼最新版本為 struts-1.3.8-src.zip （ 12-Mar-2007 00:06 ）

學習筆記使用 struts-1.3.5-src.zip 的源碼，

下載地址： http://archive.apache.org/dist/struts/source/

1． ? 在 web.xml 中通過下面定義把所有的 *.do 交給 ActionServlet 處理

?

<!-- Standard Action Servlet Configuration (with debugging) -->

<servlet>

??? <servlet-name>action</servlet-name>

??? <servlet-class> org.apache.struts.action. ActionServlet </servlet-class>

??? <init-param>

????? <param-name>config</param-name>

????? <param-value>

????????? /WEB-INF/struts-config.xml,

????????? /WEB-INF/struts-config-Wildcard.xml

?????? </param-value>

??? </init-param>

??? <load-on-startup>2</load-on-startup>

? </servlet>

?

? <!-- Standard Action Servlet Mapping -->

? <servlet-mapping>

??? <servlet-name>action</servlet-name>

??? <url-pattern> *.do </url-pattern>

? </servlet-mapping>

?

2． ? 下面研究一下 struts 的源碼，由于 servlet 設置了 load-on-startup ，所以 tomcat 啟動時會加載 ActionServlet ，也就是會執行 ActionServlet 中的 init() 方法， Struts 的初始化實現就是在這里實現的 。

?

注： 由于 servlet 的生命周期為 web 容器加載和實例化類 / init() 初始化 / service() 請求處理 / destroy() 四個階段，而 init() 方法在 tomcat 啟動后只執行一次，所以如果想在 tomcat 啟動后用 debug 模式 查看 ActionServlet 中 init() 方法的執行，可以把上面的 <load-on-startup>2</load-on-startup> 注釋掉就可以了（不過真正開發時還是需要的）。

?

3． ? 在 ActionServlet 中定義了一些常量，如下：

??? // 默認的 struts 配置文件為 /WEB-INF/struts-config.xml

??? protected String config = "/WEB-INF/struts-config.xml"; // ② initOther(); ⑤ initModuleConfig ();

?

??? // 默認的鏈（定義了一個按順序執行的處理流程）配置文件

protected String chainConfig = "org/apache/struts/chain/chain-config.xml";

// ④ initChain();

?

protected Digester configDigester = null; // ⑤ initModuleConfig ();

// 如 convertNull 為 true ， Java 包裝類（如 java.lang.Integer ）的初始值為 null

protected boolean convertNull = false; // ② initOther();

?

protected MessageResources internal = null; // ① initInternal();

// 默認的 struts-core-1.3.5.jar 包 中資源文件為 ActionResources.properties

protected String internalName = "org.apache.struts.action.ActionResources";

// ① initInternal();

?

// 一些文檔類型定義，用來驗證相應的配置文件如 struts-config.xml 是否正確

??? protected String[] registrations =

??????? {

??????????? "-//Apache Software Foundation//DTD Struts Configuration 1.0//EN",

??????????? "/org/apache/struts/resources/struts-config_1_0.dtd",

????????? ?? "-//Apache Software Foundation//DTD Struts Configuration 1.1//EN",

??????????? "/org/apache/struts/resources/struts-config_1_1.dtd",

??????????? "-//Apache Software Foundation//DTD Struts Configuration 1.2//EN",

??????????? "/org/apache/struts/resources/struts-config_1_2.dtd",

??????????? "-//Apache Software Foundation//DTD Struts Configuration 1.3//EN",

??????????? "/org/apache/struts/resources/struts-config_1_3.dtd",

??????????? "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN",

??????????? "/org/apache/struts/resources/web-app_2_3.dtd"

??????? }; // ③ initServlet();

??? protected String servletMapping = null; // ③ initServlet();

protected String servletName = null; // ③ initServlet();

?

4． ? ActionServlet 中的 init() 方法執行流程如下

?

?

① 內部資源文件 ActionResources.properties 的初始化 initInternal();

protected MessageResources internal = null; // ① initInternal();

protected String internalName = "org.apache.struts.action.ActionResources"; // ① initInternal();

?

// initInternal 方法中通過下面得到一個 MessageResources 對象

internal = MessageResources. getMessageResources ( internalName );

此資源文件主要包括一些消息信息的定義 , 具體可參考 org.apache.struts.action 下的 ActionResources.properties 文件

?

在 MessageResources.java 中的 getMessageResources 方法，

??????? if (defaultFactory == null) {

??????????? defaultFactory = MessageResourcesFactory. createFactory (); // ⑴

??????? }

??????? return defaultFactory. createResources (config); // 傳入 internalName // ⑵

?

⑴

MessageResourcesFactory. createFactory () 所做的工作：

protected static transient Class clazz = null;

protected static String factoryClass =

??????? "org.apache.struts.util. PropertyMessageResourcesFactory ";

clazz = RequestUtils.applicationClass ( factoryClass );

而 RequestUtils.applicationClass 通過 classLoader 加載一個

org.apache.struts.util. PropertyMessageResourcesFactory

?

⑵

defaultFactory. createResources (config) 所做的工作：

this.factory = factory;

("org.apache.struts.util.PropertyMessageResourcesFactory")

this.config = config; ("org.apache.struts.action.ActionResources")

this.returnNull = returnNull; (true)

PropertyMessageResourcesFactory extends MessageResourcesFactory

返回一個 MessageResources 對象

?

?

② 調用 initOther(); 從 web.xml 中加載 ActionServlet 的初始化參數，包括 config/ convertNull

protected String config = "/WEB-INF/struts-config.xml"; // ② initOther();

protected boolean convertNull = false; // ② initOther();

?

// 得到 web.xml 中 "config" 參數

String value;

value = getServletConfig().getInitParameter(" config ");

if (value != null) {

??? config = value;

}

??? <servlet>

??????? <servlet-name>action</servlet-name>

??????? <servlet-class>org.apache.struts.action.ActionServlet</servlet-class>

??????? <init-param>

??????????? <param-name>config</param-name> ?? <!-- 得到 "config" 參數 -->

??????????? <param-value>/WEB-INF/struts-config.xml</param-value>

??????? </init-param>

??????? <init-param>

??????????? <param-name>convertNull</param-name> ? ? <!-- 得到 "convertNull" 參數 -->

??????????? <param-value>true</param-value>

??????? </init-param>

??????? .......

??? </servlet> ??

?

// 獲得 convertNull 的值（ true/yes/on/y/1 ）

getServletConfig().getInitParameter(" convertNull ");

如果這個參數的值為 true （ true/yes/on/y/1 ） , 數值型 (BigDecimal/BigInteger/Boolean/Byte/Character/Double/Float/Integer/Long/Short) 的 Java 包裝類（比如 java.lang.Integer ）的 初始值為 null ，而非 0 。缺省值 [false]

?

使其 初始值為 null 的方法如下：

// 將所有的轉換器注銷掉

ConvertUtils.deregister();

// 為指定類型 clazz 注冊轉換器 converter

ConvertUtils.register(new BigDecimalConverter(null), BigDecimal.class);

ConvertUtils.register(new BigIntegerConverter(null),BigInteger.class);

.......

?

注： ConvertUtils 用法如下

deregister () 和 deregister (java.lang.Class?clazz)

注銷轉換器，前者將所有的轉換器注銷掉，后者只注銷對應于 clazz 的轉換器 register ( Converter ?converter, java.lang.Class?clazz)

為指定類型 clazz 注冊轉換器 converter 。如果 clazz 已經存在一個對應的轉換器，那么 converter 覆蓋原來的轉換器。

struts源碼學習之ActionServlet（一）