Struts2教程:struts.xml常用配置解析
在本文中將詳細講述struts.xml文件的常用配置及注意事項。
1. 使用< include>標簽重用配置文件
在Struts2中提供了一個默認的struts.xml文件,但如果package、action、interceptors等配置比較多時,都放到一個struts.xml文件不太容易維護。因此,就需要將struts.xml文件分成多個配置文件,然后在struts.xml文件中使用< include>標簽引用這些配置文件。這樣做的優(yōu)點如下:
結(jié)構(gòu)更清晰,更容易維護配置信息。
配置文件可以復用。如果在多個Web程序中都使用類似或相同的配置文件,那么可以使用< include>標簽來引用這些配置文件,這樣可以減少工作量。
假設有一個配置文件,文件名為newstruts.xml,代碼如下:
- < ?xml version="1.0" encoding="UTF-8" ?>
- < !DOCTYPE struts PUBLIC
- "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
- "http://struts.apache.org/dtds/struts-2.0.dtd">
- < struts>
- < package name="demo" extends="struts-default" >
- < action name="submit" class="action.MoreSubmitAction">
- < result name="save" >
- /result.jsp
- < /result>
- < result name="print">
- /result.jsp
- < /result>
- < /action>
- < /package>
- < /struts>
則struts.xml引用newstruts.xml文件的代碼如下:
- < ?xml version="1.0" encoding="UTF-8" ?>
- < !DOCTYPE struts PUBLIC
- "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
- "http://struts.apache.org/dtds/struts-2.0.dtd">
- < struts>
- < include file="newstruts.xml"/>
- < package name="test" extends="struts-default">
- < /package>
- < /struts>
大家要注意一下,用< include>引用的xml文件也必須是完成的struts2的配置。實際上< include>在引用時是單獨解析的xml文件,而不是將被引用的文件插入到struts.xml文件中。
2. action的別名
在默認情況下,Struts2會調(diào)用動作類的execute方法。但有些時候,我們需要在一個動作類中處理不同的動作。也就是用戶請求不同的動作時,執(zhí)行動作類中的不同的方法。為了達到這個目的,可以在< action>標簽中通過method方法指定要指行的動作類的方法名,并且需要為不同的動作起不同的名子(也稱為別名)。如下面代碼所示:
- < ?xml version="1.0" encoding="UTF-8" ?>
- < !DOCTYPE struts PUBLIC
- "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
- "http://struts.apache.org/dtds/struts-2.0.dtd">
- < struts>
- < package name="demo" extends="struts-default" >
- < action name="test" class="action.MyAction">
- < /action>
- < action name="my" class="action. MyAction" method="my">
- < /action>
- < /package>
- < /struts>
上面代碼的兩個動作的class屬性都指向同一個類,name為這個類起了兩個動作別名:test和my。在動作my中,使用了method屬性指定要要運行的方法名為my。
在MyAction類中必須要有my方法,代碼如下:
- package action;
- import com.opensymphony.xwork2.ActionSupport;
- public class MyAction extends ActionSupport
- {
- public String execute() throws Exception
- {
- // 處理test動作的代碼
- }
- public String my() throws Exception
- {
- // 處理my動作的代碼
- }
- }
除了在struts.xml中配置別名,還可以通過請求參數(shù)來描述指定動作(并不需要在struts.xml中配置)。請求參數(shù)的格式如下:
http://localhost:8080/contextPath/actionName!method.action
關(guān)于通過請求指定動作的詳細內(nèi)容,請參閱筆者寫的《Struts2教程2:處理一個form多個submit》。
3. 為action指定參數(shù)
在struts2中還可以為action指定一個或多個參數(shù)。大家還記著struts1.x是如何設置的action參數(shù)不? 在struts1.x中可以使用< action>標簽的parameter屬性為其指定一個action參數(shù),如果要指定多個,就只能通過逗號(,)或其他的分隔符將不同的參數(shù)隔開。而在struts2中可以通過< param>標簽指定任意多個參數(shù)。代碼如下:
- < action name="submit" class="action.MyAction">
- < param name="param1">value1< /param>
- < param name="param2">value2< /param>
- < result name="save" >
- /result.jsp
- < /result>
- < /action>
當然,在action中讀這些參數(shù)也非常簡單,只需要象獲取請求參數(shù)一樣在action類中定義相應的setter方法即可(一般不用定義getter方法)。如下面的代碼將讀取param1和param2參數(shù)的值:
- package action;
- import com.opensymphony.xwork2.ActionSupport;
- public class MyAction extends ActionSupport
- {
- private String param1;
- private String param2;
- public String execute() throws Exception
- {
- System.out.println(param1 + param2);
- }
- public void setParam1(String param1)
- {
- this.param1 = param1;
- }
- public void setParam2(String param2)
- {
- this.param2 = param2;
- }
- }
當struts2在調(diào)用execute之前,param1和param2的值就已經(jīng)是相應參數(shù)的值了,因此,在execute方法中可以直接使用param1和param2。
4. 選擇result類型
在默認時,< result>標簽的type屬性值是“dispatcher”(實際上就是轉(zhuǎn)發(fā),forward)。開發(fā)人員可以根據(jù)自己的需要指定不同的類型,如redirect、stream等。如下面代碼所示:
< result name="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-type name="chain" class="com.opensymphony.xwork2.ActionChainResult"/>
- < result-type name="dispatcher" class="org.apache.struts2.dispatcher.ServletDispatcherResult" default="true"/>
- < result-type name="freemarker" class="org.apache.struts2.views.freemarker.FreemarkerResult"/>
- < result-type name="httpheader" class="org.apache.struts2.dispatcher.HttpHeaderResult"/>
- < result-type name="redirect" class="org.apache.struts2.dispatcher.ServletRedirectResult"/>
- < result-type name="redirectAction" class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/>
- < result-type name="stream" class="org.apache.struts2.dispatcher.StreamResult"/>
- < result-type name="velocity" class="org.apache.struts2.dispatcher.VelocityResult"/>
- < result-type name="xslt" class="org.apache.struts2.views.xslt.XSLTResult"/>
- < result-type name="plainText" class="org.apache.struts2.dispatcher.PlainTextResult" />
- < !-- Deprecated name form scheduled for removal in Struts 2.1.0. The camelCase versions are preferred. See ww-1707 -->
- < result-type name="redirect-action" class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/>
- < result-type name="plaintext" class="org.apache.struts2.dispatcher.PlainTextResult" />
- < /result-types>
5. 全局result
有很多時候一個< result>初很多< action>使用,這時可以使用< global-results>標簽來定義全局的< result>,代碼如下:
- < struts>
- < package name="demo" extends="struts-default">
- < global-results>
- < result name="print">/result.jsp< /result>
- < /global-results>
- < action name="submit" class="action.MoreSubmitAction">
- < /action>
- < action name="my" class="action.MoreSubmitAction" method="my">
- < /action>
- < /package>
- < /struts>
如果< action>中沒有相應的< result>,Struts2就會使用全局的< result>。
【編輯推薦】