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 覆盖原来的转换器。