Struts源码学习之ActionServlet(一)

http://www.blogjava.net/xiaodaoxiaodao/archive/2007/04/26/113666.html

转载请注明来源/作者

Struts 源码学习之ActionServlet ( 一)

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处理

<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>

<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-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</param-value>

</init-param>

<init-param>

<param-name>convertNull</param-name>

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

③ 调用 initServlet(); 从web.xml中加载ActionServlet的初始化参数如servlet-name，加载DTD文件并把其放入HashMap缓存，读取并解析web.xml的内容

// Remember our servlet name

getServletConfig().getServletName();

<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</param-value>

</init-param>

<init-param>

<param-name>convertNull</param-name>

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

</init-param>

.......

</servlet>

// Prepare a Digester to scan the web application deployment descriptor

Digester digester = new Digester();

// 把当前的 ActionServlet 对象放入到解析堆栈中

digester.push(this);

// 指明要考虑命名空间

digester.setNamespaceAware(true);

// 缺省值[false] ，解析器只是检查XML是否格式良好(well formed)

digester.setValidating(false);

// Register our local copy of the DTDs that we can find

// struts 可使用 struts-core-1.3.5.jar 包中的DTD中来处理struts配置文件，这样可适用于那些没有连接到internet的应用环境

for (int i = 0; i < registrations.length; i += 2) {

URL url = this.getClass().getResource(registrations[i + 1]);

if (url != null) {

// 读取DTD文件并把其放入 HashMap 缓存

digester.register(registrations[i], url.toString());

}

/************************************************************

// 一些文档类型定义，用来验证相应的配置文件如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();

************************************************************/

// Configure the processing rules that we need

// 运行时，digester 就会调用 ActionServlet中的 addServletMapping() 方法，并传入两个参数

digester.addCallMethod("web-app/servlet-mapping", "addServletMapping", 2);

digester.addCallParam("web-app/servlet-mapping/servlet-name", 0);

digester.addCallParam("web-app/servlet-mapping/url-pattern", 1);

得到

<servlet-mapping>

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

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

</servlet-mapping>

/************************************************************

// 来判断当前 servlet 名称是否为正在运行的 servlet 名称，如是，就把 url-pattern 作为 servletMapping

public void addServletMapping(String servletName, String urlPattern) {

if (servletName == null) {

return;

}

if (servletName.equals(this.servletName)) {

if (log.isDebugEnabled()) {

log.debug("Process servletName=" + servletName

+ ", urlPattern=" + urlPattern);

}

this.servletMapping = urlPattern;

}

************************************************************/

// 读取配置文件web.xml的内容

InputStream input = getServletContext().getResourceAsStream("/WEB-INF/web.xml");

// 如找不到/WEB-INF/web.xml文件，则报错

if (input == null) {

log.error(internal.getMessage("configWebXml"));

throw new ServletException(internal.getMessage("configWebXml"));

}

/************************************************************

// 报错信息定义在org\apache\struts\action\ActionResources.properties中

configWebXml=The /WEB-INF/web.xml was not found.

************************************************************/

// 解析input流文件，每读到一个节点元素就触发一个事件

digester.parse(input);

注： Digester 是一个基于 DOM 的 SAX 实现的类，它是事件触发的，可以将XML文件转换为任意的Java对象，支持规则的对任意XML文档的处理。原先是struts项目的一部分，后因其通用性而划归Commons子项目。

// 把servletMapping存储到servletContext中，属性名为Globals.SERVLET_KEY （ " org.apache.struts.action.SERVLET_MAPPING " ）

if (servletMapping != null) {

getServletContext().setAttribute(Globals.SERVLET_KEY,servletMapping);

}

发表于 2007-04-26 08:24 蓝小刀阅读(8882) 评论(11) 编辑收藏所属分类: 个人学习笔记、Struts

# re: Struts源码学习之ActionServlet(一)

写的不错

dennis 评论于 2007-04-26 08:51 回复更多评论

搞得不丑

jqh 评论于 2007-04-26 09:46 回复更多评论

写的挺好，辛苦

zrei 评论于 2007-04-26 12:04 回复更多评论

偶刚学struts 有些东西感到很困惑
经你一点播一切o 了

哦哦评论于 2007-04-27 06:57 回复更多评论

赞!

nullpointerpig 评论于 2007-07-10 17:12 回复更多评论

o 了

ChineseDream 评论于 2007-09-08 19:15 回复更多评论

谢谢！很用心！

路人评论于 2008-01-08 15:36 回复更多评论

# re: Struts源码学习之ActionServlet(一)[未登录]

谢谢了

summer 评论于 2008-08-26 16:09 回复更多评论

够详细！

aiyo 评论于 2009-02-24 15:39 回复更多评论

写的很好

风轻云淡评论于 2009-03-31 15:31 回复更多评论

相当详细啊

tt 评论于 2010-05-20 14:22 回复更多评论

公告

留言簿(6)

随笔分类(53)

随笔档案(42)

往日空间，弃之可惜

蓝小刀个人空间

最新随笔

搜索

积分与排名

最新评论

阅读排行榜

评论排行榜

xiaodaoxiaodao——蓝小刀的自言自语黑夜给了我寂寞的心情，我却用它来寻找爱情~~
BlogJava \| 首页 \| 发新随笔 \| 发新文章 \| 联系 \| 聚合 \| 管理	随笔：42 文章：0 评论：228 引用：0