struts.properties 配置解析

### struts.properties這是一個标準的Properties檔案，'='前面字元串是key

  2 ### 每個key就是一個Struts2屬性，'='後面對應的value就是一個Struts2屬性值

  3 ### struts.properties檔案通常放在項目裡的WEB-INF/classes路徑下。

  4 ### 也可也放在CLASSPATH路徑下，Struts2架構就可以加載該檔案

  5 ### 以下這些元素同樣可以在Struts2的struts.xml中通過constant配置

  6

  7 ### 指定加載Struts 2配置檔案的配置檔案管理器

  8 ### 該屬性的預設值是org.apache.Struts2.config.DefaultConfiguration，

  9 ### 這是Struts 2預設的配置檔案管理器。如果需要實作自己的配置管理器，

 10 ### 開發者則可以實作一個實作Configuration接口的

 11 ### 類，該類可以自己加載Struts 2配置檔案。

 12 #struts.configuration = org.apache.struts2.config.DefaultConfiguration

 13

 14 ### 指定Web應用的預設Locale

 15 #struts.locale=en_US

 16

 17 ### 指定Web應用的預設編碼集。該屬性對于進行中文請求參數非常有用，對于擷取

 18 ### 中文請求參數值，應該将該屬性值設定為GBK或者GB2312

 19 struts.i18n.encoding=UTF-8

 20

 21 ### 指定Struts 2預設的ObjectFactory Bean

 22 ### 另外，你也可以提供一個com.opensymphony.xwork2.ObjectFactory子類名稱

 23 ### 預設指定spring

 24 struts.objectFactory=spring

 25

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

 27 ### name屬性自動裝配 。有效值為：name, type, auto, constructor

 28 struts.objectFactory.spring.autoWire = name

 29

 30 ### 指定整合Spring架構時,是否緩存Bean執行個體

 31 ### 有效值為:true, false (預設值是true) 通常不建議修改該屬性值。

 32 struts.objectFactory.spring.useClassCache = true

 33

 34 ### 確定spring的自動裝配政策總是被考慮的

 35 ### 有效值為:true, false (黑認值是false)

 36 struts.objectFactory.spring.autoWire.alwaysRespect = false

 37

 38 ### struts.objectTypeDeterminer指定Struts2的類型檢測機制，通常支援

 39 ### tiger和notiger兩個值

 40 # struts.objectTypeDeterminer =tiger

 41 # struts.objectTypeDeterminer = notiger

 42

 43 ### 指定處理multipart/form-data的MIME類型（檔案上傳）請求的架構，該屬性

 44 ### 支援cos、pell和jakarta等屬性值，即分别對應使用cos的檔案上傳架構、

 45 ### pell上傳及common-fileupload檔案上傳架構。該屬性的預設值為jakarta。

 46 # struts.multipart.parser=cos

 47 # struts.multipart.parser=pell

 48 struts.multipart.parser=jakarta

 49

 50 ### struts.multipart.saveDir該屬性指定上傳檔案的臨時儲存路

 51 ### 徑，預設值是javax.servlet.context.tempdir

 52 struts.multipart.saveDir=

 53

 54 ##指定檔案上傳中整個請求内容允許的最大位元組數（ 預設2097152）

 55 struts.multipart.maxSize=2097152

 56

 57 ### 加載自定義屬性檔案(不會覆寫struts.properties)加載多個以E文逗号隔開

 58 # struts.custom.properties=application,org/apache/struts2/extension/custom

 59

 60 ### 指定将HTTP請求映射到指定Action的映射器,預設映射器根據請求的字首與

 61 ### Action的name屬性完成映射

 62 #struts.mapper.class=org.apache.struts2.dispatcher.mapper.DefaultActionMapper

 63

 64 ### 指定需要處理的請求字尾，預設是action，

 65 ### 即所有比對*.action的請求都由Struts2處理。需要指定多個字尾以E文逗号隔開

 66 struts.action.extension=action,,

 67

 68 ### 設定是否通過JAR檔案提供靜态内容服務

 69 struts.serve.static=true

 70

 71 ### 設定浏覽器是否緩存靜态容，當應用處于開發階段時，

 72 ### 我們希望每次請求都獲得伺服器的最新響應，則可以設定為false

 73 struts.serve.static.browserCache=true

 74

 75 ### 設定是否支援動态方法調用，如果需要關閉動态方法調用，則可以設定為false

 76 struts.enable.DynamicMethodInvocation = true

 77

 78 ### 該屬性設定是否允許在Action名中使用斜線，預設不使用

 79 struts.enable.SlashesInActionNames = false

 80

 81 ### 設定是否允許在标簽中使用表達文法

 82 struts.tag.altSyntax=true

 83

 84 ### 設定Struts2應用是否使用開發模式。如果設定該屬性為true，

 85 ### 則可以在應用出錯時顯示更多詳細的錯誤資訊

 86 struts.devMode = false

 87

 88 ### 設定是否每次HTTP請求到達時，系統都重新加載資源檔案。在開發階段設定

 89 ### true更有得于開發 産品釋出時為false

 90 struts.i18n.reload=false

 91

 92 ### 指定視圖示簽的視圖主題

 93 struts.ui.theme=xhtml

 94

 95 ### 指定視圖主題所需要模闆檔案的位置，預設值為template 即預設加載

 96 ### template路經下的模闆檔案

 97 struts.ui.templateDir=template

 98

 99 ### 指定模闆檔案的字尾，允許使用ftl, vm 或 jsp

100 ###（分别對應FreeMarker, Velocity, JSP）預設值為ftl

101 struts.ui.templateSuffix=ftl

102

103 ### 設定當struts.xml檔案改變後，系統是否自動重新加載該檔案

104 struts.configuration.xml.reload=false

105

106 ### 指定Velocite架構所需的velocity.properties檔案的位置

107 struts.velocity.configfile = velocity.properties

108

109 ### 指定Velocity架構的Context位置，如果該架構有多個Context，則以E文逗号隔開

110 struts.velocity.contexts =

111

112 ### 指定Velocity架構的toolbox位置。

113 struts.velocity.toolboxlocation=

114

115 ### 指定web應用所在的監聽端口。通常沒有太大的使用者，隻是當Struts2需要生成

116 ### URL時（例如Url标簽）該屬性才提供web應用的預設端口

117 struts.url.http.port = 80

118

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

120 struts.url.https.port = 443

121

122 ### 指定Struts2生成URL時是否包含請求參數。none, get, all

123 ###（不包含，僅包含GET類型請求參數，包含全部請求參數）

124 struts.url.includeParams = get

125

126 ### 指定應用所需要的國際化資源檔案，多個檔案以E文 逗号隔開

127 # struts.custom.i18n.resources=testmessages,testmessages2

128

129 ### 對于某些JavaEE伺服器，不支援HttpServletRequest調用getParameterMap()方法，

130 ### 此時可以設定屬性值為true來解決該問題對于 WebLogic, Orion, 和 OC4J 通常應該

131 ### 設定該屬性為true

132 struts.dispatcher.parametersWorkaround = false

133

134 ### 指定Struts 2使用的FreeMarker管理器。該屬性的預設

135 ### 值是 org.apache.struts2.views.freemarker.FreemarkerManager，

136 ### 這是Struts 2内建的FreeMarker管理器

137 #struts.freemarker.manager.classname=org.apache.struts2.views.freemarker.FreemarkerManager

138

139 ### 指定是否啟用緩存FreeMarker模闆

140 ### 具有相同的效果複制的模闆下WEB_APP /模闆

141 struts.freemarker.templatesCache=false

142

143 ### 是否使用緩存模型BeanWrapper

144 struts.freemarker.beanwrapperCache=false

145

146 ### StrutsBeanWrapper javadocs以擷取更多資訊

147 struts.freemarker.wrapper.altMap=true

148

149 ### maxStrongSize for MruCacheStorage for freemarker

150 struts.freemarker.mru.max.strong.size=100

151

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

153 struts.xslt.nocache=false

154

155 ### 是否總是選擇的名稱将之前的所有最後的斜線

156 struts.mapper.alwaysSelectFullNamespace=false

157

158 ### 是否允許靜态方法通路OGNL表達式

159 struts.ognl.allowStaticMethodAccess=false

==========================================================

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

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

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

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

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

— 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檔案了。