struts2的配置檔案

貌似有點遺忘了 收集一下

類型

struts2共有4類配置檔案，

    struts.properties：定義架構自身的全局變量。

    struts-default.xml：定義架構自身使用的action映射及result定義。

    struts-plugin.xml：struts插件使用的配置檔案，比如當使用struts和spring結合時就需要在web.xml中引用該配置檔案。

    struts.xml：定義應用自身使用的action映射及result定義；當然我們一般将應用的各個子產品分不到不同的配置檔案中。

struts.propeies定義的全局屬性也可以在struts.xml中定義。 

引入

<filter>

    <filter-name>struts2</filter-name>

    <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>

    <init-param>

      <param-name>config</param-name>

      <param-value>struts-default.xml,struts-plugin.xml,struts.xml</param-value>

    </init-param>

</filter>

<filter-mapping>

    <filter-name>struts2</filter-name>

    <url-pattern>/*</url-pattern>

</filter-mapping>

目前路徑為web-inf/classes

全局屬性的加載順序

struts-default.xml->struts-plugin.xml->struts.xml->struts.properties->web.xml

如果之前的配置檔案設定過某一屬性，則以後加載的配置檔案對于相同屬性的設定，會覆寫之前的設定。

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之前通過include引用。

        abstract:設定package的屬性為抽象的 抽象的package不能定義action 值true:false

        namespace:定義package命名空間 該命名空間影響到url的位址，例如此命名空間為/test那麼通路是的位址為http://localhost:8080/test/X.action

     -->

    <package name="com.kay.struts2" extends="struts-default" namespace="/test">

        <interceptors>

            <!-- 定義攔截器-->

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

            <!-- 參數設定-->

            <param name="url">http://www.sina.com</param>

        </action>

     <!--如果你僅僅需要頁面跳轉,就沒必要在寫一個action了,直接用ActionSupport就行了-->   

     <action name="login" class="com.opensymphony.xwork2.ActionSupport">   

     <!--預設傳回success,我上面定義預設type為freemarker,這裡就不用定義type屬性了-->   

     <result>/Login.ftl</result>   

     </action>     

    </package>

</struts>

stuts2中各配置參數解析

struts.configuration：該屬性指定加載Struts 2配置檔案的配置檔案管理器。該屬性的預設值是org.apache.Struts2.config.DefaultConfiguration，這是Struts2預設的配置檔案管理器。如果需要實作自己的配置管理器，開發者則可以實作一個實作Configuration接口的類，該類可以自己加載Struts2配置檔案。 

struts.locale：指定Web應用的預設Locale。 

struts.i18n.encoding：指定Web應用的預設編碼集。該屬性對于進行中文請求參數非常有用，對于擷取中文請求參數值，應該将該屬性值設定為GBK或者GB2312。提示 當設定該參數為GBK時，相當于調用HttpServletRequest的setCharacterEncoding方法。 

struts.objectFactory：指定Struts 2預設的ObjectFactory Bean，該屬性預設值是spring。 

struts.objectFactory.spring.autoWrite：指定Spring架構的自動裝配模式，該屬性的預設值是name，即預設根據Bean的name屬性自動裝配。 

struts.objectFactory.spring.useClassCache：該屬性指定整合Spring架構時，是否緩存Bean執行個體，該屬性隻允許使用true和false兩個屬性值，它的預設值是true。通常不建議修改該屬性值。 

struts.objectTypeDeterminer：該屬性指定Struts 2的類型檢測機制，通常支援tiger和notiger兩個屬性值。 

struts.multipart.parser：該屬性指定處理multipart/form-data的MIME類型（檔案上傳）請求的架構，該屬性支援cos、pell和jakarta等屬性值，即分别對應使用cos的檔案上傳架構、pell上傳及common-fileupload檔案上傳架構。該屬性的預設值為jakarta。注意 如果需要使用cos或者pell的檔案上傳方式，則應該将對應的JAR檔案複制到Web應用中。例如，使用cos上傳方式，則需要自己下載下傳cos架構的JAR檔案，并将該檔案放在WEB-INF/lib路徑下。 

struts.multipart.saveDir：該屬性指定上傳檔案的臨時儲存路徑，該屬性的預設值是javax.servlet.context.tempdir。

struts.multipart.maxSize：該屬性指定Struts 2檔案上傳中整個請求内容允許的最大位元組數。 

struts.custom.properties：該屬性指定Struts 2應用加載使用者自定義的屬性檔案，該自定義屬性檔案指定的屬性不會覆寫struts.properties檔案中指定的屬性。如果需要加載多個自定義屬性檔案，多個自定義屬性檔案的檔案名以英文逗号隔開。 

struts.mapper.class：指定将HTTP請求映射到指定Action的映射器，Struts 2提供了預設的映射器：org.apache.struts2.dispatcher.mapper.DefaultActionMapper。預設映射器根據請求的字首與Action的name屬性完成映射。 

struts.action.extension：該屬性指定需要Struts2處理的請求字尾，該屬性的預設值是action，即所有比對*.action的請求都由Struts2處理。如果使用者需要指定多個請求字尾，則多個字尾之間以英文逗号（,）隔開。 

struts.serve.static：該屬性設定是否通過JAR檔案提供靜态内容服務，該屬性隻支援true和false屬性值，該屬性的預設屬性值是true。 

struts.serve.static.browserCache：該屬性設定浏覽器是否緩存靜态内容。當應用處于開發階段時，我們希望每次請求都獲得伺服器的最新響應，則可設定該屬性為false。 

struts.enable.DynamicMethodInvocation：該屬性設定Struts 2是否支援動态方法調用，該屬性的預設值是true。如果需要關閉動态方法調用，則可設定該屬性為false。 

struts.enable.SlashesInActionNames：該屬性設定Struts 2是否允許在Action名中使用斜線，該屬性的預設值是false。如果開發者希望允許在Action名中使用斜線，則可設定該屬性為true。 

struts.tag.altSyntax： 該屬性指定是否允許在Struts 2标簽中使用表達式文法，因為通常都需要在标簽中使用表達式文法，故此屬性應該設定為true，該屬性的預設值是true。 

struts.devMode：該屬性設定Struts 2應用是否使用開發模式。如果設定該屬性為true，則可以在應用出錯時顯示更多、更友好的出錯提示。該屬性隻接受true和flase兩個值，該屬性的預設值是false。通常，應用在開發階段，将該屬性設定為true，當進入産品釋出階段後，則該屬性設定為false。 

struts.i18n.reload：該屬性設定是否每次HTTP請求到達時，系統都重新加載資源檔案。該屬性預設值是false。在開發階段将該屬性設定為true會更有利于開發，但在産品釋出階段應将該屬性設定為false。提示 開發階段将該屬性設定了true，将可以在每次請求時都重新加載國際化資源檔案，進而可以讓開發者看到實時開發效果；産品釋出階段應該将該屬性設定為false，是為了提供響應性能，每次請求都需要重新加載資源檔案會大大降低應用的性能。 

struts.ui.theme：該屬性指定視圖示簽預設的視圖主題，該屬性的預設值是xhtml。 

struts.ui.templateDir：該屬性指定視圖主題所需要模闆檔案的位置，該屬性的預設值是template，即預設加載template路徑下的模闆檔案。 

struts.ui.templateSuffix：該屬性指定模闆檔案的字尾，該屬性的預設屬性值是ftl。該屬性還允許使用ftl、vm或jsp，分别對應FreeMarker、Velocity和JSP模闆。 

struts.configuration.xml.reload：該屬性設定當struts.xml檔案改變後，系統是否自動重新加載該檔案。該屬性的預設值是false。 

struts.velocity.configfile：該屬性指定Velocity架構所需的velocity.properties檔案的位置。該屬性的預設值為velocity.properties。 

struts.velocity.contexts：該屬性指定Velocity架構的Context位置，如果該架構有多個Context，則多個Context之間以英文逗号隔開。 

struts.velocity.toolboxlocation：該屬性指定Velocity架構的toolbox的位置。 

struts.url.http.port：該屬性指定Web應用所在的監聽端口。該屬性通常沒有太大的使用者，隻是當Struts 2需要生成URL時（例如Url标簽），該屬性才提供Web應用的預設端口。 

struts.url.https.port：該屬性類似于struts.url.http.port屬性的作用，差別是該屬性指定的是Web應用的加密服務端口。 

struts.url.includeParams：該屬性指定Struts 2生成URL時是否包含請求參數。該屬性接受none、get和all三個屬性值，分别對應于不包含、僅包含GET類型請求參數和包含全部請求參數。 

struts.custom.i18n.resources：該屬性指定Struts 2應用所需要的國際化資源檔案，如果有多份國際化資源檔案，則多個資源檔案的檔案名以英文逗号隔開。 

struts.dispatcher.parametersWorkaround：對于某些Java EE伺服器，不支援HttpServlet Request調用getParameterMap()方法，此時可以設定該屬性值為true來解決該問題。該屬性的預設值是false。對于WebLogic、Orion和OC4J伺服器，通常應該設定該屬性為true。 

struts.freemarker.manager.classname：該屬性指定Struts 2使用的FreeMarker管理器。該屬性的預設值是org.apache.struts2.views.freemarker.FreemarkerManager，這是Struts 2内建的FreeMarker管理器。 

struts.freemarker.wrapper.altMap：該屬性隻支援true和false兩個屬性值，預設值是true。通常無需修改該屬性值。 

struts.xslt.nocache：該屬性指定XSLT Result是否使用樣式表緩存。當應用處于開發階段時，該屬性通常被設定為true；當應用處于産品使用段時，該屬性通常被設定為false。 

struts.configuration.files：該屬性指定Struts 2架構預設加載的配置檔案，如果需要指定預設加載多個配置檔案，則多個配置檔案的檔案名之間以英文逗号隔開。該屬性的預設值為struts-default.xml,struts-plugin.xml,struts.xml，看到該屬性值，讀者應該明白為什麼Struts 2架構預設加載struts.xml檔案了。

這個檔案是struts2架構的全局屬性檔案，也是自動加載的檔案。該檔案包含了系列的key-value對。該檔案完全可以配置在struts.xml檔案中，使用constant元素。下面是這個檔案中一些常見的配置項及說明。

struts.configuration

    該屬性指定加載Struts 2配置檔案的配置檔案管理器。該屬性的預設值是org.apache.Struts2.config.DefaultConfiguration，這是 Struts 2預設的配置檔案管理器。如果需要實作自己的配置管理器，開發者則可以實作一個實作Configuration接口的類，該類可以自己加載Struts 2配置檔案。

struts.locale

指定Web應用的預設Locale。

struts.i18n.encoding

     指定Web應用的預設編碼集。該屬性對于進行中文請求參數非常有用，對于擷取中文請求參數值，應該将該屬性值設定為GBK或者GB2312。

提示  當設定該參數為GBK時，相當于調用HttpServletRequest的setCharacterEncoding方法。

struts.objectFactory

    指定Struts2預設的ObjectFactory Bean，該屬性預設值是spring。

struts.objectFactory.spring.autoWrite

     指定Spring架構的自動裝配模式，該屬性的預設值是name，即預設根據Bean的name屬性自動裝配。

struts.objectFactory.spring.useClassCache

      該屬性指定整合Spring架構時，是否緩存Bean執行個體，該屬性隻允許使用true和false兩個屬性值，它的預設值是true。通常不建議修改該屬性值。

struts.objectTypeDeterminer

    該屬性指定Struts 2的類型檢測機制，通常支援tiger和notiger兩個屬性值。

 struts.multipart.parser ：該屬性指定處理multipart/form-data的MIME類型（檔案上傳）請求的架構，該屬性支援cos、pell和jakarta等屬性值，即分别對應使用cos的檔案上傳架構、pell上傳及common-fileupload檔案上傳架構。該屬性的預設值為jakarta。

注意  如果需要使用cos或者pell的檔案上傳方式，則應該将對應的JAR檔案複制到Web應用中。例如，使用cos上傳方式，則需要自己下載下傳cos架構的JAR檔案，并将該檔案放在WEB-INF/lib路徑下。

struts.multipart.saveDir

    該屬性指定上傳檔案的臨時儲存路徑，該屬性的預設值是javax.servlet.context.tempdir。

 struts.multipart.maxSize

該屬性指定Struts 2檔案上傳中整個請求内容允許的最大位元組數。

struts.custom.properties

    該屬性指定Struts 2應用加載使用者自定義的屬性檔案，該自定義屬性檔案指定的屬性不會覆寫struts.properties檔案中指定的屬性。如果需要加載多個自定義屬性檔案，多個自定義屬性檔案的檔案名以英文逗号（,）隔開。

struts.mapper.class

    指定将HTTP請求映射到指定Action的映射器，Struts 2提供了預設的映射器：org.apache.struts2.dispatcher.mapper.DefaultActionMapper。預設映射器根據請求的字首與Action的name屬性完成映射。

struts.action.extension

     該屬性指定需要Struts 2處理的請求字尾，該屬性的預設值是action，即所有比對*.action的請求都由Struts 2處理。如果使用者需要指定多個請求字尾，則多個字尾之間以英文逗号（,）隔開。

struts.serve.static

    該屬性設定是否通過JAR檔案提供靜态内容服務，該屬性隻支援true和false屬性值，該屬性的預設屬性值是true。

struts.serve.static.browserCache

    該屬性設定浏覽器是否緩存靜态内容。當應用處于開發階段時，我們希望每次請求都獲得伺服器的最新響應，則可設定該屬性為false。

 struts.enable.DynamicMethodInvocation

   該屬性設定Struts 2是否支援動态方法調用，該屬性的預設值是true。如果需要關閉動态方法調用，則可設定該屬性為false。

struts.enable.SlashesInActionNames

   該屬性設定Struts 2是否允許在Action名中使用斜線，該屬性的預設值是false。如果開發者希望允許在Action名中使用斜線，則可設定該屬性為true。

 struts.tag.altSyntax

   該屬性指定是否允許在Struts 2标簽中使用表達式文法，因為通常都需要在标簽中使用表達式文法，故此屬性應該設定為true，該屬性的預設值是true。

 struts.devMode

該屬性設定Struts 2應用是否使用開發模式。如果設定該屬性為true，則可以在應用出錯時顯示更多、更友好的出錯提示。該屬性隻接受true和flase兩個值，該屬性的預設值是false。通常，應用在開發階段，将該屬性設定為true，當進入産品釋出階段後，則該屬性設定為false。

struts.i18n.reload

該屬性設定是否每次HTTP請求到達時，系統都重新加載資源檔案。該屬性預設值是false。在開發階段将該屬性設定為true會更有利于開發，但在産品釋出階段應将該屬性設定為false。

提示  開發階段将該屬性設定了true，将可以在每次請求時都重新加載國際化資源檔案，進而可以讓開發者看到實時開發效果；産品釋出階段應該将該屬性設定為false，是為了提供響應性能，每次請求都需要重新加載資源檔案會大大降低應用的性能。

struts.ui.theme

該屬性指定視圖示簽預設的視圖主題，該屬性的預設值是xhtml。

struts.ui.templateDir

該屬性指定視圖主題所需要模闆檔案的位置，該屬性的預設值是template，即預設加載template路徑下的模闆檔案。

struts.ui.templateSuffix

該屬性指定模闆檔案的字尾，該屬性的預設屬性值是ftl。該屬性還允許使用ftl、vm或jsp，分别對應FreeMarker、Velocity和JSP模闆。

struts.configuration.xml.reload

該屬性設定當struts.xml檔案改變後，系統是否自動重新加載該檔案。該屬性的預設值是false。

struts.velocity.configfile

該屬性指定Velocity架構所需的velocity.properties檔案的位置。該屬性的預設值為velocity.properties。

 struts.velocity.contexts

該屬性指定Velocity架構的Context位置，如果該架構有多個Context，則多個Context之間以英文逗号（,）隔開。

struts.velocity.toolboxlocation

該屬性指定Velocity架構的toolbox的位置。

struts.url.http.port

該屬性指定Web應用所在的監聽端口。該屬性通常沒有太大的使用者，隻是當Struts 2需要生成URL時（例如Url标簽），該屬性才提供Web應用的預設端口。

struts.url.https.port

該屬性類似于struts.url.http.port屬性的作用，差別是該屬性指定的是Web應用的加密服務端口。

struts.url.includeParams

該屬性指定Struts 2生成URL時是否包含請求參數。該屬性接受none、get和all三個屬性值，分别對應于不包含、僅包含GET類型請求參數和包含全部請求參數。

  struts.custom.i18n.resources

該屬性指定Struts 2應用所需要的國際化資源檔案，如果有多份國際化資源檔案，則多個資源檔案的檔案名以英文逗号（,）隔開。

struts.dispatcher.parametersWorkaround

    對于某些Java EE伺服器，不支援HttpServlet Request調用getParameterMap()方法，此時可以設定該屬性值為true來解決該問題。該屬性的預設值是false。對于 WebLogic、Orion和OC4J伺服器，通常應該設定該屬性為true。

 struts.freemarker.manager.classname

    該屬性指定Struts 2使用的FreeMarker管理器。該屬性的預設值是org.apache.struts2.views.freemarker.FreemarkerManager，這是Struts 2内建的FreeMarker管理器。

struts.freemarker.wrapper.altMap

該屬性隻支援true和false兩個屬性值，預設值是true。通常無需修改該屬性值。

 struts.xslt.nocache

    該屬性指定XSLT Result是否使用樣式表緩存。當應用處于開發階段時，該屬性通常被設定為true；當應用處于産品使用階段時，該屬性通常被設定為false。

struts.configuration.files

    該屬性指定Struts 2架構預設加載的配置檔案，如果需要指定預設加載多個配置檔案，則多個配置檔案的檔案名之間以英文逗号（,）隔開。該屬性的預設值為struts-default.xml,struts-plugin.xml,struts.xml，看到該屬性值，讀者應該明白為什麼Struts 2架構預設加載struts.xml檔案了。