Struts.xml

包含配置
在默认的情况下，Struts2将自动加载放在WEB-INF/classes路径下的struts.xml文件。大部分应用里，随着应用的规模的增加，系统的Action数量大量增加，导致了struts.xml配置文件变得非常臃肿。
       为了避免这种情况，可以将一个struts.xml文件分解成多个配置文件，然后在struts.xml文件中包含其他配置文件。比如说：在struts.xml文件中使用以下配置方式
<include file=”struts-mod1.xml” />
通过这种方式提供了一种模块化的方式来管理struts.xml文件。
另外，在core的根目录下有一个struts-default.xml文件，注意，这个文件是自动加载的，不需要在我们的struts.xml文件中用include导入。

Bean的配置
一般这个元素不需要我们进行配置，只是需要重新定义struts2的核心组件的时候才需要使用到这个元素。
Struts2框架是一个可以高度扩展的框架，框架的大部分核心组件，都是通过IOC容器来进行管理的。因此，允许开发者可以很方便的提供自己的组件实现类，并将组件类部署到struts2就OK了。
这个标记很不常用，如果需要可以查看帮助。
不过这里举个例子：
<bean type=”com.opensymphony.xwork2.ObjectFactory” name=”caFactory” class=”cc.dynasoft.MyObject” />
以上代码的作用是使用一个自己定义的ObjectFactory来替换了struts2内置的object。
常量配置
Struts有一个属性文件，struts.properties，实际上这个配置文件是指定struts2的属性。而常量配置就是指定struts2属性的一种方式。例子：
<constant name=”struts.custom.i18n.resources” value=”message” />
以上用于指定国际化资源文件的前缀名是message，当然也可以在struts.properties中配置，如下：
struts.custom.i18n.resources=message
也可以在web.xml中进行配置：
作为FilterDispatcher的init-param
<param-name> struts.custom.i18n.resources</param-name>
<param-value>message</param-value>
以下是加载struts2常量的搜索顺序：
1、  struts-default.xml中
2、  struts-plugin.xml中
3、  struts.xml中
4、  struts.properties
5、  web.xml中



包配置
Struts2使用package来管理Action和拦截器等。配置该包时，必须指定一个name属性，用于指定包名，可以指定一个可选的extends属性，是另一个包的名字，子包可以继承父包的拦截器，拦截器栈、action等配置。除此之外，struts还提供了一个抽象包，抽象包的含义是该包不能有action的定义。设置abstract=”true”说明这是一个抽象包。
以下是一个例子：
<package name=”mod1” extends=”struts-default” /> 其中struts-default是struts-default.xml提供的包。

另一个比较重要的概念就是命名空间：
考虑在一个web应用中需要同名的action，struits2以命名空间的方式来管理Action，同一个命名空间不能有同名的Action，不同的命名空间可以有同名的Action。如果不指定命名空间，则默认的命名空间是””，指定了命名空间之后，Action的URL应该是命名空间+Action名。
比如说：
<action name=”register” extends=”struts-default” namespace=”/user” >……</action>
则对应的Action应该是/user/register.action。
如果namespace=”/”，说明这是一个根命名空间。

如果指定了命名空间，但是在该命名空间中找不到该Action，struts2将会在默认的命名空间中继续查找，如果还找不到，则出现系统错误。
比如说：
请求/order/save.action，系统首先在命名空间/order中查找，如果找到，使用该action进行处理，否则，系统将到默认的命名空间中查找，如果两个命名空间都找不到，出现系统错误。

拦截器配置
       拦截器实际上思想就是AOP，我们可以使用拦截器跟踪日志、跟踪系统性能瓶颈等。
       拦截器的配置无非就是声明拦截器、引用拦截器以及声明拦截器栈。可以认为拦截器栈是由多个拦截器组成的一个大的拦截器。
       定义拦截器和拦截器栈都在<interceptors />这个标记内
       以下是一个例子：
       <interceptors>
              <interceptor name=”log” class=”cc.dynasoft.LogInterceptor” />
<interceptor name=”authority” class=”cc.dynasoft. Authority Interceptor” />
<interceptor name=”timer” class=”cc.dynasoft.TimerInterceptor” />
<interceptor-stack name=”default”>
       <interceptor-ref name=” authority” />
<interceptor-ref name=” timer” />
</interceptor>

引用拦截器是在action中引用的：例子：
<action name=”login” class=”cc.dynasoft.LoginAction”>
       ……
       <interceptor-ref name=”log” />
</action>

配置Action
实际上配置Action很简单，就使用action标签就OK了，action标签有两个重要属性：name和class，name是必须指定的，他既是action的名字，也是该action需要处理的URL的前半部分。如果class没有指定，默认是ActionSupport。而ActionSupport默认处理就是返回一个SUCCESS字符串。
struts的全局配置文件中有一个属性：struts.enable.SlashesInActionNames如果设置为true，允许struts2框架中使用斜线。
Action中直接访问servlet API有以下两种方法：
1、  如果需要访问ServletContext，Action类需要实现接口ServletContextAware
如果需要访问 HttpServletRequest，Action类需要实现接口ServletRequestAware
如果需要访问 HttpServletResponse，Action类需要实现接口ServletResponseAware

以下是例子代码，主要用于访问Reponse对象：
public class LoginAction implements Action,ServletResponseAware
{
        private HttpServletResponse response;

        //实现ServletResponseAware接口必须实现的方法
       
        public String execute() throw Exception
        {
               Cookie c = new Cookie(“user”,getUsername());
               c.setMaxAge(60*60);//最大生存时间
               response.addCookie(c);
               return SUCCESS;
        }
}

2、  struts2提供了一个ServletActionContext，这个类包含了访问request，response等静态方法。

注意：即使我们在struts2的Action中获得了HttpServletResponse对象，也不要尝试直接在Action中生成对客户端的输出。比如：下面代码是没有实际意义的，即
response.getWriter().println(“hello world!”);

动态方法调用（类似struts1的DispatchAction）
其实没有什么特别的地方，只是提交表单的时候需要使用如下的格式：
action=”ActionName!MethodName.action”
举个例子：action=”Login!regist.action”,这句话的实质就是交给Login Action的regist方法进行处理

使用动态方法调用前必须设置struts2允许动态方法调用。开启系统的动态方法调用是通过设置struts.enable.DynamicMethodInvocation常量完成的，设置该常量的值为true，将开启动态方法调用；否则将关闭动态方法调用。

为action元素指定method属性

对action进行如下的配置：
<action name=”Login” class=”cc.dynasoft.LoginAction” method=”login” />
              ……
</action>
             
<action name=”Regist” class=”cc.dynasoft.LoginAction” />
              ……
</action>

查看以上两个action，默认的情况是Regist，而当Login的时候，将提交到LoginAction的login中。查看上面的两个action，class都是一样的，于是就出现了下面的使用通配符的概念。

使用通配符
       在配置action的时候，action的三个属性name、class和method都可以使用通配符。
       以下举例说明：
       例1：<action name=”*Action” class=”cc.dynasoft.LoginAction” method=”{1}”>
              ……
              </action>
解释一下上面代码的含义：上面定义的不是一个普通的action，而是定义了一系列的action，只要URL是*Action.action的模式，都可以通过该Action进行处理。但该Action定义了一个表达式{1}，该表达式的值就是name属性值中的第一个*的值。
例如，如果用户请求的URL是loginAction.action，则调用该action的login方法；如果用户请求的URL是registAction.action，则调用该action的regist方法。

例2：<action name=”*Action” class=”cc.dynasoft.{1}Action”>

       ……
            
     </action>

比如说：如果URL为RegistAction.action，可以匹配上面的action，该action的处理类是cc.dynasoft.RegistAction

例3：<action name=”*_*” class=”cc.dynasoft.{1}Action” method=”{2}”>
当一个action为Book_save.action的时候将调用BookAction的save方法来处理用户请求。

注意这个时候指定校验文件需要注意，比如说Book_save.action的校验文件应该是
Book_save-validation.xml。

例4：<action name=”*”>
             <result>/{1}.jsp</result>
       </action>

这个应该不难理解，呵呵。

以下需要注意的问题：
如果有URL为abcAction.action的请求，如果struts.xml文件有名为abcAction的Action，则一定由该Action来处理用户请求；如果struts.xml文件没有名为abcAction的Action，则搜索name属性值匹配abcAction的Action，例如name为*Action或*，*Action并不会比*更优先匹配abcAction的请求，而是先找到哪个Action，就先由哪个Action来处理用户的请求。因此，我们应该将名为*的Action配置在最后，否则struts2将使用该Action来处理所有希望使用模式匹配的请求。
处理结果
struts2通过在struts.xml文件中使用<result>元素来配置结果，根据<result>元素所在位置的不同，struts2提供了两种结果。
局部结果：将<result>作为<action>元素的子元素配置
全局结果：将<result>作为<global-result>元素的子元素配置。
以下列出比较标准的配置：
<result name=”success” type=”dispatcher”>
       <param name=”location” >/thank_you.jsp</param>
<param name=”parse” >true</param>
</result>

location：用于指定实际视图资源
parse：该参数指定是否允许在实际视图名称中使用ONGL表达式，默认为true。如果设置为false则不允许使用，通常不需要修改。
一般我们比较常用的写法：
<result name=”success” type=”dispatcher”>
/thank_you.jsp
</result>

注意如果没有指定name属性：则默认是success；如果没有指定type，则默认就是dispatcher，即JSP。
下面列出struts2内建支持的结果类型如下：
chain：Action链式处理的结果类型，也就是将结果转发到这个action中。
chart：整合JFreeChart的结果类型
dispatcher：用于整合JSP的结果类型
freemarker：用于整合freemarker结果类型。
httpheader：用于控制特殊的HTTP行为的结果类型。
jasper：用于JasperReports整合的结果类型
jsf：用于整合JSF后的结果类型
redirect：实际上dispatcher和redirect的区别就是在于转发和重定向的区别。
redirect-action：用于直接redirect action。
stream：用于向浏览器返回一个Inputstream（用于文件下载）
tiles：用于整合Tiles后的结果类型。
velocity：用于整合Velocity的结果类型。
xslt：用于整合XML/XSLT的结果类型。
plaintext：用于显示某个页面的源代码。

plaintext、redirect以及redirect-action的配置分别如下：
<result type=”plaintext”>
       <param name=”location”>/welcome.jsp</param>
       <!—设置字符集编码-->
       <param name=”charset”>gb2312</param>
</result>

<result type=”redirect”>
       /welcome.jsp
</result>

<result type=” redirect-action”>
       <!—指定action的命名空间-->
       <param name=”namespace”>/ss</param>
<!—指定action的名字-->
       <param name=”actionName”>login </param>
</result>

在请求结果中使用ONGL表达式

例子：
<result type=”redirect”>edit.action?skillName=${currentSkill.name}</result>

对于上面的表达式语法，要求action中必须包含currentSkill属性，并且currentSkill属性必须包含name属性，否则${currentSkill.name}表达式值为null。

属性驱动和模型驱动
我不推荐使用模型驱动，属性驱动完全可以实现模型驱动的效果。



异常处理
       异常处理在struts2中采用可配置的方式来处理，主要是为了防止异常代码和action代码耦合。我们比较希望的异常处理模式是这样的，如果出现了异常一，则系统跳转到视图1；如果出现了异常二，则系统转到视图2。
       我们查看execute的声明：public String execute() throws Exception可以发现将异常抛出由struts2框架进行处理，为了处理异常，我们必须使用exception拦截器，由于在struts-default.xml的defaultStack中已经存在这个拦截器的定义，于是我们可以不用做任何事情。
       struts2的异常处理机制是通过在struts.xml文件中配置<exception-mapping />元素完成的，配置该元素的时候，需要指定两个属性：
exception：此属性指定该异常映射所设置的异常类型。
result：出现这个异常的时候，转入result属性所指向的结果。
根据<exception-mapping />元素出现的位置的不同，异常映射又可分为两种：
局部异常映射：将<exception-mapping />作为action的子元素配置
全局异常映射：将<exception-mapping />元素作为<global-exception-mappings>元素的子元素配置。
实际上配置类似result，可以有局部，也可以是全局，局部优先。

举个例子：
<global-exception-mappings>
       <exception-mapping exception=”java.sql.SQLException” result=”sql”/>
<exception-mapping exception=”java.lang.Exception” result=”root”/>
</ global-exception-mappings>

注意以上的sql和root是全局result。
输出异常信息：
<s:property value=”exception” />:输出异常对象本身，注意这个异常代表Exception的实例，因此可以调用message属性。
<s:property value=”exceptionStack” />：输出异常堆栈信息。