struts2:struts.xml配置文件详解

1. 几个重要的元素

1.1 package元素

package元素用来配置包。在Struts2框架中,包是一个独立的单位,经过name属性来惟一标识包。还能够经过extends属性让一个包继承另外一个包,extends属性值就是被继承包的name属性值,继承包能够从被继承包那里继承到拦截器、Action等。html

在Struts2框架中是经过包来管理action、result、interceptor、interceptor-stack等配置信息的。包属性以下:浏览器

属性框架

说明jsp

name 包名,做为其它包应用本包的标记
extends 可选属性,设置本包继承其它包
namespace 可选属性,设置包的命名空间
abstact 可选属性,设置为抽象包

-extends ui

  • 当一个包经过配置extends属性继承了另外一个包的时候,该包将会继承父包中全部的配置,包括action、result、interceptor等。
  • 因为包信息的获取是按照配置文件的前后顺序进行的,因此父包必须在子包以前被定义。
  • 一般咱们配置struts.xml的时候,都继承一个名为“struts-default.xml”的包,这是struts2中内置的包。

-namespace spa

  • 该属性能够指定包对应的命名空间。因为在一个Web应用中可能出现同名的Action并存的状况,为了不命名冲突,只要使同名Action位于不一样的namespace下就能够了。
  • Struts2中若是没有为某个包指定命名空间,该包使用默认的命名空间,默认的命名空间老是""。
  • 当设置了命名空间为“/”,即指定了包的命名空间为根命名空间时,此时全部根路径下的Action请求都会去这个包中查找对应的资源信息。
  • 根命名空间和普通命名空间中的Action的查找是同样的,即若是有请求“/stu_info.action“(或者是”/C/stu_info.action“),则先查找根命名空间下的Action(或者是/C命名空间下的Action),若是不存在对应的Action,则查找默认命名空间里的Action。此规则对于多级别的命名空间也是如此,即若是请求查找/A/A_Login/login.action时,Struts2框架先到/A/A_Login的命名空间里查找名为login的action,若是找不到,则到默认的命名空间里查询,而不会到它的上一级“/A“里面查找。

示范:code

    <package name="caiwu" extends="struts-default" namespace="/caiwu">
    </package>

1.2 action元素

Struts2框架经过Action对象来处理HTTP请求,该请求的URL地址对应的Action即配置在action元素中。xml

action元素属性htm

属性名称对象

功能描述

name 请求的Action名称
class 可选属性,Action处理类对应具体路径
method 可选属性,指定Action中的方法名
converter 可选属性,指定Action使用的类型转换器
  • 若是没有指定method则默认执行Action类中的execute方法;不然调用method属性中指定的方法。
  • 若是没有指定class则默认值为:com.opensymphony.xwork2.ActionSupport,该默认类使用默认的处理方法(啥也没作),直接返回success值。

示范:

        <action name="list" class="com.clzhang.struts2.demo3.ListAction">
        </action>
        <action name="listSalarySum" class="com.clzhang.struts2.demo3.ListAction" method="listSalarySum">
        </action>

1.3 result元素

当调用Action方法处理结束返回后,下一步就是使用result元素来设置返回给浏览器的视图。配置result元素时常须要指定name和type两个属性。

result属性

属性名称

功能描述

name 对应Action返回逻辑视图名称,默认为success
type 返回结果类型,默认为dispatcher
  • name属性对应于Action方法返回的值,success为其默认值。
  • type属性指定结果类型,默认的类型是dispatcher。

Struts2支持的结果类型

结果类型 

说明
dispatcher 将请求转发(forward)到指定的JSP页面
redirect   将请求重定向到指定的视图资源
chain 处理Action链
freemarker 指定Freemarker模板做为视图
httpheader 控制特殊的HTTP行为
redirect-action 直接跳转到其它Action
stream 向游览器返回一个InputStream(通常用于文件下载)                    
velocity 指定使用velocity模板做为视图
xslt 用于XM/XSLT整合
plainText                                 显示某个页面的原始代码

示范:

        <action name="login" class="com.clzhang.struts2.demo1.LoginAction">
            <result name="input">/struts2/demo1/login.jsp</result>
            <result name="error">/struts2/demo1/wrong.jsp</result>
            <result name="list" type="redirectAction">
                <param name="idInList">${id}</param>
                <param name="actionName">listBook</param>
            </result>
        </action>

须要注意dispatcher和redirect的区别,也就是转发和重定向的区别,重定向会丢失全部的请求参数,并且会丢失Action处理结果。

1.4 include元素

在Struts2中提供了一个默认的struts.xml文件,但若是package、action、interceptors等配置比较多时,都放到一个struts.xml文件不太容易维护。所以,就须要将struts.xml文件分红多个配置文件,而后在struts.xml文件中使用<include>标签引用这些配置文件。

示范:

    <include file="caiwu.xml"></include>
    <include file="cangku.xml"></include>

1.5 global-results元素

有不少时候一个<result>初不少<action>使用,这时可使用<global-results>标签来定义全局的<result>。

示范:

        <global-results>
            <result name="user">/struts2/demo3/user.jsp</result>
            <result name="sum">/struts2/demo3/sum.jsp</result>
            <result name="default">/struts2/demo3/default.jsp</result>
        </global-results>

1.6 default-action-ref元素

若是在请求一个没有定义过的Action资源时,系统就会抛出404错误。这种错误不可避免,但这样的页面并不友好。咱们可使用<default-action-ref>来指定一个默认的Action,若是系统没有找到指定的Action,就会指定来调用这个默认的Action。

示范:

    <default-action-ref name="acctionError"></default-action-ref>
    <action name="acctionError">
        <result>/jsp/actionError.jsp</result>
    </action>

2. Action的动态调用(DMI)

Struts2提供了包含多个处理逻辑的Action处理方式,即DMI(Dynamic Method Invocation,动态方法调用)。它是经过请求对象中的一个具体的方法来实现动态的操做。具体说,在请求Action的URL地址后加上请求方法字符串,与Action对象中的方法进行匹配。其中,Action对象名称和方法之间用“!“隔开。

更多内容参考:struts2:多业务方法的处理(动态调用,DMI)

示范:

<A href="list!listUser.action" target="_blank">3.2 经过URL叹号参数</A>

3. 通配符

在实际的项目开发中,会出现多个Action定义的绝大部分都是相同的状况,这时就会产生大量冗余。对于这种状况,Struts2也给出了相应的解决方法,即便用通配符。

通配符

说明

* 匹配0个或多个字符除了“/”
** 匹配0个或多个字符包含“/”
\character                                           转义字符,“\\”匹配“\”;“\*”匹配“*”                                                         

通配符“*“一般用在<action>标签的name属性中,而在class、name属性及result元素中使用{n}的形式来表明前面第n个*所匹配的字符串,{0}来表明URL请求的整个Action字符串。

示范一:

<!-- 使用*通配符,第一个*表示调用方法,第二个*表示Action -->
<action name="*_*" class="com.clzhang.struts2.action.{2}Action"
    method="{1}">
    <result name="success">/{0}Suc.jsp</result>
</action>

在上面代码中,当URL请求是/update_Login.action时,会调用LoginAction类中的update()方法,处理结束返回到update_LoginSuc.jsp。

示范二:

<!-- 无论调用哪一个Action,默认返回名为Action名的JSP -->
<action name="*_*">
    <result>/{0}.jsp</result>
</action>

上面代码中没有指定class属性,也没指定result元素的name,这样无论访问哪一个Action都会返回与该Action名字相同的JSP页面。 

4. 常量配置

在以前提到struts.properties配置文件的介绍中,咱们曾经提到全部在struts.properties文件中定义的属性,均可以配置在struts.xml文件中。而在struts.xml中,是经过<constant>标签来进行配置的。

示范:

    <constant name="struts.action.extension" value="action"></constant>
    <constant name="struts.ognl.allowStaticMethodAccess" value="true" />
    <constant name="struts.ui.theme" value="simple"></constant>
    <constant name="struts.custom.i18n.resources" value="message"></constant>
    <constant name="struts.i18n.encoding" value="UTF-8"></constant>