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

 

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

分享到：

Commons-Beanutils | Struts 源码学习之ActionServlet ( 二)

• 2008-09-21 10:17
• 浏览 3447
• 评论(1)
• 查看更多

评论

1 楼 myjava_024 2008-10-08  

谢谢您，茅塞顿开啊