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