IT虾米网

struts2:struts.xml配置文件详解

leader 2018年06月22日 编程语言 400 0

1. 几个重要的元素

1.1 package元素

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

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

属性

说明

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

-extends

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

-namespace

  • 该属性可以指定包对应的命名空间。由于在一个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“里面查找。

示范:

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

1.2 action元素

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

action元素属性

属性名称

功能描述

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>

 

发布评论

分享到:

IT虾米网

微信公众号号:IT虾米 (左侧二维码扫一扫)欢迎添加!

struts2:拦截器详解
你是第一个吃螃蟹的人
发表评论

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。