譯註:爲了方便,翻譯時把原文件拆開翻譯,並對格式進行了一些改變.請自己打開default.properties瞭解原來的內容和格式.
default.properties的每一行如果前面有"#"符號,則表示該行爲備註,有一些行僅僅是爲了提示你如何使用,如果你需要使用,則要去掉相應的"#".
文件說明
default.properties是Webwork的缺省配置文件,可以被classpath根目錄下的 webwork.properties 文件覆蓋
配置工廠
指定用來配置webwork的 Configuration.
用戶可以擴展 com.opensymphony.webwork.config.Configuration 來創建自己的方式來獲取配置參數以傳給webwork
# webwork.configuration=com.opensymphony.webwork.config.DefaultConfiguration
指定locale,編碼
用來設置你的缺省 locale和編碼方案
# webwork.locale=en_USwebwork.i18n.encoding=UTF-8
Object Factory
如果指定了,缺省的ojbect factory在這裏可以被覆蓋
注意:縮寫在某些情況下是支持的,例如 "spring" .作爲代替,你可以提供一個 com.opensymphony.xwork.ObjectFactory 子類的名稱
# webwork.objectFactory = spring
自動裝配策略
指定當使用SpringObjectFactory時的自動裝配邏輯.
合法值包括: name, type, auto, 和 constructor (缺省爲 name )
webwork.objectFactory.spring.autoWire = name
類緩存
標識webwork-spring集成,如果類實例應該被緩存
這可能,直到將來Spring版本讓它變得可能,否則就保持它爲true
除非你確切的知道你在做什麼,否則不要改變
合法的值包括: true, false (true 是缺省的)
webwork.objectFactory.spring.useClassCache = true
缺省對象類型裁決者
如果設定了,缺省的對象類型裁決者可以被覆蓋
注意: 縮寫在某些情況下支持,例如 "tiger" or "notiger"
作爲代替,你可以提供一個 com.opensymphony.xwork.util.ObjectTypeDeterminer 實現類的名字
注意: 如果在classpath裏有 xwork-tiger.jar, GenericsObjectTypeDeterminer 缺省會被使用
關閉tiger支持,在這裏使用 "notiger" 屬性值.
#webwork.objectTypeDeterminer = tiger#webwork.objectTypeDeterminer = notiger
文件上傳設置
用來處理HTTP POST請求,編碼使用MIME-type multipart/form-data方式的
# webwork.multipart.parser=cos# webwork.multipart.parser=pellwebwork.multipart.parser=jakarta
- 保存的目錄缺省使用 javax.servlet.context.tempdir
webwork.multipart.saveDir=webwork.multipart.maxSize=2097152
定製配置
裝載定製的屬性文件(不會覆蓋webwork.properties!)
# webwork.custom.properties=application,com/webwork/extension/custom
缺省URL映射處理器
用來處理request URL如何映射到action,或者相反的映射(用戶可以實現自己的處理)
webwork.mapper.class=com.opensymphony.webwork.dispatcher.mapper.DefaultActionMapper
缺省後綴
DefaultActionMapper使用的設置
你可以提供一個逗號分割的列表,例如 webwork.action.extension=action,jnlp,do
webwork.action.extension=action
是否靜態文件由FilterDispatcher服務
FilterDispatcher使用的設置
如果爲true,那麼WebWork將會爲它jar包內的靜態文件提供服務.
如果爲false,那麼靜態文件必須在<context_path>/webwork下面可以訪問
webwork.serve.static
=true
標籤語法設定
使用 alternative syntax 在大多數地方需要 %{} 來計算標籤的字符串屬性的值
webwork.tag.altSyntax=true
開發模式設定
當設置爲true時,WebWork會對開發者更友好.這包括:
- webwork.i18n.reload = true
- webwork.configuration.xml.reload = true
- 引發不同的調試信息或者忽略的問題爲錯誤信息
例如: 正常情況下,一個請求 foo.action?someUnknownField=true 會被忽略(從web過來的任何值,都是不可信的).
因此,在開發的時候,當這些錯誤發生時立刻提醒,這可能是有用的
webwork.devMode = false
譯註:設置爲true時,所有有名字(name)的input都必須有對應的setter,否則會報錯.如果不需要,請刪除name. |
國際化資源設定
當設置爲true,資源包會在每個請求時自動重新載入.
這在開發時很方便,但是不應該在生產狀態下使用
webwork.i18n.reload=false
theme和模板設定
標準的UI theme
改變這個會映射缺省由那個路徑的模板來輸出JSP控件標籤
webwork.ui.theme=xhtmlwebwork.ui.templateDir=template
設置缺省模板類型,可以是ftl,vm,jsp
webwork.ui.templateSuffix=ftl
配置自動更新設定
配置自動重新裝載,這會導致配置來重新載入xwork.xml, 當它改變的時候
webwork.configuration.xml.reload=false
Velocity配置設定
velocity.properties 文件的位置.缺省是 velocity.properties
# webwork.velocity.configfile = velocity.properties
逗號分割的 VelocityContext 類名來鏈接到 WebWorkVelocityContext
# webwork.velocity.contexts =
URL相關設定
用來構建URL,例如UrlTag
webwork.url.http.port = 80webwork.url.https.port = 443
自定義國際化資源
裝載自定義的缺省資源包(如果有多個,用逗號分割)
# webwork.custom.i18n.resources=testmessages,testmessages2
應用服務器相關設定
有些app server不能處理HttpServletRequest.getParameterMap(),經常使用的是WebLogic,Orion和OC4J
webwork.dispatcher.parametersWorkaround = false
FreeMarker相關設定
配置要用的 Freemarker Manager 類
允許用戶插入自定義的 Freemarker Manager ,如果需要的話
必須擴展 com.opensymphony.webwork.views.freemarker.FreemarkerManager
#webwork.freemarker.manager.classname=com.opensymphony.webwork.views.freemarker.FreemarkerManager
瀏覽 WebWorkBeanWrapper 的javadoc 瞭解更多信息
webwork.freemarker.wrapper.altMap=true
XSLTResult相關設定
配置 XSLTResult 類使用 stylesheet 緩存.
開發時設置爲true,生產時設置爲false.
webwork.xslt.nocache=false