第三部分 Building Controller Components
1. 本文前面部分都在讲解一些Control的基本概念和ActionForm Bean，这就不再赘述了
2. Action Class Design Guidelines.
(1) 书写一个thread-safe的Action class. Struts的Controller servlet只会创建一个我们的Action class的实例，然后用这个实例去服务所有的request. 但是，有可能这个Action class是多线程的，所以我们要写thread-safe的代码。记住以下两点即可：首先，在Action class中不要用类一级的成员变量，将所有的变量都声明成local variables（在execute方法内声明所有变量）即可；其次，对资源的使用，比如数据库，要使用数据库池的技术，而且要记得用完就释放
(2) 在Action class中不要throw exceptions，要catch exceptions。这一点没有问题，我们的EasyCluster在business logic bean中会catch所有的exception。
3. Exception Handler. 感觉这个东西没什么用，这个东西允许我们的Action class throw exceptions，然后Struts的ExceptionHandler class会处理exception（当然我们也可以写一个class继承ExceptionHandler，然后自己处理）。对Exception handler可以在struts-config.xml中定义，不过我们没这个必要，我们的EasyCluster在逻辑层会catch所有的exception，然后return相应的出错信息给Action class，Action class会forward到相应的页面去。
4. Struts plugin classes. 我们可以自己写一个类，继承Struts的PlugIn class，然后override init和destroy 这两个方法即可。EasyCluster目前就是利用这个plugin来读取ec.properties，来启动ServerNotify线程的。
5. ActionMapping classes. 有关map和forward的逻辑，都定义在struts-config.xml中，有关这个xml的详细语法，可以参考他的dtd文件：
file:///D:/Sun/struts-1.3.5/docs/dtds/struts-config_1_3.dtd
在ActionMapping的配置中，<form-beans>, <global-forwards>和<action-mappings>这三项是不能缺少的。
<form-beans>的配置中，有两项是最常用的：name, type
<global-forwards>下，应该配置<forward> element，每个forward中，常用的配置属性有：name, path, redirect. 其中name和path好说，我们用的就是这两项，至于redirect，这是一个bool配置项，默认值是false。当配置成true的时候，表示ActionServlet会redirect到path的地方而不是forward，这就是为什么我们的action执行完成后，IE的URL中显示的是action的url而不是最终那个JSP页面的URL了。
<action-mappings>中配置<action> element. 常用的属性有path和type，如果这个action有form的话，还要配置一个name（也就是FormBean的name）。此外，还有这两项Struts说也是常用的（我觉得不常用，呵呵）：parameter和roles。这两项的含义如下：
parameter: A general-purpose attribute often used by "standard" Actions to pass a required property.
roles: A comma-delimited list of the user security roles that can access this mapping.
6. 文章给出了一个配置的example，可以看一下：
这里面只有一点需要注意，就是action配置项中的validate attribute，以前这一项我们都是不配置的，不配置的话默认值是true，表示在调用Action class的execute方法之前，会调用formbean的validate方法，如果我们在这里将validate配置成false的话，那formbean的validate方法就不会被调用。
7. Using ActionMappings for Pages. 我们的action还可以这样配置：
<action path="/view" forward="/view.jsp"/>
这也是比较常用的，这个action完全就是一个mapping，文章中说这种做法在我们配置了多个module的时候，用于module之间的穿梭很常用。
8. Using Wildcards in ActionMappings. 这个东西倒是蛮有用的，以前没有用过（该功能在Struts 1.2.0开始支持），比如：
看看就明白了吧？{1}就是代表被*所匹配的文字，这个还是有点用处的。注意，上述例子中，可以匹配/editSubscription, /editRegistration这样的action，但是不能匹配/editRegistration/这样的PATH（就是后面多了一个slash/），要匹配后面有slash的，请用**，后面有描述。还有，我们可以在struts-config.xml中对一个action做多次配置，这个时候，出现在配置文件最后一个的配置有效（就是前面重复的配置会被最后一个覆盖），但是如果出现一个action被一个确定书写的action所匹配，同时也被一个使用了wildcard的action所匹配的话，此时，确定书写的action配置生效，这就和配置书写的位置（前后顺序）无关了。
这里列出目前支持的wildcard：
见附件1
目前，我们可以用wildcard匹配九个，被匹配的值可以用{1}...{9}来引用。此外，可以使用{0}来引用整个URI（也就是path的全部字符串）
目前，在action配置中可以使用wildcard的属性有：
在foward element中可以使用wildcard的属性有：
9. Commons Logging Interface. 这其实也是apache common的一个项目，Struts利用了这个东西，commons-logging-1.0.4.jar。这个包本身不提供任何log功能，他只是一个bridge，他能和很多的log框架连接起来，他的搜索逻辑是这样的：
(1) 如果发现log4j，就使用log4j(只需要把log4j的jar包放到WEB-INF/lib下就OK)
(2) 如果发现JDK1.4，就使用JDK1.4自带的log功能
(3) 1，2都不行，使用common-logging自己实现的SimpleLog
这就是为什么我们的EasyCluster使用了log4j，但是写代码的时候用的是common-logging的API，如下：
使用common logging，可以让我们自由的随意更换后台的log实现。
1. 本文前面部分都在讲解一些Control的基本概念和ActionForm Bean，这就不再赘述了
2. Action Class Design Guidelines.
(1) 书写一个thread-safe的Action class. Struts的Controller servlet只会创建一个我们的Action class的实例，然后用这个实例去服务所有的request. 但是，有可能这个Action class是多线程的，所以我们要写thread-safe的代码。记住以下两点即可：首先，在Action class中不要用类一级的成员变量，将所有的变量都声明成local variables（在execute方法内声明所有变量）即可；其次，对资源的使用，比如数据库，要使用数据库池的技术，而且要记得用完就释放
(2) 在Action class中不要throw exceptions，要catch exceptions。这一点没有问题，我们的EasyCluster在business logic bean中会catch所有的exception。
3. Exception Handler. 感觉这个东西没什么用，这个东西允许我们的Action class throw exceptions，然后Struts的ExceptionHandler class会处理exception（当然我们也可以写一个class继承ExceptionHandler，然后自己处理）。对Exception handler可以在struts-config.xml中定义，不过我们没这个必要，我们的EasyCluster在逻辑层会catch所有的exception，然后return相应的出错信息给Action class，Action class会forward到相应的页面去。
4. Struts plugin classes. 我们可以自己写一个类，继承Struts的PlugIn class，然后override init和destroy 这两个方法即可。EasyCluster目前就是利用这个plugin来读取ec.properties，来启动ServerNotify线程的。
5. ActionMapping classes. 有关map和forward的逻辑，都定义在struts-config.xml中，有关这个xml的详细语法，可以参考他的dtd文件：
file:///D:/Sun/struts-1.3.5/docs/dtds/struts-config_1_3.dtd
在ActionMapping的配置中，<form-beans>, <global-forwards>和<action-mappings>这三项是不能缺少的。
<form-beans>的配置中，有两项是最常用的：name, type
<global-forwards>下，应该配置<forward> element，每个forward中，常用的配置属性有：name, path, redirect. 其中name和path好说，我们用的就是这两项，至于redirect，这是一个bool配置项，默认值是false。当配置成true的时候，表示ActionServlet会redirect到path的地方而不是forward，这就是为什么我们的action执行完成后，IE的URL中显示的是action的url而不是最终那个JSP页面的URL了。
<action-mappings>中配置<action> element. 常用的属性有path和type，如果这个action有form的话，还要配置一个name（也就是FormBean的name）。此外，还有这两项Struts说也是常用的（我觉得不常用，呵呵）：parameter和roles。这两项的含义如下：
parameter: A general-purpose attribute often used by "standard" Actions to pass a required property.
roles: A comma-delimited list of the user security roles that can access this mapping.
6. 文章给出了一个配置的example，可以看一下：
- CODE: SELECT ALL
<struts-config>
<form-beans>
<form-bean
name="logonForm"
type="org.apache.struts.webapp.example.LogonForm" />
</form-beans>
<global-forwards
type="org.apache.struts.action.ActionForward">
<forward
name="logon"
path="/logon.jsp"
redirect="false" />
</global-forwards>
<action-mappings>
<action
path="/logon"
type="org.apache.struts.webapp.example.LogonAction"
name="logonForm"
scope="request"
input="/logon.jsp"
unknown="false"
validate="true" />
</action-mappings>
</struts-config>
这里面只有一点需要注意，就是action配置项中的validate attribute，以前这一项我们都是不配置的，不配置的话默认值是true，表示在调用Action class的execute方法之前，会调用formbean的validate方法，如果我们在这里将validate配置成false的话，那formbean的validate方法就不会被调用。
7. Using ActionMappings for Pages. 我们的action还可以这样配置：
<action path="/view" forward="/view.jsp"/>
这也是比较常用的，这个action完全就是一个mapping，文章中说这种做法在我们配置了多个module的时候，用于module之间的穿梭很常用。
8. Using Wildcards in ActionMappings. 这个东西倒是蛮有用的，以前没有用过（该功能在Struts 1.2.0开始支持），比如：
- CODE: SELECT ALL
<!-- Generic edit* mapping -->
<action
path="/edit*"
type="org.apache.struts.webapp.example.Edit{1}Action"
name="{1}Form"
scope="request"
validate="false">
<forward
name="failure"
path="/mainMenu.jsp"/>
<forward
name="success"
path="/{1}.jsp"/>
</action>
看看就明白了吧？{1}就是代表被*所匹配的文字，这个还是有点用处的。注意，上述例子中，可以匹配/editSubscription, /editRegistration这样的action，但是不能匹配/editRegistration/这样的PATH（就是后面多了一个slash/），要匹配后面有slash的，请用**，后面有描述。还有，我们可以在struts-config.xml中对一个action做多次配置，这个时候，出现在配置文件最后一个的配置有效（就是前面重复的配置会被最后一个覆盖），但是如果出现一个action被一个确定书写的action所匹配，同时也被一个使用了wildcard的action所匹配的话，此时，确定书写的action配置生效，这就和配置书写的位置（前后顺序）无关了。
这里列出目前支持的wildcard：
见附件1
目前，我们可以用wildcard匹配九个，被匹配的值可以用{1}...{9}来引用。此外，可以使用{0}来引用整个URI（也就是path的全部字符串）
目前，在action配置中可以使用wildcard的属性有：
- attribute
catalog
command
forward
include
input
multipartClass
name
parameter
prefix
roles
suffix
type
在foward element中可以使用wildcard的属性有：
- catalog
command
path
9. Commons Logging Interface. 这其实也是apache common的一个项目，Struts利用了这个东西，commons-logging-1.0.4.jar。这个包本身不提供任何log功能，他只是一个bridge，他能和很多的log框架连接起来，他的搜索逻辑是这样的：
(1) 如果发现log4j，就使用log4j(只需要把log4j的jar包放到WEB-INF/lib下就OK)
(2) 如果发现JDK1.4，就使用JDK1.4自带的log功能
(3) 1，2都不行，使用common-logging自己实现的SimpleLog
这就是为什么我们的EasyCluster使用了log4j，但是写代码的时候用的是common-logging的API，如下：
- CODE: SELECT ALL
package com.foo;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
public class Foo {
// ...
private static Log log = LogFactory.getLog(Foo.class);
// ...
public void setBar(Bar bar) {
if (log.isTraceEnabled()) {
log.trace("Setting bar to " + bar);
}
this.bar = bar;
}
// ...
}
使用common logging，可以让我们自由的随意更换后台的log实现。
