webwork.properties

### Webwork default properties
###(can be overridden by a webwork.properties file in the root of the classpath)
###

### Specifies the Configuration used to configure webwork
### one could extend com.opensymphony.webwork.config.Configuration
### to build one's customize way of getting the configurations parameters into webwork
# webwork.configuration=com.opensymphony.webwork.config.DefaultConfiguration

### This can be used to set your default locale and encoding scheme
# webwork.locale=en_US
webwork.i18n.encoding=UTF-8

### if specified, the default object factory can be overridden here
### Note: short-hand notation is supported in some cases, such as "spring"
###       Alternatively, you can provide a com.opensymphony.xwork.ObjectFactory subclass name here  
# webwork.objectFactory = spring

### specifies the autoWiring logic when using the SpringObjectFactory.
### valid values are: name, type, auto, and constructor (name is the default)
webwork.objectFactory.spring.autoWire=name

### indicates to the webwork-spring integration if Class instances should be cached
### this should, until a future Spring release makes it possible, be left as true
### unless you know exactly what you are doing!
### valid values are: true, false (true is the default)
webwork.objectFactory.spring.useClassCache=true

### if specified, the default object type determiner can be overridden here
### Note: short-hand notation is supported in some cases, such as "tiger" or "notiger"
###       Alternatively, you can provide a com.opensymphony.xwork.util.ObjectTypeDeterminer implementation name here
### Note: if you have the xwork-tiger.jar within your classpath, GenericsObjectTypeDeterminer is used by default
###       To disable tiger support use the "notiger" property value here.
#webwork.objectTypeDeterminer=tiger
#webwork.objectTypeDeterminer=notiger

### Parser to handle HTTP POST requests, encoded using the MIME-type multipart/form-data
# webwork.multipart.parser=cos
# webwork.multipart.parser=pell
webwork.multipart.parser=jakarta
# uses javax.servlet.context.tempdir by default
webwork.multipart.saveDir=
webwork.multipart.maxSize=2097152

### Load custom property files (does not override webwork.properties!)
# webwork.custom.properties=application,com/webwork/extension/custom

### How request URLs are mapped to and from actions
webwork.mapper.class=com.opensymphony.webwork.dispatcher.mapper.DefaultActionMapper

### Used by the DefaultActionMapper
### You may provide a comma separated list, e.g. webwork.action.extension=action,jnlp,do
webwork.action.extension=action


### CompositeActionMapper
#  if we use a CompositeActionMapper, we could define the the ActionMappers
#  that will be consulted as follows. ActionMapper with lower order takes
#  precedence :-
#webwork.mapper.class=com.opensymphony.webwork.dispatcher.mapper.CompositeActionMapper
#webwork.compositeActionMapper.1=com.opensymphony.webwork.dispatcher.mapper.RestfulActionMapper
#webwork.compositeActionMapper.2=com.opensymphony.webwork.dispatcher.mapper.DefaultActionMapper


### Used by FilterDispatcher
### If true than WW serves static content from inside its jar. 
### If false than the static content must be available at <context_path>/webwork
webwork.serve.static=true

### use alternative syntax that requires %{} in most places
### to evaluate expressions for String attributes for tags
webwork.tag.altSyntax=true

### when set to true, WebWork will act much more friendly for developers. This
### includes:
### - webwork.i18n.reload = true
### - webwork.configuration.xml.reload = true
### - raising various debug or ignorable problems to errors
###   For example: normally a request to foo.action?someUnknownField=true should
###                be ignored (given that any value can come from the web and it
###                should not be trusted). However, during development, it may be
###                useful to know when these errors are happening and be told of
###                them right away.
webwork.devMode=false

### when set to true, resource bundles will be reloaded on _every_ request.
### this is good during development, but should never be used in production
webwork.i18n.reload=false

### Standard UI theme
### Change this to reflect which path should be used for JSP control tag templates by default
webwork.ui.theme=xhtml
webwork.ui.templateDir=template
#sets the default template type. Either ftl, vm, or jsp
webwork.ui.templateSuffix=ftl

### Configuration reloading
### This will cause the configuration to reload xwork.xml when it is changed
webwork.configuration.xml.reload=false

### Location of velocity.properties file.  defaults to velocity.properties
# webwork.velocity.configfile=velocity.properties

### Comma separated list of VelocityContext classnames to chain to the WebWorkVelocityContext
# webwork.velocity.contexts=

### used to build URLs, such as the UrlTag
webwork.url.http.port=80
webwork.url.https.port=443

### possible values are: none, get or all
webwork.url.includeParams=get

### Load custom default resource bundles
# webwork.custom.i18n.resources=testmessages,testmessages2

### workaround for some app servers that don't handle HttpServletRequest.getParameterMap()
### often used for WebLogic, Orion, and OC4J
webwork.dispatcher.parametersWorkaround=false

### configure the Freemarker Manager class to be used
### Allows user to plug-in customised Freemarker Manager if necessary
### MUST extends off com.opensymphony.webwork.views.freemarker.FreemarkerManager
#webwork.freemarker.manager.classname=com.opensymphony.webwork.views.freemarker.FreemarkerManager

### See the WebWorkBeanWrapper javadocs for more information
webwork.freemarker.wrapper.altMap=true

### configure the XSLTResult class to use stylesheet caching.
### Set to true for developers and false for production.
webwork.xslt.nocache=false

### insert Freemarker's Sitemesh applydecorator transform to be put
### into freemarker's model allowing sitemesh's applydecorator tag to 
### be used in freemarker's page eg.
### <@sitemesh.applydecorator name="someDecorator" page="/pages/somePage.ftl" />
#
webwork.freemarker.sitemesh.applyDecoratorTransform=true

### A start up listener class name (must implements com.opensymphony.webwork.dispatcher.StartUpListener 
### interface) that will get invoked only once when WebWork started up. The class names could be 
### comma separated and will be executed in order.
#
#webwork.dispatcher.startUpListener=foo.bar.StartUpListener1,foo.bar.StartUpListener2

### A shut down listener class name (must implements com.opensymphony.webwork.dispatcher.ShutDownListener
### interface) that will get invoked only once when WebWork shuts down.  The class names could be
### comma separated and will be executed in order.
#
#webwork.dispatcher.shutDownListener=foo.bar.ShutDownListener1,foo.bar.ShutDownListener2

文件说明  

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_US 
webwork .i18n.encoding=UTF-8 

Object Factory  

如果指定了,缺省的ojbect factory在这里可以被覆盖 
注意:缩写在某些情况下是支持的,例如 "spring" .作为代替,你可以提供一个 com.opensymphony.xwork. ObjectFactory  子类的名称 
#  webwork . objectFactory  = spring 

自动装配策略  

指定当使用Spring ObjectFactory 时的自动装配逻辑. 
合法值包括: 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=pell 
webwork .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=xhtml 
webwork .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 类名来链接到  WebWork VelocityContext 
#  webwork .velocity.contexts = 

URL相关设定  

用来构建URL,例如UrlTag 
webwork .url.http.port = 80 
webwork .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 

浏览  WebWork BeanWrapper 的javadoc 了解更多信息 
webwork .freemarker.wrapper.altMap=true 

XSLTResult相关设定  

配置 XSLTResult 类使用 stylesheet 缓存. 
开发时设置为true,生产时设置为false. 
webwork .xslt.nocache=false