XWork配置詳述

XWork配置文件是以“xwork”命名的.xml文件，它必需放到類路徑（classPath）的根目錄， Web應(yīng)用一般放在classes目錄中，它需要遵守DTD的規(guī)范（現(xiàn)在是xwork-1.0.dtd）。這個(gè)文件定義了我們的Action，Interceptor，Result的配置和相互之間的映射。下面我們看看用戶注冊(cè)的完整XWork配置文件：

<!DOCTYPE xwork PUBLIC "-//OpenSymphony Group//XWork 1.0//EN" "http://www.opensymphony.com/xwork/xwork-1.0.dtd">

<xwork>

    <include file="webwork-default.xml"/>

    <package name="example" extends="webwork-default">

       <action name="register" class="example.register.RegisterAction" >

           <result name="success" type="dispatcher">

              <param name="location">/register-result.jsp</param>

           </result>

           <interceptor-ref name="params"/>

       </action>

       <action name="registersupport" class="example.register.RegisterActionSupport" >

           <result name="success" type="dispatcher">

              <param name="location">/register-result.jsp</param>

           </result>

           <result name="input" type="dispatcher">

              <param name="location">/registerSupport.jsp</param>

           </result>

           <interceptor-ref name="validationWorkflowStack"/>

       </action>

    </package>

</xwork>

xwork.xml文件的標(biāo)簽元素

Xwork：xwork配置文件的所有內(nèi)容，都是定義在<xwork>標(biāo)簽中，它的直接子標(biāo)簽有<package>和<include>。

Package：我們的Action，Interceptor，Result都是在此標(biāo)簽中定義。<package>標(biāo)簽有一個(gè)必需的屬性“name”，它用來標(biāo)識(shí)唯一的一個(gè)package。屬性“extends”是可選的，它用來繼承前面定義的一個(gè)或一個(gè)以上package配置信息，包括所有的interceptor、interceptor-stack和action的配置信息。注意，配置文件按文檔的順序，由上向下執(zhí)行，因此，用“extends”引用的package必需在引用之前定義。屬性“sbstract”是可選的，它用來設(shè)置package為抽象的package，它可以被繼承同時(shí)它的Action配置信息在運(yùn)行時(shí)將不可見。

屬性namespace也是可選的，它用來分隔不同package定義的action，讓這些action處于不同的命名空間（namespaces）。這樣，我們不同的package可以有相同的action命名，因?yàn)榭梢酝ㄟ^命名空間來區(qū)分。如果不指定namespace，默認(rèn)的是空字符串。命名空間也可以被用在安全控制方面，它可以根據(jù)不同的命名空間指定不同的訪問權(quán)限。

Result-type：用來定義輸出結(jié)果類型的Class，它用簡(jiǎn)單的名－值對(duì)來定義。當(dāng)然，我們自己寫的輸出結(jié)果類型也必需在這里定義。例如：

<result-type name="dispatcher" class="com.opensymphony.webwork.dispatcher.ServletDispatcherResult" default="true"/>，default="true"表示如果在Action的result中不指定result-type，就使用這個(gè)默認(rèn)的result-type。

Interceptors：它是一個(gè)簡(jiǎn)單的<interceptors>  <interceptors/>標(biāo)簽，我們的interceptor和interceptor-stack都在此標(biāo)簽內(nèi)定義。

Interceptor：當(dāng)然，就是用來定義我們的攔截器。它的定義非常簡(jiǎn)單，名－值對(duì)的形式。例如：<interceptor name="timer" class="com.opensymphony.xwork.interceptor.TimerInterceptor"/>。在action中，可以通過<interceptor-ref />來直接引用前面定義了的攔截器。

Interceptor-stack：用來將上面定義的interceptor組織成堆棧的形式，這樣我們就可以創(chuàng)建一組標(biāo)準(zhǔn)的interceptor，讓它按照順序執(zhí)行。在我們的Action中直接引用這個(gè)interceptor堆棧就可以了，不用逐個(gè)interceptor去引用。

例如：

<interceptor-stack name="validationWorkflowStack">

               <interceptor-ref name="defaultStack"/>

                <interceptor-ref name="validation"/>

                <interceptor-ref name="workflow"/>

            </interceptor-stack>

Interceptor Param：我們的interceptor是在ActionConfig級(jí)別被實(shí)例化和存儲(chǔ)的，也就是說一個(gè)Action引用的每個(gè)interceptor都會(huì)有相應(yīng)的實(shí)例。這樣，我們?cè)诙x和引用interceptor的時(shí)候都可以為它設(shè)置相應(yīng)的參數(shù)值。例如：

<interceptor name="test" class="com.opensymphony.xwork.TestInterceptor">

    <param name="foo">expectedFoo</param>

</interceptor>

在Action或Interceptor-stack中引用時(shí)也可以設(shè)置參數(shù)，例如：

<interceptor-ref name="test">

    <param name="expectedFoo">expectedFoo</param>

</interceptor-ref>

注意：在Action引用的時(shí)候，如果引用的是Interceptor-stack，則不允許設(shè)置參數(shù)，否則會(huì)報(bào)錯(cuò)。

Global-results：它允許我們定義全局的輸出結(jié)果（global result），比如登陸頁面、操作錯(cuò)誤處理頁面。只要繼承它所在的package，這些輸出結(jié)果都是可見的。

例如：

<global-results>

           <result name="login" type="dispatcher">

              <param name="location">/login.jsp</param>

           </result>

           <result name="error" type="dispatcher">

              <param name="location">/error.jsp</param>

           </result>

       </global-results>

如果我們的Action執(zhí)行完返回“login”，它將調(diào)用上面的這個(gè)輸出結(jié)果，將輸出派遣到根目錄下的login.jsp頁面。

Action：用來配置Action的名稱（name）和它對(duì)應(yīng)的Class。我們將通過這個(gè)Action的名稱和它所在package的namespace去配置文件中取得這個(gè)Action的配置信息。它可以通過<param>來設(shè)置參數(shù)，Action在執(zhí)行的時(shí)候會(huì)取得配置文件里設(shè)置的參數(shù)（通過攔截器StaticParametersInterceptor）。

Action可以配置一個(gè)或多個(gè)輸出結(jié)果(result)。一個(gè)輸出結(jié)果的名稱，對(duì)應(yīng)于Action執(zhí)行完成返回的字符串。<result>標(biāo)簽的type屬性，對(duì)應(yīng)我們前面定義過的result-type，說明reslut的類型。例如：

<action name="register" class="example.register.RegisterAction" >

           <result name="success" type="dispatcher">

              <param name="location">/register-result.jsp</param>

           </result>

           <interceptor-ref name="params"/>

       </action>

當(dāng)然，我們的Action用到的攔截器也是在這里配置的，通過<interceptor-ref>標(biāo)簽，屬性“name”的值，對(duì)應(yīng)前面定義的interceptor或interceptor-stack。如果Action中沒有用<interceptor-ref>標(biāo)簽指定攔截器，它將使用默認(rèn)的<default-interceptor-ref>標(biāo)簽定義的攔截器。

Include：xwork..xml文件可以被分成好幾個(gè)不同的文件，xwork..xml通過<include>標(biāo)簽引用被包含的文件，例如：<include file="webwork-default.xml"/>。被包含的文件必需是package標(biāo)簽里的內(nèi)容，我們看看<include>標(biāo)簽在配置文件里的位置就知道了。如果要繼承被包含文件的package，我們必需將<include>標(biāo)簽放在其上面，因?yàn)榕渲梦募前凑沼缮隙碌捻樞蚪馕龅摹?/span>