Struts2的配置信息

1、perties配置詳解 Struts 2框架有兩個核心配置文件，其中struts.xml文件主要負(fù)責(zé)管理應(yīng)用中的Action映射，以及該Action包含的Result定義等。除此之 外，Struts 2框架還包含     perties文件，該文件定義了Struts 2框架的大量屬性，開發(fā)者可以通過改變這些屬性來滿足應(yīng)用的需求。perties文件是一個標(biāo)準(zhǔn)的Properties文件，該文件包含了系列的key-value對象，每個key就是一個Struts 2屬性，該key對應(yīng)的valu

2、e就是一個Struts 2屬性值。perties文件通常放在Web應(yīng)用的WEB-INF/classes路徑下。實際上，只要將該文件放在Web應(yīng)用的CLASSPATH路徑下，Struts 2框架就可以加載該文件。現(xiàn)在的問題是，perties文件的哪些key是有效的？即perties文件里包含哪些屬性是有效的Struts 2屬性。下面列出了可以在perties中定義的Struts 2屬性。    struts.configuration： 該屬性指定加載Struts 2配置文件的配置文件管

3、理器。該屬性的默認(rèn)值是org.apache.Struts2.config.DefaultConfiguration，這是 Struts 2默認(rèn)的配 置文件管理器。如果需要實現(xiàn)自己的配置管理器，開發(fā)者則可以實現(xiàn)一個實現(xiàn)Configuration接口的類，該類可以自己加載Struts 2配置文件。     struts.locale：指定Web應(yīng)用的默認(rèn)Locale。    struts.i18n.encoding：指定Web應(yīng)用的默認(rèn)編碼集。該屬性對于處理中文請求參數(shù)非常有用，對于獲取中文請求參數(shù)值，應(yīng)該將該屬性值設(shè)

4、置為GBK或者GB2312。  提示  當(dāng)設(shè)置該參數(shù)為GBK時，相當(dāng)于調(diào)用HttpServletRequest的setCharacterEncoding方法。 字串5    struts.objectFactory：指定Struts 2默認(rèn)的ObjectFactory Bean，該屬性默認(rèn)值是spring。    struts.objectFactory.spring.autoWire：指定Spring框架的自動裝配模式，該屬性的默認(rèn)值是name，即默認(rèn)根據(jù)Bean的name屬性自動裝

5、配。    struts.objectFactory.spring.useClassCache：該屬性指定整合Spring框架時，是否緩存Bean實例，該屬性只允許使用true和false兩個屬性值，它的默認(rèn)值是true。通常不建議修改該屬性值。    struts.objectTypeDeterminer：該屬性指定Struts 2的類型檢測機制，通常支持tiger和notiger兩個屬性值。    struts.multipart.parser： 該屬性指定處理multipart/form-data的

6、MIME類型（文件上傳）請求的框架，該屬性支持cos、pell和jakarta等屬性值，即 分別對應(yīng)使用cos的文件上傳框架、pell上傳及common-fileupload文件上傳框架。該屬性的默認(rèn)值為jakarta。  注意  如果需要使用cos或者pell的文件上傳方式，則應(yīng)該將對應(yīng)的JAR文件復(fù)制到Web應(yīng)用中。例如，使用cos上傳方式，則需要自己下載cos框架的JAR文件，并將該文件放在WEB-INF/lib路徑下。     struts.multipart.saveDir：該屬性指定上傳文件的臨時保存路徑，該屬性

7、的默認(rèn)值是javax.servlet.context.tempdir。     struts.multipart.maxSize：該屬性指定Struts 2文件上傳中整個請求內(nèi)容允許的最大字節(jié)數(shù)。字    perties：該屬性指定Struts 2應(yīng)用加載用戶自定義的屬性文件，該自定義屬性文件指定的屬性不會覆蓋perties文件中指定的屬性。如果需要加載多個自定義屬性文件，多個自定義屬性文件的文件名以英文逗號（,）隔開。字串2    

8、;struts.mapper.class： 指定將HTTP請求映射到指定Action的映射器，Struts 2提供了默認(rèn)的映射器：org.apache.struts2.dispatcher.mapper.DefaultActionMapper。默認(rèn)映射 器根據(jù)請求的前綴與Action的name屬性完成映射。 字串1   struts.action.extension：該屬性指定需要Struts 2處理的請求后綴，該屬性的默認(rèn)值是action，即所有匹配*.action的請求都由Struts 2處理。如果用戶需要指定多個請求后綴，則多個后綴之間以英文逗號（,）隔開。 

9、;  struts.serve.static：該屬性設(shè)置是否通過JAR文件提供靜態(tài)內(nèi)容服務(wù)，該屬性只支持true和false屬性值，該屬性的默認(rèn)屬性值是true。   struts.serve.static.browserCache：該屬性設(shè)置瀏覽器是否緩存靜態(tài)內(nèi)容。當(dāng)應(yīng)用處于開發(fā)階段時，我們希望每次請求都獲得服務(wù)器的最新響應(yīng)，則可設(shè)置該屬性為false。 字串9  struts.enable.DynamicMethodInvocation：該屬性設(shè)置Struts 2是否支持動態(tài)方法調(diào)用，該屬性的默認(rèn)值是true。如果需要關(guān)閉動態(tài)方法調(diào)用，則可

10、設(shè)置該屬性為false。   struts.enable.SlashesInActionNames：該屬性設(shè)置Struts 2是否允許在Action名中使用斜線，該屬性的默認(rèn)值是false。如果開發(fā)者希望允許在Action名中使用斜線，則可設(shè)置該屬性為true。  struts.tag.altSyntax：該屬性指定是否允許在Struts 2標(biāo)簽中使用表達(dá)式語法，因為通常都需要在標(biāo)簽中使用表達(dá)式語法，故此屬性應(yīng)該設(shè)置為true，該屬性的默認(rèn)值是true。   struts.devMode： 該屬性設(shè)置Struts 2應(yīng)用是否使用開發(fā)模

11、式。如果設(shè)置該屬性為true，則可以在應(yīng)用出錯時顯示更多、更友好的出錯提示。該屬性只接受true和flase兩個值，該屬性的 默認(rèn)值是false。通常，應(yīng)用在開發(fā)階段，將該屬性設(shè)置為true，當(dāng)進入產(chǎn)品發(fā)布階段后，則該屬性設(shè)置為false。   struts.i18n.reload：該屬性設(shè)置是否每次HTTP請求到達(dá)時，系統(tǒng)都重新加載資源文件。該屬性默認(rèn)值是false。在開發(fā)階段將該屬性設(shè)置為true會更有利于開發(fā)，但在產(chǎn)品發(fā)布階段應(yīng)將該屬性設(shè)置為false。 字串4 提示  開發(fā)階段將該屬性設(shè)置了true，將可以在每次請求時都重新加載國際化資源文件，從

12、而可以讓開發(fā)者看到實時開發(fā)效果；產(chǎn)品發(fā)布階段應(yīng)該將該屬性設(shè)置為false，是為了提供響應(yīng)性能，每次請求都需要重新加載資源文件會大大降低應(yīng)用的性能。  struts.ui.theme：該屬性指定視圖標(biāo)簽?zāi)J(rèn)的視圖主題，該屬性的默認(rèn)值是xhtml。  struts.ui.templateDir：該屬性指定視圖主題所需要模板文件的位置，該屬性的默認(rèn)值是template，即默認(rèn)加載template路徑下的模板文件。  struts.ui.templateSuffix：該屬性指定模板文件的后綴，該屬性的默認(rèn)屬性值是ftl。該屬性還允許使用ftl、vm或jsp，分別對應(yīng)Fre

13、eMarker、Velocity和JSP模板。  struts.configuration.xml.reload：該屬性設(shè)置當(dāng)struts.xml文件改變后，系統(tǒng)是否自動重新加載該文件。該屬性的默認(rèn)值是false。  struts.velocity.configfile：該屬性指定Velocity框架所需的perties文件的位置。該屬性的默認(rèn)值為perties。  struts.velocity.contexts：該屬性指定Velocity框架的Context位置，如果該框架有多個Context

14、，則多個Context之間以英文逗號（,）隔開。  struts.velocity.toolboxlocation：該屬性指定Velocity框架的toolbox的位置。  struts.url.http.port：該屬性指定Web應(yīng)用所在的監(jiān)聽端口。該屬性通常沒有太大的用戶，只是當(dāng)Struts 2需要生成URL時（例如Url標(biāo)簽），該屬性才提供Web應(yīng)用的默認(rèn)端口。  struts.url.https.port：該屬性類似于struts.url.http.port屬性的作用，區(qū)別是該屬性指定的是Web應(yīng)用的加密服務(wù)端口。  

15、; struts.url.includeParams：該屬性指定Struts 2生成URL時是否包含請求參數(shù)。該屬性接受none、get和all三個屬性值，分別對應(yīng)于不包含、僅包含GET類型請求參數(shù)和包含全部請求參數(shù)。  struts.custom.i18n.resources：該屬性指定Struts 2應(yīng)用所需要的國際化資源文件，如果有多份國際化資源文件，則多個資源文件的文件名以英文逗號（,）隔開。 struts.dispatcher.parametersWorkaround： 對于某些Java EE服務(wù)器，不支持HttpServlet Request

16、調(diào)用getParameterMap()方法，此時可以設(shè)置該屬性值為true來解決該問題。該屬性的默認(rèn)值是false。對于 WebLogic、Orion和OC4J服務(wù)器，通常應(yīng)該設(shè)置該屬性為true。  struts.freemarker.manager.classname：該屬性指定Struts 2使用的FreeMarker管理器。該屬性的默認(rèn)值org.apache.struts2.views.freemarker.FreemarkerManager，這是Struts 2內(nèi)建的FreeMarker管理器。 struts.freemarker.wrapper.alt

17、Map：該屬性只支持true和false兩個屬性值，默認(rèn)值是true。通常無需修改該屬性值。  struts.xslt.nocache：該屬性指定XSLT Result是否使用樣式表緩存。當(dāng)應(yīng)用處于開發(fā)階段時，該屬性通常被設(shè)置為true；當(dāng)應(yīng)用處于產(chǎn)品使用階段時，該屬性通常被設(shè)置為false。struts.configuration.files： 該屬性指定Struts 2框架默認(rèn)加載的配置文件，如果需要指定默認(rèn)加載多個配置文件，則多個配置文件的文件名之間以英文逗號（,）隔開。該屬性的默認(rèn)值為struts- default.xml,struts-plugin.xml,str

18、uts.xml，看到該屬性值，讀者應(yīng)該明白為什么Struts 2框架默認(rèn)加載struts.xml文件了。 Struts 2框架有兩個核心配置文件，其中struts.xml文件主要負(fù)責(zé)管理應(yīng)用中的Action映射，以及該Action包含的Result定義等。除此之 外，Struts 2框架還包含     perties文件，該文件定義了Struts 2框架的大量屬性，開發(fā)者可以通過改變這些屬性來滿足應(yīng)用的需求。perties文件是一個標(biāo)準(zhǔn)的Properties文件，該文件包含了系列的key-val

19、ue對象，每個key就是一個Struts 2屬性，該key對應(yīng)的value就是一個Struts 2屬性值。perties文件通常放在Web應(yīng)用的WEB-INF/classes路徑下。實際上，只要將該文件放在Web應(yīng)用的CLASSPATH路徑下，Struts 2框架就可以加載該文件。現(xiàn)在的問題是，perties文件的哪些key是有效的？即perties文件里包含哪些屬性是有效的Struts 2屬性。下面列出了可以在perties中定義的Struts 2屬性。    struts.conf

20、iguration： 該屬性指定加載Struts 2配置文件的配置文件管理器。該屬性的默認(rèn)值是org.apache.Struts2.config.DefaultConfiguration，這是 Struts 2默認(rèn)的配 置文件管理器。如果需要實現(xiàn)自己的配置管理器，開發(fā)者則可以實現(xiàn)一個實現(xiàn)Configuration接口的類，該類可以自己加載Struts 2配置文件。    struts.locale：指定Web應(yīng)用的默認(rèn)Locale。   struts.i18n.encoding：指定Web應(yīng)用的默認(rèn)編碼集。該屬性對于處理中文請求參數(shù)非常有用，對

21、于獲取中文請求參數(shù)值，應(yīng)該將該屬性值設(shè)置為GBK或者GB2312。  提示  當(dāng)設(shè)置該參數(shù)為GBK時，相當(dāng)于調(diào)用HttpServletRequest的setCharacterEncoding方法。 字串5    struts.objectFactory：指定Struts 2默認(rèn)的ObjectFactory Bean，該屬性默認(rèn)值是spring。   struts.objectFactory.spring.autoWire：指定Spring框架的自動裝配模式，該屬性的默認(rèn)值是name，即默認(rèn)根據(jù)Bean的n

22、ame屬性自動裝配。   struts.objectFactory.spring.useClassCache：該屬性指定整合Spring框架時，是否緩存Bean實例，該屬性只允許使用true和false兩個屬性值，它的默認(rèn)值是true。通常不建議修改該屬性值。   struts.objectTypeDeterminer：該屬性指定Struts 2的類型檢測機制，通常支持tiger和notiger兩個屬性值。   struts.multipart.parser： 該屬性指定處理multipart/form-data的MIME類型（文件上

23、傳）請求的框架，該屬性支持cos、pell和jakarta等屬性值，即 分別對應(yīng)使用cos的文件上傳框架、pell上傳及common-fileupload文件上傳框架。該屬性的默認(rèn)值為jakarta。  注意  如果需要使用cos或者pell的文件上傳方式，則應(yīng)該將對應(yīng)的JAR文件復(fù)制到Web應(yīng)用中。例如，使用cos上傳方式，則需要自己下載cos框架的JAR文件，并將該文件放在WEB-INF/lib路徑下。    struts.multipart.saveDir：該屬性指定上傳文件的臨時保存路徑，該屬性的默認(rèn)值是javax.servlet.co

24、ntext.tempdir。    struts.multipart.maxSize：該屬性指定Struts 2文件上傳中整個請求內(nèi)容允許的最大字節(jié)數(shù)。     perties：該屬性指定Struts 2應(yīng)用加載用戶自定義的屬性文件，該自定義屬性文件指定的屬性不會覆蓋perties文件中指定的屬性。如果需要加載多個自定義屬性文件，多個自定義屬性文件的文件名以英文逗號（,）隔開。字串2   struts.mapper.class： 指定將HTTP請求映射到指定Action的

25、映射器，Struts 2提供了默認(rèn)的映射器：org.apache.struts2.dispatcher.mapper.DefaultActionMapper。默認(rèn)映射 器根據(jù)請求的前綴與Action的name屬性完成映射。 字串1   struts.action.extension：該屬性指定需要Struts 2處理的請求后綴，該屬性的默認(rèn)值是action，即所有匹配*.action的請求都由Struts 2處理。如果用戶需要指定多個請求后綴，則多個后綴之間以英文逗號（,）隔開。  struts.serve.static：該屬性設(shè)置是否通過JAR文件提供

26、靜態(tài)內(nèi)容服務(wù)，該屬性只支持true和false屬性值，該屬性的默認(rèn)屬性值是true。  struts.serve.static.browserCache：該屬性設(shè)置瀏覽器是否緩存靜態(tài)內(nèi)容。當(dāng)應(yīng)用處于開發(fā)階段時，我們希望每次請求都獲得服務(wù)器的最新響應(yīng)，則可設(shè)置該屬性為false。 字串9  struts.enable.DynamicMethodInvocation：該屬性設(shè)置Struts 2是否支持動態(tài)方法調(diào)用，該屬性的默認(rèn)值是true。如果需要關(guān)閉動態(tài)方法調(diào)用，則可設(shè)置該屬性為false。  struts.enable.SlashesInActionNa

27、mes：該屬性設(shè)置Struts 2是否允許在Action名中使用斜線，該屬性的默認(rèn)值是false。如果開發(fā)者希望允許在Action名中使用斜線，則可設(shè)置該屬性為true。  struts.tag.altSyntax：該屬性指定是否允許在Struts 2標(biāo)簽中使用表達(dá)式語法，因為通常都需要在標(biāo)簽中使用表達(dá)式語法，故此屬性應(yīng)該設(shè)置為true，該屬性的默認(rèn)值是true。  struts.devMode： 該屬性設(shè)置Struts 2應(yīng)用是否使用開發(fā)模式。如果設(shè)置該屬性為true，則可以在應(yīng)用出錯時顯示更多、更友好的出錯提示。該屬性只接受true和flase兩個值，該屬性的 默認(rèn)值是

28、false。通常，應(yīng)用在開發(fā)階段，將該屬性設(shè)置為true，當(dāng)進入產(chǎn)品發(fā)布階段后，則該屬性設(shè)置為false。  struts.i18n.reload：該屬性設(shè)置是否每次HTTP請求到達(dá)時，系統(tǒng)都重新加載資源文件。該屬性默認(rèn)值是false。在開發(fā)階段將該屬性設(shè)置為true會更有利于開發(fā)，但在產(chǎn)品發(fā)布階段應(yīng)將該屬性設(shè)置為false。 字串4 提示  開發(fā)階段將該屬性設(shè)置了true，將可以在每次請求時都重新加載國際化資源文件，從而可以讓開發(fā)者看到實時開發(fā)效果；產(chǎn)品發(fā)布階段應(yīng)該將該屬性設(shè)置為false，是為了提供響應(yīng)性能，每次請求都需要重新加載資源文件會大大降低應(yīng)用的性能。

29、  struts.ui.theme：該屬性指定視圖標(biāo)簽?zāi)J(rèn)的視圖主題，該屬性的默認(rèn)值是xhtml。  struts.ui.templateDir：該屬性指定視圖主題所需要模板文件的位置，該屬性的默認(rèn)值是template，即默認(rèn)加載template路徑下的模板文件。  struts.ui.templateSuffix：該屬性指定模板文件的后綴，該屬性的默認(rèn)屬性值是ftl。該屬性還允許使用ftl、vm或jsp，分別對應(yīng)FreeMarker、Velocity和JSP模板。  struts.configuration.xml.reload：該屬性設(shè)置當(dāng)strut

30、s.xml文件改變后，系統(tǒng)是否自動重新加載該文件。該屬性的默認(rèn)值是false。  struts.velocity.configfile：該屬性指定Velocity框架所需的perties文件的位置。該屬性的默認(rèn)值為perties。  struts.velocity.contexts：該屬性指定Velocity框架的Context位置，如果該框架有多個Context，則多個Context之間以英文逗號（,）隔開。  struts.velocity.toolboxlocation：該屬性指定Velocity框架的toolbox的位置。  struts.url.http.port：該屬性指定Web應(yīng)用所在的監(jiān)聽端口。該屬性通常沒有太大的用戶，只是當(dāng)Struts 2需要生成URL時（例如Url標(biāo)簽），該屬性才提供Web應(yīng)用的默認(rèn)端口。  struts.url.https.port：該屬