Struts2配置文件詳解

這個文件是struts2框架的全局屬性文件,也是自動加載的文件。該文件包含了系列的key-value對。該文件完全可以配置在struts.xml文件中,使用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文件了。

### 指定加載struts2配置文件管理器,默認爲org.apache.struts2.config.DefaultConfiguration

### 開發者可以自定義配置文件管理器,該類要實現Configuration接口,可以自動加載struts2配置文件。

# struts.configuration=org.apache.struts2.config.DefaultConfiguration


### 設置默認的locale和字符編碼

# struts.locale=en_US

struts.i18n.encoding=UTF-8


### 指定struts的工廠類

# struts.objectFactory = spring


### 指定spring框架的裝配模式

### 裝配方式有: name, type, auto, and constructor (name 是默認裝配模式)

struts.objectFactory.spring.autoWire = name


### 該屬性指定整合spring時,是否對bean進行緩存,值爲true or false,默認爲true.

struts.objectFactory.spring.useClassCache = true


### 指定類型檢查

#struts.objectTypeDeterminer = tiger

#struts.objectTypeDeterminer = notiger


### 該屬性指定處理 MIME-type multipart/form-data,文件上傳

# struts.multipart.parser=cos

# struts.multipart.parser=pell

struts.multipart.parser=jakarta

# 指定上傳文件時的臨時目錄,默認使用 javax.servlet.context.tempdir

struts.multipart.saveDir=

struts.multipart.maxSize=2097152


### 加載自定義屬性文件 (不要改寫struts.properties!)

# struts.custom.properties=application,org/apache/struts2/extension/custom


### 指定請求url與action映射器,默認爲org.apache.struts2.dispatcher.mapper.DefaultActionMapper

#struts.mapper.class=org.apache.struts2.dispatcher.mapper.DefaultActionMapper


### 指定action的後綴,默認爲action

struts.action.extension=action


### 被 FilterDispatcher使用

### 如果爲 true 則通過jar文件提供靜態內容服務.

### 如果爲 false 則靜態內容必須位於 <context_path>/struts

struts.serve.static=true


### 被 FilterDispatcher使用

### 指定瀏覽器是否緩存靜態內容,測試階段設置爲false,發佈階段設置爲true.

struts.serve.static.browserCache=true


### 設置是否支持動態方法調用,true爲支持,false不支持.

struts.enable.DynamicMethodInvocation = true


### 設置是否可以在action中使用斜線,默認爲false不可以,想使用需設置爲true.

struts.enable.SlashesInActionNames = false


### 是否允許使用表達式語法,默認爲true.

struts.tag.altSyntax=true


### 設置當struts.xml文件改動時,是否重新加載.

### - struts.configuration.xml.reload = true

### 設置struts是否爲開發模式,默認爲false,測試階段一般設爲true.

struts.devMode = false


### 設置是否每次請求,都重新加載資源文件,默認值爲false.

struts.i18n.reload=false


###標準的UI主題

### 默認的UI主題爲xhtml,可以爲simple,xhtml或ajax

struts.ui.theme=xhtml

###模板目錄

struts.ui.templateDir=template

#設置模板類型. 可以爲 ftl, vm, or jsp

struts.ui.templateSuffix=ftl


###定位velocity.properties 文件. 默認 velocity.properties

struts.velocity.configfile = velocity.properties


### 設置velocity的context.

struts.velocity.contexts =


### 定位toolbox.

struts.velocity.toolboxlocation=


### 指定web應用的端口.

struts.url.http.port = 80

### 指定加密端口

struts.url.https.port = 443

### 設置生成url時,是否包含參數.值可以爲: none, get or all

struts.url.includeParams = get


### 設置要加載的國際化資源文件,以逗號分隔.

# struts.custom.i18n.resources=testmessages,testmessages2


### 對於一些web應用服務器不能處理HttpServletRequest.getParameterMap()

### 像 WebLogic, Orion, and OC4J等,須設置成true,默認爲false.

struts.dispatcher.parametersWorkaround = false


### 指定freemarker管理器

#struts.freemarker.manager.classname=org.apache.struts2.views.freemarker.FreemarkerManager


### 設置是否對freemarker的模板設置緩存

### 效果相當於把template拷貝到 WEB_APP/templates.

struts.freemarker.templatesCache=false


### 通常不需要修改此屬性.

struts.freemarker.wrapper.altMap=true


### 指定xslt result是否使用樣式表緩存.開發階段設爲true,發佈階段設爲false.

struts.xslt.nocache=false


### 設置struts自動加載的文件列表.

struts.configuration.files=struts-default.xml,struts-plugin.xml,struts.xml


### 設定是否一直在最後一個slash之前的任何位置選定namespace.

struts.mapper.alwaysSelectFullNamespace=false
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章