在本文中將詳細講述struts.xml文件的常用配置及注意事項。
1.使用<include>標簽重用配置文件
在Struts2中提供了一個默認的struts.xml文件,但如果package、action、interceptors等配置比較多時,都放到一個struts.xml文件不太容易維護。因此,就需要將struts.xml文件分成多個配置文件,然後在struts.xml文件中使用<include>標簽引用這些配置文件。這樣做的優點如下:
結構更清晰,更容易維護配置信息。
配置文件可以復用。如果在多個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會調用動作類的execute方法。但有些時候,我們需要在一個動作類中處理不同的動作。也就是用戶請求不同的動作時,執行動作類中的不同的方法。為了達到這個目的,可以在<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中配置別名,還可以通過請求參數來描述指定動作(並不需要在struts.xml中配置)。請求參數的格式如下:
http://localhost:8080/contextPath/actionName!method.action
關於通過請求指定動作的詳細內容,請參閱筆者寫的《Struts2教程2:處理一個form多個submit》。
3.為action指定參數
在struts2中還可以為action指定一個或多個參數。大家還記著struts1.x是如何設置的action參數不? 在struts1.x中可以使用<action>標簽的parameter屬性為其指定一個action參數,如果要指定多個,就只能通過逗號(,)或其他的分隔符將不同的參數隔開。而在struts2中可以通過<param>標簽指定任意多個參數。代碼如下:
<action name="submit" class="action.MyAction"> <param name="param1">value1</param> <param name="param2">value2</param> <result name="save" > /result.jsp </result> ... ... </action>
當然,在action中讀這些參數也非常簡單,只需要象獲取請求參數一樣在action類中定義相應的setter方法即可(一般不用定義getter方法)。如下面的代碼將讀取param1和param2參數的值:
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在調用execute之前,param1和param2的值就已經是相應參數的值了,因此,在execute方法中可以直接使用param1和param2。
4.選擇result類型
在默認時,<result>標簽的type屬性值是“dispatcher”(實際上就是轉發,forward)。開發人員可以根據自己的需要指定不同的類型,如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>。