先给一个模板吧,看看struts.xml是什么结构
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd" >
<struts>
<!-- include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 -->
<include file="struts-default.xml"></include>
<!-- package提供了将多个Action组织为一个模块的方式
package的名字必须是唯一的 package可以扩展 当一个package扩展自
另一个package时该package会在本身配置的基础上加入扩展的package
的配置 父package必须在子package前配置
name:package名称
extends:继承的父package名称
abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false
namespace:定义package命名空间 该命名空间影响到url的地址,例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action
-->
<package name="com.kay.struts2" extends="struts-default" namespace="/test">
<interceptors>
<!-- 定义拦截器
name:拦截器名称
class:拦截器类路径
-->
<interceptor name="timer" class="com.kay.timer"></interceptor>
<interceptor name="logger" class="com.kay.logger"></interceptor>
<!-- 定义拦截器栈 -->
<interceptor-stack name="mystack">
<interceptor-ref name="timer"></interceptor-ref>
<interceptor-ref name="logger"></interceptor-ref>
</interceptor-stack>
</interceptors>
<!-- 定义默认的拦截器 每个Action都会自动引用
如果Action中引用了其它的拦截器 默认的拦截器将无效 -->
<default-interceptor-ref name="mystack"></default-interceptor-ref>
<!-- 全局results配置 -->
<global-results>
<result name="input">/error.jsp</result>
</global-results>
<!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同)
name:action名称
class: 对应的类的路径
method: 调用Action中的方法名
-->
<action name="hello" class="com.kay.struts2.Action.LoginAction">
<!-- 引用拦截器
name:拦截器名称或拦截器栈名称-->
<interceptor-ref name="timer"></interceptor-ref>
<!-- 节点配置
name : result名称 和Action中返回的值相同
type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher
-->
<result name="success" type="dispatcher">/talk.jsp</result>
<!-- 参数设置
name:对应Action中的get/set方法
-->
<param name="url">http://www.sina.com</param>
</action>
</package>
</struts>
再看一个小例子
1. 使用< include>标签重用配置文件
在Struts2中提供了一个默认的struts.xml文件,但如果package、action、interceptors等配置比较多时,都放到一个struts.xml文件不太容易维护。因此,就需要将struts.xml文件分成多个配置文件,然后在struts.xml文件中使用< include>标签引用这些配置文件。这样做的优点如下:
结构更清晰,更容易维护配置信息。
配置文件可以复用。如果在多个Web程序中都使用类似或相同的配置文件,那么可以使用< include>标签来引用这些配置文件,这样可以减少工作量。
假设有一个配置文件,文件名为newstruts.xml,代码如下:
<?xmlversion="1.0"encoding="UTF-8"?> <!DOCTYPEstrutsPUBLIC "-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <packagename="demo"extends="struts-default"> <actionname="submit"class="action.MoreSubmitAction"> <resultname="save"> /result.jsp </result> <resultname="print"> /result.jsp </result> </action> </package> </struts> |
则struts.xml引用newstruts.xml文件的代码如下:
<?xmlversion="1.0"encoding="UTF-8"?> <!DOCTYPEstrutsPUBLIC "-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <includefile="newstruts.xml"/> <packagename="test"extends="struts-default"> </package> </struts> |
大家要注意一下,用< include>引用的xml文件也必须是完成的struts2的配置。实际上< include>在引用时是单独解析的xml文件,而不是将被引用的文件插入到struts.xml文件中。
2. action的别名
在默认情况下,Struts2会调用动作类的execute方法。但有些时候,我们需要在一个动作类中处理不同的动作。也就是用户请求不同的动作时,执行动作类中的不同的方法。为了达到这个目的,可以在< action>标签中通过method方法指定要指行的动作类的方法名,并且需要为不同的动作起不同的名子(也称为别名)。如下面代码所示:
<?xmlversion="1.0"encoding="UTF-8"?> <!DOCTYPEstrutsPUBLIC "-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <packagename="demo"extends="struts-default"> <actionname="test"class="action.MyAction"> </action> <actionname="my"class="action.MyAction"method="my"> </action> </package> </struts> |
上面代码的两个动作的class属性都指向同一个类,name为这个类起了两个动作别名:test和my。在动作my中,使用了method属性指定要要运行的方法名为my。
在MyAction类中必须要有my方法,代码如下:
packageaction; importcom.opensymphony.xwork2.ActionSupport; publicclassMyActionextendsActionSupport { publicStringexecute()throwsException { //处理test动作的代码 } publicStringmy()throwsException { //处理my动作的代码 } } |
除了在struts.xml中配置别名,还可以通过请求参数来描述指定动作(并不需要在struts.xml中配置)。请求参数的格式如下:
http://localhost:8080/contextPath/actionName!method.action
3. 为action指定参数在struts2中还可以为action指定一个或多个参数。大家还记着struts1.x是如何设置的action参数不? 在struts1.x中可以使用< action>标签的parameter属性为其指定一个action参数,如果要指定多个,就只能通过逗号(,)或其他的分隔符将不同的参数隔开。而在struts2中可以通过< param>标签指定任意多个参数。代码如下:
<actionname="submit"class="action.MyAction"> <paramname="param1">value1</param> <paramname="param2">value2</param> <resultname="save"> /result.jsp </result> </action> |
当然,在action中读这些参数也非常简单,只需要象获取请求参数一样在action类中定义相应的setter方法即可(一般不用定义getter方法)。如下面的代码将读取param1和param2参数的值:
packageaction; importcom.opensymphony.xwork2.ActionSupport; publicclassMyActionextendsActionSupport { privateStringparam1; privateStringparam2; publicStringexecute()throwsException { System.out.println(param1+param2); } publicvoidsetParam1(Stringparam1) { this.param1=param1; } publicvoidsetParam2(Stringparam2) { this.param2=param2; } } |
当struts2在调用execute之前,param1和param2的值就已经是相应参数的值了,因此,在execute方法中可以直接使用param1和param2。
4. 选择result类型
在默认时,< result>标签的type属性值是“dispatcher”(实际上就是转发,forward)。开发人员可以根据自己的需要指定不同的类型,如redirect、stream等。如下面代码所示:
<resultname="save"type="redirect"> /result.jsp </result> |
这此result-type可以在struts2-core-2.0.11.1.jar包或struts2源代码中的struts-default.xml文件中找到,在这个文件中找到< result-types>标签,所有的result-type都在里面定义了。代码如下:
<result-types> <result-typename="chain"class="com.opensymphony.xwork2.ActionChainResult"/> <result-typename="dispatcher"class="org.apache.struts2.dispatcher.ServletDispatcherResult"default="true"/> <result-typename="freemarker"class="org.apache.struts2.views.freemarker.FreemarkerResult"/> <result-typename="httpheader"class="org.apache.struts2.dispatcher.HttpHeaderResult"/> <result-typename="redirect"class="org.apache.struts2.dispatcher.ServletRedirectResult"/> <result-typename="redirectAction"class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/> <result-typename="stream"class="org.apache.struts2.dispatcher.StreamResult"/> <result-typename="velocity"class="org.apache.struts2.dispatcher.VelocityResult"/> <result-typename="xslt"class="org.apache.struts2.views.xslt.XSLTResult"/> <result-typename="plainText"class="org.apache.struts2.dispatcher.PlainTextResult"/> <!--DeprecatednameformscheduledforremovalinStruts2.1.0.ThecamelCaseversionsarepreferred.Seeww-1707--> <result-typename="redirect-action"class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/> <result-typename="plaintext"class="org.apache.struts2.dispatcher.PlainTextResult"/> </result-types> |
5. 全局result
有很多时候一个< result>初很多< action>使用,这时可以使用< global-results>标签来定义全局的< result>,代码如下:
<struts> <packagename="demo"extends="struts-default"> <global-results> <resultname="print">/result.jsp</result> </global-results> <actionname="submit"class="action.MoreSubmitAction"> </action> <actionname="my"class="action.MoreSubmitAction"method="my"> </action> </package> </struts> |
如果< action>中没有相应的< result>,Struts2就会使用全局的< result>。