struts2 properties配置詳解

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

[b][size=large]struts.properties配置檔案[/size][/b]

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”的檔案，來對某個屬性進行修改。這樣你就可以增加你想要修改的屬性。新的屬性值将會覆寫預設值。

[size=x-large][b]以下為struts.properties中定義的Struts 2屬性:[/b][/size]

[size=medium][color=darkred][b]struts.configuration[/b][/color][/size]

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

[size=medium][color=darkred][b]struts.locale[/b][/color][/size]

指定Web應用的預設Locale.

[size=medium][color=darkred][b]struts.i18n.encoding[/b][/color][/size]

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

[b]提示:[/b]當設定該參數為GBK時,相當于調用HttpServletRequest的setCharacterEncoding方法.

[size=medium][color=darkred][b]struts.objectFactory[/b][/color][/size]

指定Struts 2預設的ObjectFactory Bean,該屬性預設值是spring.

[size=medium][color=darkred][b]struts.objectFactory.spring.autoWire[/b][/color][/size]

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

[size=medium][color=darkred][b]struts.objectFactory.spring.useClassCache[/b][/color][/size]

該屬性指定整合Spring架構時,是否緩存Bean執行個體,該屬性隻允許使用true和false兩個屬性值,它的預設值是true.通常不建議修改該屬性值.

[size=medium][color=darkred][b]struts.objectTypeDeterminer[/b][/color][/size]

該屬性指定Struts 2的類型檢測機制, 通常支援tiger和notiger兩個屬性值.

[size=medium][color=darkred][b]struts.multipart.parser[/b][/color][/size]

該屬性指定處理multipart/form-data的MIME類型(檔案上傳)請求的架構,該屬性支援cos,pell和jakarta等屬性值, 即分别對應使用cos的檔案上傳架構,pell上傳及common-fileupload檔案上傳架構.該屬性的預設值為jakarta.

[b]注意:[/b]如果需要使用cos或者pell的檔案上傳方式,則應該将對應的JAR檔案複制到Web應用中.例如,使用cos上傳方式,則需要自己下載下傳cos架構的JAR檔案,并将該檔案放在WEB-INF/lib路徑下.

[size=medium][color=darkred][b]struts.multipart.saveDir[/b][/color][/size]

該屬性指定上傳檔案的臨時儲存路徑,該屬性的預設值是javax.servlet.context.tempdir.

[size=medium][color=darkred][b]struts.multipart.maxSize[/b][/color][/size]

該屬性指定Struts 2檔案上傳中整個請求内容允許的最大位元組數.

[size=medium][color=darkred][b]struts.custom.properties[/b][/color][/size]

該屬性指定Struts 2應用加載使用者自定義的屬性檔案,該自定義屬性檔案指定的屬性不會覆寫struts.properties檔案中指定的屬性.如果需要加載多個自定義屬性檔案,多個自定義屬性檔案的檔案名以英文逗号(,)隔開.

[size=medium][color=darkred][b]struts.mapper.class[/b][/color][/size]

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

[size=medium][color=darkred][b]struts.action.extension[/b][/color][/size]

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

[size=medium][color=darkred][b]struts.serve.static[/b][/color][/size]

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

[size=medium][color=darkred][b]struts.serve.static.browserCache[/b][/color][/size]

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

[size=medium][color=darkred][b]struts.enable.DynamicMethodInvocation[/b][/color][/size]

該屬性設定Struts 2是否支援動态方法調用,該屬性的預設值是true.如果需要關閉動态方法調用,則可設定該屬性為false.

[size=medium][color=darkred][b]struts.enable.SlashesInActionNames[/b][/color][/size]

該屬性設定Struts 2是否允許在Action名中使用斜線,該屬性的預設值是false.如果開發者希望允許在Action名中使用斜線,則可設定該屬性為true.

[size=medium][color=darkred][b]struts.tag.altSyntax[/b][/color][/size]

該屬性指定是否允許在Struts 2标簽中使用表達式文法,因為通常都需要在标簽中使用表達式文法,故此屬性應該設定為true,該屬性的預設值是true.

[size=medium][color=darkred][b]struts.devMode[/b][/color][/size]

該屬性設定Struts 2應用是否使用開發模式.如果設定該屬性為true,則可以在應用出錯時顯示更多、更友好的出錯提示.該屬性隻接受true和flase兩個值,該屬性的預設值是false.通常,應用在開發階段,将該屬性設定為true,當進入産品釋出階段後,則該屬性設定為false.

[size=medium][color=darkred][b]struts.i18n.reload[/b][/color][/size]

該屬性設定是否每次HTTP請求到達時,系統都重新加載資源檔案(允許國際化檔案重載).該屬性預設值是false.在開發階段将該屬性設定為true會更有利于開發,但在産品釋出階段應将該屬性設定為false.

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

[size=medium][color=darkred][b]struts.ui.theme[/b][/color][/size]

該屬性指定視圖示簽預設的視圖主題,該屬性的預設值是xhtml.

[size=medium][color=darkred][b]struts.ui.templateDir[/b][/color][/size]

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

[size=medium][color=darkred][b]struts.ui.templateSuffix[/b][/color][/size]

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

[size=medium][color=darkred][b]struts.configuration.xml.reload[/b][/color][/size]

該屬性設定當struts.xml檔案改變後,系統是否自動重新加載該檔案.該屬性的預設值是false.

[size=medium][color=darkred][b]struts.velocity.configfile[/b][/color][/size]

該屬性指定Velocity架構所需的velocity.properties檔案的位置.該屬性的預設值為velocity.properties.

[size=medium][color=darkred][b]struts.velocity.contexts[/b][/color][/size]

該屬性指定Velocity架構的Context位置,如果該架構有多個Context,則多個Context之間以英文逗号(,)隔開.

[size=medium][color=darkred][b]struts.velocity.toolboxlocation[/b][/color][/size]

該屬性指定Velocity架構的toolbox的位置.

[size=medium][color=darkred][b]struts.url.http.port[/b][/color][/size]

該屬性指定Web應用所在的監聽端口.該屬性通常沒有太大的使用者,隻是當Struts 2需要生成URL時(例如Url标簽),該屬性才提供Web應用的預設端口.

[size=medium][color=darkred][b]struts.url.https.port[/b][/color][/size]

該屬性類似于struts.url.http.port屬性的作用,差別是該屬性指定的是Web應用的加密服務端口.

[size=medium][color=darkred][b]struts.url.includeParams[/b][/color][/size]

該屬性指定Struts 2生成URL時是否包含請求參數.該屬性接受none、get和all三個屬性值,分别對應于不包含、僅包含GET類型請求參數和包含全部請求參數.

[size=medium][color=darkred][b]struts.custom.i18n.resources[/b][/color][/size]

該屬性指定Struts 2應用所需要的國際化資源檔案,如果有多份國際化資源檔案,則多個資源檔案的檔案名以英文逗号(,)隔開.

[size=medium][color=darkred][b]struts.diSPAtcher.parametersWorkaround[/b][/color][/size]

對于某些Java EE伺服器,不支援HttpServlet Request調用getParameterMap()方法,此時可以設定該屬性值為true來解決該問題.該屬性的預設值是false.對于WebLogic、Orion和OC4J伺服器,通常應該設定該屬性為true.

[size=medium][color=darkred][b]struts.freemarker.manager.classname[/b][/color][/size]

該屬性指定Struts 2使用的FreeMarker管理器.該屬性的預設值是org.apache.struts2.views.freemarker.FreemarkerManager,這是Struts 2内建的FreeMarker管理器.

[size=medium][color=darkred][b]struts.freemarker.wrapper.altMap[/b][/color][/size]

該屬性隻支援true和false兩個屬性值,預設值是true.通常無需修改該屬性值.

[size=medium][color=darkred][b]struts.xslt.nocache[/b][/color][/size]

該屬性指定XSLT Result是否使用樣式表緩存.當應用處于開發階段時,該屬性通常被設定為true;當應用處于産品使用階段時,該屬性通常被設定為false.

[size=medium][color=darkred][b]struts.configuration.files[/b][/color][/size]

該屬性指定Struts 2架構預設加載的配置檔案,如果需要指定預設加載多個配置檔案,則多個配置檔案的檔案名之間以英文逗号(,)隔開.該屬性的預設值為struts-default.xml,struts-plugin.xml,struts.xml,看到該屬性值,是以應該明白為什麼Struts 2架構預設加載struts.xml檔案了.

[quote]http://easymorse.com/bbs/viewthread.php?tid=124&page=1&extra=page%3D1[/quote]