struts2 struts.properties 的详解

 为了以后方便使用，在网上找了片翻译好的配置详解！

 

 

### Struts default properties

### Struts 默认属性文件
###(can be overridden by a struts.properties file in the root of the classpath)

###可以用classpath根路径上的struts.properties文件来覆盖本设置
###

### Specifies the Configuration used to configure Struts 
### one could extend org.apache.struts2.config.Configuration
### to build one's customize way of getting the configurations parameters into Struts

### 指定一个扩展自org.apache.struts2.config.Configuration类的Cnfiguration类

### 来完成自定义的配置参数读入
# struts.configuration=org.apache.struts2.config.DefaultConfiguration

### This can be used to set your default locale and encoding scheme

### 用来设定默认的locale和encoding
# struts.locale=en_US
struts.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.xwork2.ObjectFactory subclass name here 

### 如果该参数被指定，默认的对象工厂将被覆盖，注意：这里可以支持“简称”（如"spring"）也可以提供一

### 个com.opensymphony.xwork2.ObjectFactory的子类的全类名
# struts.objectFactory = spring

### specifies the autoWiring logic when using the SpringObjectFactory.

### 当struts.objectFactory使用SpringObjectFactory时，这里指定spring自动装配的策略
### valid values are: name, type, auto, and constructor (name is the default)

### 可选的值有：name,type,auto和constructor(name是默认的)
struts.objectFactory.spring.autoWire = name

### indicates to the struts-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)

### 表明struts-spring集成时类实例是否要被缓存，这要spring的支持（好像是现在没用）默认值是true
struts.objectFactory.spring.useClassCache = true

### ensures the autowire strategy is always respected.

### 确保spring的自动装配策略总是被考虑的
### valid values are: true, false (false is the default)
struts.objectFactory.spring.autoWire.alwaysRespect = false

### 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.xwork2.util.ObjectTypeDeterminer implementation name here
### Note: By default, com.opensymphony.xwork2.util.DefaultObjectTypeDeterminer is used which handles type detection
###       using generics. com.opensymphony.xwork2.util.GenericsObjectTypeDeterminer was deprecated since XWork 2, it's
###       functions are integrated in DefaultObjectTypeDeterminer now.
###       To disable tiger support use the "notiger" property value here.

### 这个没有用过不知道是做什么的
#struts.objectTypeDeterminer = tiger
#struts.objectTypeDeterminer = notiger

### Parser to handle HTTP POST requests, encoded using the MIME-type multipart/form-data

### 指定用什么来解析MIME-type是multipart/form-data(即上传文件)的request的post提交

### 有cos、pell、jakarta三个选择
# struts.multipart.parser=cos
# struts.multipart.parser=pell
struts.multipart.parser=jakarta
# uses javax.servlet.context.tempdir by default

### 上传临时文件存放路径（默认是javax.servlet.context.tempdir）
struts.multipart.saveDir=

### 上传临时文件大小最大限制
struts.multipart.maxSize=2097152

### Load custom property files (does not override struts.properties!)

### 用户自定义属性文件路径（不能是struts.properties）
# struts.custom.properties=application,org/apache/struts2/extension/custom

### How request URLs are mapped to and from actions

### 设置如何将URLs关联到actions
#struts.mapper.class=org.apache.struts2.dispatcher.mapper.DefaultActionMapper

### Used by the DefaultActionMapper
### You may provide a comma separated list, e.g. struts.action.extension=action,jnlp,do
### The blank extension allows you to match directory listings as well as pure action names
### without interfering with static resources.

### 如果使用了DefaultActionMapper那么这里你可以提供一个以逗号分隔的列表作为后缀，如：

### struts.action.extension=action,jnlp,do空白的后缀允许你以目录列表作为更好的action名进行匹配
struts.action.extension=action,,

### Used by FilterDispatcher
### If true then Struts serves static content from inside its jar. 
### If false then the static content must be available at <context_path>/struts

### 如果使用FilterDispatcher，当该设为true时struts从jar里提供静态资源(如dojo提供的时间控件)

### 当该设为false时静态资源必须在<context_path>/struts才有效
struts.serve.static=true

### Used by FilterDispatcher
### This is good for development where one wants changes to the static content be
### fetch on each request. 
### NOTE: This will only have effect if struts.serve.static=true
### If true -> Struts will write out header for static contents such that they will
###             be cached by web browsers (using Date, Cache-Content, Pragma, Expires)
###             headers).
### If false -> Struts will write out header for static contents such that they are
###            NOT to be cached by web browser (using Cache-Content, Pragma, Expires
###            headers)

### 设置是否缓存静态资源
struts.serve.static.browserCache=true

### Set this to false if you wish to disable implicit dynamic method invocation
### via the URL request. This includes URLs like foo!bar.action, as well as params
### like method:bar (but not action:foo). 
### An alternative to implicit dynamic method invocation is to use wildcard 
### mappings, such as <action name="*/*" method="{2}" class="actions.{1}">

### 设置struts是否支持动态方法调用
struts.enable.DynamicMethodInvocation = true

### Set this to true if you wish to allow slashes in your action names.  If false,
### Actions names cannot have slashes, and will be accessible via any directory
### prefix.  This is the traditional behavior expected of WebWork applications.
### Setting to true is useful when you want to use wildcards and store values
### in the URL, to be extracted by wildcard patterns, such as 
### <action name="*/*" method="{2}" class="actions.{1}"> to match "/foo/edit" or 
### "/foo/save".

### 设置是否允许action的name里有"/"
struts.enable.SlashesInActionNames = false

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

### when set to true, Struts will act much more friendly for developers. This
### includes:
### - struts.i18n.reload = true
### - struts.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.

### 是否是开发模式，true:i18n自动重新加载，struts配置文件自动重新加载
struts.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
struts.i18n.reload=false

### Standard UI theme
### Change this to reflect which path should be used for JSP control tag templates by default

### struts标签使用哪种默认样式
struts.ui.theme=xhtml

### struts标签的模板所在路径
struts.ui.templateDir=template
#sets the default template type. Either ftl, vm, or jsp

### 设置模板类型
struts.ui.templateSuffix=ftl

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

### Location of velocity.properties file.  defaults to velocity.properties

### velocit的配置文件
struts.velocity.configfile = velocity.properties

### Comma separated list of VelocityContext classnames to chain to the StrutsVelocityContext
struts.velocity.contexts =

### Location of the velocity toolbox
struts.velocity.toolboxlocation=

### used to build URLs, such as the UrlTag

### 用struts标签构造的url的http端口号和https端口号
struts.url.http.port = 80
struts.url.https.port = 443
### possible values are: none, get or all
struts.url.includeParams = get

### Load custom default resource bundles

### 自定义的i18n
# struts.custom.i18n.resources=testmessages,testmessages2

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

### workaround对于一些不处理HttpServletRequest.getParameterMap()的应用服务器，如：WebLogic, Orion, and OC4J
struts.dispatcher.parametersWorkaround = false

### configure the Freemarker Manager class to be used
### Allows user to plug-in customised Freemarker Manager if necessary
### MUST extends off org.apache.struts2.views.freemarker.FreemarkerManager

### 配置Freemarker Manager类，如果必要可以使用自定义的Freemarker Manager插件
### 必须扩展自org.apache.struts2.views.freemarker.FreemarkerManager

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

### Enables caching of FreeMarker templates
### Has the same effect as copying the templates under WEB_APP/templates

### 允许缓存FreeMarker的模板，与把模板文件考到web_app/templates目录下有一样的效果
struts.freemarker.templatesCache=false

### Enables caching of models on the BeanWrapper

### 允许缓存BeanWrapper的models
struts.freemarker.beanwrapperCache=false

### See the StrutsBeanWrapper javadocs for more information
struts.freemarker.wrapper.altMap=true

### maxStrongSize for MruCacheStorage for freemarker

### FreeMarker缓存大小
struts.freemarker.mru.max.strong.size=100

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

### Whether to always select the namespace to be everything before the last slash or not

### 是否总是选择最后一个斜杠前的namespace
struts.mapper.alwaysSelectFullNamespace=false

### Whether to allow static method access in OGNL expressions or not

### 是否允许在OGNL表达式的表态方法访问
struts.ognl.allowStaticMethodAccess=false