1. 程式人生 > >struts2.0 配置檔案、常量配置詳解

struts2.0 配置檔案、常量配置詳解

通常struts2載入struts2常量的順序如下:

  1. struts-default.xml:該檔案儲存在struts2-core-2.0.6.jar檔案中。
  2. struts-plugin.xml:該檔案儲存在struts2-Xxx-2.0.6.jar等Struts2外掛JAR檔案中。
  3. struts.xml:該檔案是Web應用預設的Struts2配置檔案。使用<constant>元素配置常量
  4. struts.properties:該檔案是Web應用預設的Struts2配置檔案。
  5. web.xml:該檔案是Web應用的配置檔案。 如果在多個檔案中配置了同一個Struts2常量,則後一個檔案中的配置的常量值會覆蓋前面檔案中配置的常量值。 
    在不同檔案中配置常量的方式是不一樣的,但不管哪個檔案中,配置Struts2常量都要指定兩個屬性:常量name和常量value。通過<init-param>元素配置常量

推薦在struts.xml檔案中配置Struts2常量。

此處只加載了前三個配置檔案,這是在常量struts.configuration.files中配置的。該屬性指定Struts 2框架預設載入的配置檔案,如果需要指定預設載入多個配置檔案,則多個配置檔案的檔名之間以英文逗號(,)隔開。該屬性的預設值為struts- default.xml,struts-plugin.xml,struts.xml,這就是上圖中載入的三個配置檔案。

 

Struts2常量的具體用法例項

Xml程式碼 

<struts>  
    <!-- 指定Web應用的預設編碼集,相當於呼叫HttpServletRequest的setCharacterEncoding方法 --> 
    <constant name="struts.i18n.encoding" value="UTF-8" />  

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

    <!-- 設定瀏覽器是否快取靜態內容,預設值為true(生產環境下使用),開發階段最好關閉 --> 
    <constant name="struts.serve.static.browserCache" value="false" />  

    <!-- 當struts的配置檔案修改後,系統是否自動重新載入該檔案,預設值為false(生產環境下使用),開發階段最好開啟 --> 
    <constant name="struts.configuration.xml.reload" value="true" />  

    <!-- 開發模式下使用,這樣可以打印出更詳細的錯誤資訊 --> 
    <constant name="struts.devMode" value="true" />  

    <!-- 預設的檢視主題 --> 
    <constant name="struts.ui.theme" value="simple" />  

    <!-- spring 託管 --> 
    <constant name="struts.objectFactory" value="spring" />  

    <!--   
        指定載入struts2配置檔案管理器,預設為org.apache.struts2.config.DefaultConfiguration   
        開發者可以自定義配置檔案管理器,該類要實現Configuration介面,可以自動載入struts2配置檔案。   
    --> 
    <constant name="struts.configuration"  
        value="org.apache.struts2.config.DefaultConfiguration" />  

    <!-- 設定預設的locale和字元編碼 --> 
    <constant name="struts.locale" value="zh_CN" />  
    <constant name="struts.i18n.encoding" value="GBK" />  

    <!-- 指定Struts的工廠類 --> 
    <constant name="struts.objectFactory" value="spring"></constant>  

    <!--   
        指定spring框架的裝配模式,裝配方式有: name, type, auto, and constructor (name   
        是預設裝配模式)   
    --> 
    <constant name="struts.objectFactory.spring.autoWire" value="name" />  

    <!-- 該屬性指定整合spring時,是否對bean進行快取,值為true or false,預設為true --> 
    <cosntant name="struts.objectFactory.spring.useClassCache" />  

    <!-- 指定型別檢查,包含tiger和notiger --> 
    <cosntant name="struts.objectTypeDeterminer" value="tiger" />  

    <!-- 該屬性指定處理 MIME-type multipart/form-data,檔案上傳 --> 
    <constant name="struts.multipart.parser" value="cos" />  
    <constant name="struts.multipart.parser" value="pell" />  
    <constant name="struts.multipart.parser" value="jakarta" />  

    <!-- 指定上傳檔案時的臨時目錄,預設使用 javax.servlet.context.tempdir --> 
    <constant name="struts.multipart.saveDir" value="/tmpuploadfiles" />  

    <!-- 該屬性指定Struts 2檔案上傳中整個請求內容允許的最大位元組數 --> 
    <constant name="struts.multipart.maxSize" value="2097152" />  

    <!--   
        該屬性指定Struts2應用載入使用者自定義的屬性檔案,該自定義屬性檔案指定的屬性不會覆蓋   
        struts.properties檔案中指定的屬性。如果需要載入多個自定義屬性檔案,多個自定義屬性文   
        件的檔名以英文逗號(,)隔開。(也就是說不要改寫struts.properties!)   
    --> 
    <constant name="struts.custom.properties"  
        value="application,org/apache/struts2/extension/custom" />  

    <!-- 指定請求url與action對映器,預設為org.apache.struts2.dispatcher.mapper.DefaultActionMapper --> 
    <constant name="struts.mapper.class" value="org.apache.struts2.dispatcher.mapper.DefaultActionMapper" />  

    <!-- 指定action的字尾,預設為action --> 
    <constant name="struts.action.extension" value="do" />  

    <!-- 被 FilterDispatcher使用指定瀏覽器是否快取靜態內容,測試階段設定為false,釋出階段設定為true. --> 
    <constant name="struts.serve.static.browserCache" value="true" />  

    <!-- 設定是否支援動態方法呼叫,true為支援,false不支援. --> 
    <constant name="struts.enable.DynamicMethodInvocation" value="true" />  

    <!-- 設定是否可以在action中使用斜線,預設為false不可以,想使用需設定為true. --> 
    <constant name="struts.enable.SlashesInActionNames" value="true" />  

    <!-- 是否允許使用表示式語法,預設為true. --> 
    <constant name="struts.tag.altSyntax" value="true" />  

    <!-- 設定當struts.xml檔案改動時,是否重新載入 --> 
    <cosntant name="struts.configuration.xml.reload" value="true" />  

    <!-- 設定struts是否為開發模式,預設為false,測試階段一般設為true. --> 
    <cosntant name="struts.devMode" value="true" />  

    <!-- 設定是否每次請求,都重新載入資原始檔,預設值為false. --> 
    <cosntant name="struts.i18n.reload" value="false" />  

    <!-- 標準的UI主題,預設的UI主題為xhtml,可以為simple,xhtml或ajax --> 
    <cosntant name="struts.ui.theme" value="xhtml" />  

    <!-- 模板目錄 --> 
    <cosntant name="struts.ui.templateDir" value="template" />  

    <!-- 設定模板型別. 可以為 ftl, vm, or jsp --> 
    <cosntant name="struts.ui.templateSuffix" value="ftl" />  

    <!-- 定位velocity.properties 檔案. 預設velocity.properties --> 
    <cosntant name="struts.velocity.configfile" value="velocity.properties" />  

    <!-- 設定velocity的context. --> 
    <cosntant name="struts.velocity.contexts" value="...." />  

    <!-- 定位toolbox --> 
    <cosntant name="struts.velocity.toolboxlocation" value="...." />  

    <!-- 指定web應用的埠 --> 
    <cosntant name="struts.url.http.port" value="80" />  

    <!-- 指定加密埠 -->         
    <cosntant name="struts.url.https.port" value="443" />  

    <!-- 設定生成url時,是否包含引數.值可以為: none,get or all --> 
    <cosntant name="struts.url.includeParams" value="get" />  

    <!-- 設定要載入的國際化資原始檔,以逗號分隔. --> 
    <cosntant name="struts.custom.i18n.resources" value="application" />  

    <!-- 對於一些web應用伺服器不能處理HttpServletRequest.getParameterMap(),   
        像 WebLogic,Orion, and OC4J等,須設定成true,預設為false. --> 
    <cosntant name="struts.dispatcher.parametersWorkaround" value="false" />     

    <!-- 指定freemarker管理器 --> 
    <cosntant name="struts.freemarker.manager.classname" value="org.apache.struts2.views.freemarker.FreemarkerManager" />    

    <!-- 設定是否對freemarker的模板設定快取,效果相當於把template拷貝到 WEB_APP/templates. --> 
    <cosntant name="struts.freemarker.templatesCache" value="false" />       

    <!-- 通常不需要修改此屬性. --> 
    <cosntant name="struts.freemarker.wrapper.altMap" value="true" />    

    <!-- 指定xslt result是否使用樣式表快取.開發階段設為true,釋出階段設為false. --> 
    <cosntant name="struts.xslt.nocache" value="false" />    

    <!-- 設定struts自動載入的檔案列表. --> 
    <cosntant name="struts.configuration.files" value="struts-default.xml,struts-plugin.xml,struts.xml" />  

    <!-- 設定是否一直在最後一個slash之前的任何位置選定namespace. --> 
    <cosntant name="struts.mapper.alwaysSelectFullNamespace" value="false" />  
</struts>