struts.
properties文件,該文件定義了Struts 2框架的大量屬性,開發(fā)者可以通過改變這些屬性來滿足應(yīng)用的需求.
struts.properties配置文件
struts.
properties文件是一個(gè)標(biāo)準(zhǔn)的
Properties文件,該文件包含了系列的key-value對(duì)象,每個(gè)key就是一個(gè)Struts 2屬性,該key對(duì)應(yīng)的value就是一個(gè)Struts 2屬性值.
struts.
properties文件通常放在Web應(yīng)用的WEB-INF/classes路徑下. 實(shí)際上, 只要將該文件放在Web應(yīng)用的CLASSPATH路徑下, Struts 2框架就可以加載該文件.
struts.
properties配置文件提供了一種改變框架默認(rèn)行為的機(jī)制. 一般來講我們沒必要修改這個(gè)文件，除非你想擁有一個(gè)更加友好的開發(fā)調(diào)試環(huán)境。struts.
properties文件中所包含的所有屬性都可以在web.xml配置文件中使用"init-param"標(biāo)簽進(jìn)行配置，或者在struts.xml文件中使用“constant”標(biāo)簽進(jìn)行配置.
可以被修改的屬性允許改變Freemarker選項(xiàng)－－改變“action-mapping”類、決定是否允許XML配置文件重載及確定默認(rèn)用戶接口主題等行為。
一個(gè)名為“default.
properties”的屬性文件包含在“
Struts2-Core”JAR文件中。你可以在你項(xiàng)目源文件路徑的根目錄下創(chuàng)建一個(gè)名為“struts.
properties”的文件，來對(duì)某個(gè)屬性進(jìn)行修改。這樣你就可以增加你想要修改的屬性。新的屬性值將會(huì)覆蓋默認(rèn)值。
以下為struts.properties中定義的Struts 2屬性:
struts.configuration
該屬性指定加載Struts 2配置文件的配置文件管理器.該屬性的默認(rèn)值是org.apache.
Struts2.config.DefaultConfiguration, 這是Struts 2默認(rèn)的配置文件管理器.如果需要實(shí)現(xiàn)自己的配置管理器,開發(fā)者則可以實(shí)現(xiàn)一個(gè)實(shí)現(xiàn)Configuration接口的類,該類可以自己加載Struts 2配置文件.
struts.locale
指定Web應(yīng)用的默認(rèn)Locale.
struts.i18n.encoding
指定Web應(yīng)用的默認(rèn)編碼集.該屬性對(duì)于處理中文請(qǐng)求參數(shù)非常有用,對(duì)于獲取中文請(qǐng)求參數(shù)值,應(yīng)該將該屬性值設(shè)置為GBK或者GB2312;
提示:當(dāng)設(shè)置該參數(shù)為GBK時(shí),相當(dāng)于調(diào)用HttpServletRequest的setCharacterEncoding方法.
struts.objectFactory
指定Struts 2默認(rèn)的ObjectFactory Bean,該屬性默認(rèn)值是spring.
struts.objectFactory.spring.autoWire
指定Spring框架的自動(dòng)裝配模式, 該屬性的默認(rèn)值是name, 即默認(rèn)根據(jù)Bean的name屬性自動(dòng)裝配.
struts.objectFactory.spring.useClassCache
該屬性指定整合Spring框架時(shí),是否緩存Bean實(shí)例,該屬性只允許使用true和false兩個(gè)屬性值,它的默認(rèn)值是true.通常不建議修改該屬性值.
struts.objectTypeDeterminer
該屬性指定Struts 2的類型檢測(cè)機(jī)制, 通常支持tiger和notiger兩個(gè)屬性值.
struts.multipart.parser
該屬性指定處理multipart/form-data的MIME類型(文件上傳)請(qǐng)求的框架,該屬性支持cos,pell和jakarta等屬 性值,
即分別對(duì)應(yīng)使用cos的文件上傳框架,pell上傳及common-fileupload文件上傳框架.該屬性的默認(rèn)值為jakarta.
注意:如果需要使用cos或者pell的文件上傳方式,則應(yīng)該將對(duì)應(yīng)的JAR文件復(fù)制到Web應(yīng)用中.例如,使用cos上傳方式,則需要自己下載cos框架的JAR文件,并將該文件放在WEB-INF/lib路徑下.
struts.multipart.saveDir
該屬性指定上傳文件的臨時(shí)保存路徑,該屬性的默認(rèn)值是javax.servlet.context.tempdir.
struts.multipart.maxSize
該屬性指定Struts 2文件上傳中整個(gè)請(qǐng)求內(nèi)容允許的最大字節(jié)數(shù).
struts.custom.properties
該屬性指定Struts 2應(yīng)用加載用戶自定義的屬性文件,該自定義屬性文件指定的屬性不會(huì)覆蓋struts.
properties文件中指定的屬性.如果需要加載多個(gè)自定義屬性文件,多個(gè)自定義屬性文件的文件名以英文逗號(hào)(,)隔開.
struts.mapper.class
指定將HTTP請(qǐng)求映射到指定Action的映射器,Struts 2提供了默認(rèn)的映射器: org.apache.
struts2.dispatcher.mapper.DefaultActionMapper.默認(rèn)映射器根據(jù)請(qǐng)求的前綴與Action的name屬性完成映射.
struts.action.extension
該屬性指定需要Struts 2處理的請(qǐng)求后綴,該屬性的默認(rèn)值是action,即所有匹配*.action的請(qǐng)求都由Struts 2處理.如果用戶需要指定多個(gè)請(qǐng)求后綴,則多個(gè)后綴之間以英文逗號(hào)(,)隔開.
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ā)階段時(shí),我們希望每次請(qǐng)求都獲得服務(wù)器的最新響應(yīng),則可設(shè)置該屬性為false.
struts.enable.DynamicMethodInvocation
該屬性設(shè)置Struts 2是否支持動(dòng)態(tài)方法調(diào)用,該屬性的默認(rèn)值是true.如果需要關(guān)閉動(dòng)態(tài)方法調(diào)用,則可設(shè)置該屬性為false.
struts.enable.SlashesInActionNames
該屬性設(shè)置Struts 2是否允許在Action名中使用斜線,該屬性的默認(rèn)值是false.如果開發(fā)者希望允許在Action名中使用斜線,則可設(shè)置該屬性為true.
struts.tag.altSyntax
該屬性指定是否允許在Struts 2標(biāo)簽中使用表達(dá)式語(yǔ)法,因?yàn)橥ǔ６夹枰跇?biāo)簽中使用表達(dá)式語(yǔ)法,故此屬性應(yīng)該設(shè)置為true,該屬性的默認(rèn)值是true.
struts.devMode
該屬性設(shè)置Struts
2應(yīng)用是否使用開發(fā)模式.如果設(shè)置該屬性為true,則可以在應(yīng)用出錯(cuò)時(shí)顯示更多、更友好的出錯(cuò)提示.該屬性只接受true和flase兩個(gè)值,該屬性的
默認(rèn)值是false.通常,應(yīng)用在開發(fā)階段,將該屬性設(shè)置為true,當(dāng)進(jìn)入產(chǎn)品發(fā)布階段后,則該屬性設(shè)置為false.
struts.i18n.reload
該屬性設(shè)置是否每次HTTP請(qǐng)求到達(dá)時(shí),系統(tǒng)都重新加載資源文件(允許國(guó)際化文件重載).該屬性默認(rèn)值是false.在開發(fā)階段將該屬性設(shè)置為true會(huì)更有利于開發(fā),但在產(chǎn)品發(fā)布階段應(yīng)將該屬性設(shè)置為false.
提示:開發(fā)階段將該屬性設(shè)置了true,將可以在每次請(qǐng)求時(shí)都重新加載國(guó)際化資源文件,從而可以讓開發(fā)者看到實(shí)時(shí)開發(fā)效果;產(chǎn)品發(fā)布階段應(yīng)該將該屬性設(shè)置為false,是為了提供響應(yīng)性能,每次請(qǐng)求都需要重新加載資源文件會(huì)大大降低應(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,分別對(duì)應(yīng)FreeMarker、Velocity和JSP模板.
struts.configuration.xml.reload
該屬性設(shè)置當(dāng)struts.xml文件改變后,系統(tǒng)是否自動(dòng)重新加載該文件.該屬性的默認(rèn)值是false.
struts.velocity.configfile
該屬性指定Velocity框架所需的velocity.
properties文件的位置.該屬性的默認(rèn)值為velocity.
properties.
struts.velocity.contexts
該屬性指定Velocity框架的Context位置,如果該框架有多個(gè)Context,則多個(gè)Context之間以英文逗號(hào)(,)隔開.
struts.velocity.toolboxlocation
該屬性指定Velocity框架的toolbox的位置.
struts.url.http.port
該屬性指定Web應(yīng)用所在的監(jiān)聽端口.該屬性通常沒有太大的用戶,只是當(dāng)Struts 2需要生成URL時(shí)(例如Url標(biāo)簽),該屬性才提供Web應(yīng)用的默認(rèn)端口.
struts.url.https.port
該屬性類似于struts.url.http.port屬性的作用,區(qū)別是該屬性指定的是Web應(yīng)用的加密服務(wù)端口.
struts.url.includeParams
該屬性指定Struts 2生成URL時(shí)是否包含請(qǐng)求參數(shù).該屬性接受none、get和all三個(gè)屬性值,分別對(duì)應(yīng)于不包含、僅包含GET類型請(qǐng)求參數(shù)和包含全部請(qǐng)求參數(shù).
struts.custom.i18n.resources
該屬性指定Struts 2應(yīng)用所需要的國(guó)際化資源文件,如果有多份國(guó)際化資源文件,則多個(gè)資源文件的文件名以英文逗號(hào)(,)隔開.
struts.diSPAtcher.parametersWorkaround
對(duì)于某些Java EE服務(wù)器,不支持HttpServlet
Request調(diào)用getParameterMap()方法,此時(shí)可以設(shè)置該屬性值為true來解決該問題.該屬性的默認(rèn)值是false.對(duì)于
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.altMap
該屬性只支持true和false兩個(gè)屬性值,默認(rèn)值是true.通常無需修改該屬性值.
struts.xslt.nocache
該屬性指定XSLT Result是否使用樣式表緩存.當(dāng)應(yīng)用處于開發(fā)階段時(shí),該屬性通常被設(shè)置為true;當(dāng)應(yīng)用處于產(chǎn)品使用階段時(shí),該屬性通常被設(shè)置為false.
struts.configuration.files
該屬性指定Struts
2框架默認(rèn)加載的配置文件,如果需要指定默認(rèn)加載多個(gè)配置文件,則多個(gè)配置文件的文件名之間以英文逗號(hào)(,)隔開.該屬性的默認(rèn)值為struts-
default.xml,struts-plugin.xml,struts.xml,看到該屬性值,所以應(yīng)該明白為什么Struts
2框架默認(rèn)加載struts.xml文件了.