struts2 的struts.properties(xml)配置詳解

最近在用到struts2，xml需要配置配置一些檔案，具體介紹如下：

Struts2架構有兩個核心配置檔案，其中struts.xml檔案主要負責管理應用中的Action映射，以及該Action包含的Result定義等。除此之外，Struts 2架構還包含     struts.properties檔案，該檔案定義了Struts 2架構的大量屬性，開發者可以通過改變這些屬性來滿足應用的需求。

struts.properties檔案是一個标準的Properties檔案，該檔案包含了系列的key-value對象，每個key就是一個Struts 2屬性，該key對應的value就是一個Struts 2屬性值。

struts.properties檔案通常放在Web應用的WEB-INF/classes路徑下。實際上，隻要将該檔案放在Web應用的CLASSPATH路徑下，Struts 2架構就可以加載該檔案。

現在的問題是，struts.properties檔案的哪些key是有效的？即struts.properties檔案裡包含哪些屬性是有效的Struts 2屬性。下面列出了可以在struts.properties中定義的Struts 2屬性。

   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方法。 字串5

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

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

字串2

  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檔案中指定的屬性。如果需要加載多個自定義屬性檔案，多個自定義屬性檔案的檔案名以英文逗号（,）隔開。

字串2

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

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

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

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

 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。 字串4

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

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

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

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