struts2屬性配置文件詳解

struts.properties文件,該文件定義了Struts 2框架的大量屬性,開發者可以通過改變這些屬性來滿足應用的需求.

struts.properties配置文件
struts.properties文件是一個標準的Properties文件,該文件包含了系列的key-value對象,每個key就是一個Struts 2屬性,該key對應的value就是一個Struts 2屬性值.

struts.properties文件通常放在Web應用的WEB-INF/classes路徑下. 實際上, 只要將該文件放在Web應用的CLASSPATH路徑下, Struts 2框架就可以加載該文件.

struts.properties配置文件提供了一種改變框架默認行爲的機制. 一般來講我們沒必要修改這個文件，除非你想擁有一個更加友好的開發調試環境。struts.properties文件中所包含的所有屬性都可以在web.xml配置文件中使用"init-param"標籤進行配置，或者在struts.xml文件中使用“constant”標籤進行配置.

可以被修改的屬性允許改變Freemarker選項－－改變“action-mapping”類、決定是否允許XML配置文件重載及確定默認用戶接口主題等行爲。

一個名爲“default.properties”的屬性文件包含在“Struts2-Core”JAR文件中。你可以在你項目源文件路徑的根目錄下創建一個名爲“struts.properties”的文件，來對某個屬性進行修改。這樣你就可以增加你想要修改的屬性。新的屬性值將會覆蓋默認值。


以下爲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應用的加密服務端口.

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文件了