struts2中的constant配置詳解

[html] view plain copy

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
 "http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
       <!--指定Web應用的默認編碼集.該屬性對於處理中文請求參數非常有用,對於獲取中文請求參數值,應該將該屬性值設置爲GBK或者GB2312;
           提示:當設置該參數爲GBK時,相當於調用HttpServletRequest的setCharacterEncoding方法. >
 <constant name="struts.i18n.encoding" value="UTF-8" />

       <!--指定Struts 2默認的ObjectFactory Bean,該屬性默認值是spring. >
 <constant name="struts.objectFactory" value="spring" />

       <!--指定Spring框架的自動裝配模式, 該屬性的默認值是name, 即默認根據Bean的name屬性自動裝配. >
 <constant name="struts.objectFactory.spring.autoWire" value="name" />

       <!--該屬性指定整合Spring框架時,是否緩存Bean實例,該屬性只允許使用true和false兩個屬性值,它的默認值是true.通常不建議修改該屬性值. >
 <constant name="struts.objectFactory.spring.useClassCache" value="true" />

       <!--該屬性指定處理multipart/form-data的MIME類型(文件上傳)請求的框架,該屬性支持cos,pell和jakarta等屬性值, 即分別對應使用cos的文件上傳框架,pell上傳及common-fileupload文件上傳框架.該屬性的默認值爲jakarta.
           注意:如果需要使用cos或者pell的文件上傳方式,則應該將對應的JAR文件複製到Web應用中.例如,使用cos上傳方式,則需要自己下載cos框架的JAR文件,並將該文件放在WEB-INF/lib路徑下. >
 <constant name="struts.multipart.parser" value="jakarta" />

       <!--該屬性指定上傳文件的臨時保存路徑,該屬性的默認值是javax.servlet.context.tempdir. >
 <constant name="struts.multipart.saveDir" value="" />

       <!--該屬性指定Struts 2文件上傳中整個請求內容允許的最大字節數. >
 <constant name="struts.multipart.maxSize" value="1000000000000" />

       <!--該屬性指定需要Struts 2處理的請求後綴,該屬性的默認值是action,即所有匹配*.action的請求都由Struts 2處理.如果用戶需要指定多個請求後綴,則多個後綴之間以英文逗號(,)隔開. >
 <constant name="struts.action.extension" value="do" />

       <!--該屬性設置是否通過JAR文件提供靜態內容服務,該屬性只支持true和false屬性值,該屬性的默認屬性值是true. >
 <constant name="struts.serve.static" value="true" />

       <!--該屬性設置瀏覽器是否緩存靜態內容.當應用處於開發階段時,我們希望每次請求都獲得服務器的最新響應,則可設置該屬性爲false. >
 <constant name="struts.serve.static.browserCache" value="true" />

       <!--該屬性設置Struts 2應用是否使用開發模式.如果設置該屬性爲true,則可以在應用出錯時顯示更多、更友好的出錯提示.該屬性只接受true和flase兩個值,該屬性的默認值是false.通常,應用在開發階段,將該屬性設置爲true,當進入產品發佈階段後,則該屬性設置爲false. >
 <constant name="struts.devMode" value="false" />

       <!--該屬性設置是否每次HTTP請求到達時,系統都重新加載資源文件(允許國際化文件重載).該屬性默認值是false.在開發階段將該屬性設置爲true會更有利於開發,但在產品發佈階段應將該屬性設置爲false.
           提示:開發階段將該屬性設置了true,將可以在每次請求時都重新加載國際化資源文件,從而可以讓開發者看到實時開發效果;產品發佈階段應該將該屬性設置爲false,是爲了提供響應性能,每次請求都需要重新加載資源文件會大大降低應用的性能. >
 <constant name="struts.i18n.reload" value="false" />

       <!--該屬性指定視圖標籤默認的視圖主題,該屬性的默認值是xhtml. >
 <constant name="struts.ui.theme" value="simple" />

       <!--該屬性指定模板文件的後綴,該屬性的默認屬性值是ftl.該屬性還允許使用ftl、vm或jsp,分別對應FreeMarker、Velocity和JSP模板. >
 <constant name="struts.ui.templateSuffix" value="ftl" />

       <!--該屬性設置當struts.xml文件改變後,系統是否自動重新加載該文件.該屬性的默認值是false. >
 <constant name="struts.configuration.xml.reload" value="false" />

       <!--該屬性指定Struts 2應用所需要的國際化資源文件,如果有多份國際化資源文件,則多個資源文件的文件名以英文逗號(,)隔開. >
 <constant name="struts.custom.i18n.resources" value="nationz" />

       <!--對於某些Java EE服務器,不支持HttpServlet Request調用getParameterMap()方法,此時可以設置該屬性值爲true來解決該問題.該屬性的默認值是false.對於WebLogic、Orion和OC4J服務器,通常應該設置該屬性爲true. >
 <constant name="struts.dispatcher.parametersWorkaround" value="false" />

       <!--指定是否緩存FreeMarker模版。默認值false。>
 <constant name="struts.freemarker.templatesCache" value="true" />

       <!--該屬性只支持true和false兩個屬性值,默認值是true.通常無需修改該屬性值. >
 <constant name="struts.freemarker.wrapper.altMap" value="true" />

       <!--該屬性指定XSLT Result是否使用樣式表緩存.當應用處於開發階段時,該屬性通常被設置爲true;當應用處於產品使用階段時,該屬性通常被設置爲false. >
 <constant name="struts.xslt.nocache" value="false" />

       <!--該屬性指定Struts 2框架默認加載的配置文件,如果需要指定默認加載多個配置文件,則多個配置文件的文件名之間以英文逗號(,)隔開.該屬性的默認值爲struts-default.xml,struts-plugin.xml,struts.xml,看到該屬性值,所以應該明白爲什麼Struts 2框架默認加載struts.xml文件了. >
 <constant name="struts.configuration.files" value="struts-default.xml,struts-plugin.xml" />

       <!--設置映射器是否總是選擇完整的名稱空間。該屬性的默認值時false。>
 <constant name="struts.mapper.alwaysSelectFullNamespace" value="false" />

       <!--設置Convention插件定位視圖資源的根路徑。默認值爲/WEB-INF/content>
 <constant name="struts.convention.result.path" value="/WEB-INF/content/" />

       <!--Convention插件以該常量指定包作爲根包>
 <constant name="struts.convention.action.package" value="default" />

       <!--是否從包中搜索Action>
 <constant name="struts.convention.action.disableScanning" value="false"/>

       <!-- 官方只說明在jboss下需要設置，情況不明 -->
 <constant name="struts.convention.exclude.parentClassLoader" value="true" />
 <constant name="struts.convention.action.fileProtocols" value="jar,zip" />

       <!--包括哪些jar包中的action。逗號分割字符串。>
 <constant name="struts.convention.action.includeJars" value=".*?/_wl_cls_gen.*?jar(!/)?" />

       <!--確定搜索包的路徑。只要是結尾爲action的包都要搜索。>
 <constant name="struts.convention.package.locators" value="action" />

</struts>