STRUTS2.x 初始化相关的配置信息文件及struts.properties详解。

位于struts2-core.jar中

 

Org.apache.struts2 default.properties

 

 

 

#

# $Id: default.properties 789467 2009-06-29 22:11:12Z musachy $

#

# Licensed to the Apache Software Foundation (ASF) under one

# or more contributor license agreements. See the NOTICE file

# distributed with this work for additional information

# regarding copyright ownership. The ASF licenses this file

# to you under the Apache License, Version 2.0 (the

# “License”); you may not use this file except in compliance

# with the License. You may obtain a copy of the License at

#

# http://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing,

# software distributed under the License is distributed on an

# “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY

# KIND, either express or implied. See the License for the

# specific language governing permissions and limitations

# under the License.

#

### START SNIPPET: complete_file

 

### Struts default properties

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

###

 

### 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

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

 

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

# 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

# struts.objectFactory = spring

 

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

### valid values are: name, type, auto, and constructor (name is the default)

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.objectFactory.spring.useClassCache = true

 

### ensures the autowire strategy is always respected.

### 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

# struts.multipart.parser=cos

# struts.multipart.parser=pell

struts.multipart.parser=jakarta

# uses javax.servlet.context.tempdir by default

struts.multipart.saveDir=

struts.multipart.maxSize=2097152

 

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

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

 

### How request URLs are mapped to and from 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.

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

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.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”.

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.

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.ui.theme=xhtml

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

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.port = 80

struts.url.https.port = 443

### possible values are: none, get or all

struts.url.includeParams = none

 

### Load custom default resource bundles

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

 

### workaround for some app servers that don’t handle HttpServletRequest.getParameterMap()

### often used for 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

#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

struts.freemarker.templatesCache=false

 

### Enables caching of models on the BeanWrapper

struts.freemarker.beanwrapperCache=false

 

### See the StrutsBeanWrapper javadocs for more information

struts.freemarker.wrapper.altMap=true

 

### maxStrongSize for MruCacheStorage for 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

struts.mapper.alwaysSelectFullNamespace=false

 

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

struts.ognl.allowStaticMethodAccess=false

 

### Whether to throw a RuntimeException when a property is not found

### in an expression, or when the expression evaluation fails

struts.el.throwExceptionOnFailure=false

 

### Logs as Warnings properties that are not found (very verbose)

struts.ognl.logMissingProperties=false

 

### Caches parsed OGNL expressions, but can lead to memory leaks

### if the application generates a lot of different expressions

struts.ognl.enableExpressionCache=true

### END SNIPPET: complete_file

 

 

 

 

struts2的struts.properties配置文件详解

struts.action.extension

The URL extension to use to determine if the request is meant for a Struts action

用URL扩展名来确定是否这个请求是被用作Struts action，其实也就是设置 action的后缀，例如login.do的’do’字。

struts.configuration

The org.apache.struts2.config.Configuration implementation class

org.apache.struts2.config.Configuration接口名

struts.configuration.files

A list of configuration files automatically loaded by Struts

struts自动加载的一个配置文件列表

struts.configuration.xml.reload

Whether to reload the XML configuration or not

是否加载xml配置(true,false)

struts.continuations.package

The package containing actions that use Rife continuations

含有actions的完整连续的package名称

struts.custom.i18n.resources

Location of additional localization properties files to load

加载附加的国际化属性文件（不包含.properties后缀）

struts.custom.properties

Location of additional configuration properties files to load

加载附加的配置文件的位置

 

struts.devMode

Whether Struts is in development mode or not

是否为struts开发模式

struts.dispatcher.parametersWorkaround

Whether to use a Servlet request parameter workaround necessary for some versions of WebLogic

（某些版本的weblogic专用）是否使用一个servlet请求参数工作区（PARAMETERSWORKAROUND）

struts.enable.DynamicMethodInvocation

Allows one to disable dynamic method invocation from the URL

允许动态方法调用

struts.freemarker.manager.classname

The org.apache.struts2.views.freemarker.FreemarkerManager implementation class

org.apache.struts2.views.freemarker.FreemarkerManager接口名

struts.i18n.encoding

The encoding to use for localization messages

国际化信息内码

struts.i18n.reload

Whether the localization messages should automatically be reloaded

是否国际化信息自动加载

struts.locale

The default locale for the Struts application

默认的国际化地区信息

struts.mapper.class

The org.apache.struts2.dispatcher.mapper.ActionMapper implementation class

org.apache.struts2.dispatcher.mapper.ActionMapper接口

struts.multipart.maxSize

The maximize size of a multipart request (file upload)

multipart请求信息的最大尺寸（文件上传用）

struts.multipart.parser

The org.apache.struts2.dispatcher.multipart.MultiPartRequest parser implementation for a multipart request (file upload)

专为multipart请求信息使用的org.apache.struts2.dispatcher.multipart.MultiPartRequest解析器接口（文件上传用）

 

struts.multipart.saveDir

The directory to use for storing uploaded files

设置存储上传文件的目录夹

struts.objectFactory

The com.opensymphony.xwork2.ObjectFactory implementation class

com.opensymphony.xwork2.ObjectFactory接口（spring）

struts.objectFactory.spring.autoWire

Whether Spring should autoWire or not

是否自动绑定Spring

struts.objectFactory.spring.useClassCache

Whether Spring should use its class cache or not

是否spring应该使用自身的cache

struts.objectTypeDeterminer

The com.opensymphony.xwork2.util.ObjectTypeDeterminer implementation class

com.opensymphony.xwork2.util.ObjectTypeDeterminer接口

struts.serve.static.browserCache

If static content served by the Struts filter should set browser caching header properties or not

是否struts过滤器中提供的静态内容应该被浏览器缓存在头部属性中

struts.serve.static

Whether the Struts filter should serve static content or not

是否struts过滤器应该提供静态内容

struts.tag.altSyntax

Whether to use the alterative syntax for the tags or not

是否可以用替代的语法替代tags

struts.ui.templateDir

The directory containing UI templates

UI templates的目录夹

struts.ui.theme

The default UI template theme

默认的UI template主题

struts.url.http.port

The HTTP port used by Struts URLs

设置http端口

struts.url.https.port

The HTTPS port used by Struts URLs

设置https端口

struts.url.includeParams

The default includeParams method to generate Struts URLs

在url中产生 默认的includeParams

 

struts.velocity.configfile

The Velocity configuration file path

velocity配置文件路径

struts.velocity.contexts

List of Velocity context names

velocity的context列表

 

struts.velocity.manager.classname

org.apache.struts2.views.velocity.VelocityManager implementation class

org.apache.struts2.views.velocity.VelocityManager接口名

struts.velocity.toolboxlocation

The location of the Velocity toolbox

velocity工具盒的位置

struts.xslt.nocache

Whether or not XSLT templates should not be cached

是否XSLT模版应该被缓存

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文件了。

http://blog.csdn.net/yaa2004/article/details/4658734