Struts2教程3：struts.xml常用配置解析

在本文中將詳細講述struts.xml檔案的常用配置及注意事項。

1.    使用<include>標籤重用設定檔

在Struts2中提供了一個預設的struts.xml檔案，但如果package、action、interceptors等配置比較多時，都放到一個struts.xml檔案不太容易維護。因此，就需要將struts.xml檔案分成多個設定檔，然後在struts.xml檔案中使用<include>標籤引用這些設定檔。這樣做的優點如下：
(1)    結構更清晰，更容易維護配置資訊。
(2)    設定檔可以複用。如果在多個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都在裡面定義了。

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>。