Struts2基本配置

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中以<constant name="" value=""></constant>加載。

下面將該文件的配置參數詳細列舉出來，方便你們查看；

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