struts設定檔屬性講解

Struts 2架構有兩個核心設定檔，其中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方法。
  struts.objectFactory：指定Struts 2預設的ObjectFactory Bean，該屬性預設值是spring。
  struts.objectFactory.spring.autoWire：指定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應用的Data Encryption Service連接埠。
  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檔案了。
在有些時候，開發人員不喜歡使用額外的struts.properties檔案，Struts 2允許在struts.xml檔案中管理Struts 2屬性，在struts.xml檔案中通過配置constant元素，一樣可以配置這些屬性。
struts.xml配置片段如下：

<?xml version="1.0" encoding="UTF-8" ?> <!-- 指定Struts 2的DTD資訊 --> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <!-- 通過constant元素配置Struts 2的屬性 --> <constant name=" struts.custom.i18n.resources " value="mess" /> ... </struts>

上面程式碼片段配置了一個常用屬性：struts.custom.i18n.resources，該屬性指定了應用所需的國際化資源檔的baseName為mess。
提示  Struts 2提供了兩種方式來管理Struts 2的屬性：既可以通過struts.properties檔案來配置Struts 2屬性，也可通過在struts.xml檔案中配置constant元素來配置Struts 2屬性