1. 程式人生 > >struts2_0中struts_properties檔案詳解

struts2_0中struts_properties檔案詳解

Struts 2框架有兩個核心配置檔案:

struts.xml和struts.properties

其中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檔案的內容均可在struts.xml中以載入。 下面將該檔案的配置引數詳細列舉出來,方便大家檢視;

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.autoWrite      指定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檔案了。