struts2.0 配置文件、常量配置详解

001

通常struts2加载struts2常量的顺序如下:

002

003

1.struts-default.xml：该文件保存在struts2-core-2.0.6.jar文件中。

004

2.struts-plugin.xml：该文件保存在struts2-Xxx-2.0.6.jar等Struts2插件JAR文件中。

005

3.struts.xml：该文件是Web应用默认的Struts2配置文件。

006

4.struts.properties：该文件是Web应用默认的Struts2配置文件。

007

5.web.xml：该文件是Web应用的配置文件。如果在多个文件中配置了同一个Struts2常量，则后一个文件中的配置的常量值会覆盖前面文件中配置的常量值。

008

在不同文件中配置常量的方式是不一样的，但不管哪个文件中，配置Struts2常量都要指定两个属性：常量name和常量value。

009

010

推荐在struts.xml文件中配置Struts2常量。

011

012

此处只加载了前三个配置文件，这是在常量struts.configuration.files中配置的。该属性指定Struts2框架默认加载的配置文件，如果需要指定默认加载多个配置文件，则多个配置文件的文件名之间以英文逗号（,）隔开。该属性的默认值为struts-default.xml,struts-plugin.xml,struts.xml，这就是上图中加载的三个配置文件。

013

014

Struts2常量的具体用法实例

015

016

Xml代码

017

<?

xml

version

=

"1.0"

encoding

=

"UTF-8"

?>

018

<!DOCTYPEstrutsPUBLIC

019

"-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN"

020

"http://struts.apache.org/dtds/struts-2.0.dtd">

021

022

<

struts

>

023

<!--指定Web应用的默认编码集,相当于调用HttpServletRequest的setCharacterEncoding方法-->

024

<

constant

name

=

"struts.i18n.encoding"

value

=

"UTF-8"

/>

025

026

<!--

027

该属性指定需要Struts2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。

028

如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。

029

-->

030

<

constant

name

=

"struts.action.extension"

value

=

"do"

/>

031

032

<!--设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭-->

033

<

constant

name

=

"struts.serve.static.browserCache"

value

=

"false"

/>

034

035

<!--当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开-->

036

<

constant

name

=

"struts.configuration.xml.reload"

value

=

"true"

/>

037

038

<!--开发模式下使用,这样可以打印出更详细的错误信息-->

039

<

constant

name

=

"struts.devMode"

value

=

"true"

/>

040

041

<!--默认的视图主题-->

042

<

constant

name

=

"struts.ui.theme"

value

=

"simple"

/>

043

044

<!--spring托管-->

045

<

constant

name

=

"struts.objectFactory"

value

=

"spring"

/>

046

047

<!--

048

指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration

049

开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。

050

-->

051

<

constant

name

=

"struts.configuration"

052

value

=

"org.apache.struts2.config.DefaultConfiguration"

/>

053

054

<!--设置默认的locale和字符编码-->

055

<

constant

name

=

"struts.locale"

value

=

"zh_CN"

/>

056

<

constant

name

=

"struts.i18n.encoding"

value

=

"GBK"

/>

057

058

<!--指定Struts的工厂类-->

059

<

constant

name

=

"struts.objectFactory"

value

=

"spring"

></

constant

>

060

061

<!--

062

指定spring框架的装配模式，装配方式有:name,type,auto,andconstructor(name

063

是默认装配模式)

064

-->

065

<

constant

name

=

"struts.objectFactory.spring.autoWire"

value

=

"name"

/>

066

067

<!--该属性指定整合spring时，是否对bean进行缓存，值为trueorfalse,默认为true-->

068

<

cosntant

name

=

"struts.objectFactory.spring.useClassCache"

/>

069

070

<!--指定类型检查,包含tiger和notiger-->

071

<

cosntant

name

=

"struts.objectTypeDeterminer"

value

=

"tiger"

/>

072

073

<!--该属性指定处理MIME-typemultipart/form-data，文件上传-->

074

<

constant

name

=

"struts.multipart.parser"

value

=

"cos"

/>

075

<

constant

name

=

"struts.multipart.parser"

value

=

"pell"

/>

076

<

constant

name

=

"struts.multipart.parser"

value

=

"jakarta"

/>

077

078

<!--指定上传文件时的临时目录，默认使用javax.servlet.context.tempdir-->

079

<

constant

name

=

"struts.multipart.saveDir"

value

=

"/tmpuploadfiles"

/>

080

081

<!--该属性指定Struts2文件上传中整个请求内容允许的最大字节数-->

082

<

constant

name

=

"struts.multipart.maxSize"

value

=

"2097152"

/>

083

084

<!--

085

该属性指定Struts2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖

086

struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文

087

件的文件名以英文逗号（,）隔开。(也就是说不要改写struts.properties!)

088

-->

089

<

constant

name

=

"struts.custom.properties"

090

value

=

"application,org/apache/struts2/extension/custom"

/>

091

092

<!--指定请求url与action映射器，默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper-->

093

<

constant

name

=

"struts.mapper.class"

value

=

"org.apache.struts2.dispatcher.mapper.DefaultActionMapper"

/>

094

095

<!--指定action的后缀，默认为action-->

096

<

constant

name

=

"struts.action.extension"

value

=

"do"

/>

097

098

<!--被FilterDispatcher使用指定浏览器是否缓存静态内容，测试阶段设置为false，发布阶段设置为true.-->

099

<

constant

name

=

"struts.serve.static.browserCache"

value

=

"true"

/>

100

101

<!--设置是否支持动态方法调用，true为支持，false不支持.-->

102

<

constant

name

=

"struts.enable.DynamicMethodInvocation"

value

=

"true"

/>

103

104

<!--设置是否可以在action中使用斜线，默认为false不可以，想使用需设置为true.-->

105

<

constant

name

=

"struts.enable.SlashesInActionNames"

value

=

"true"

/>

106

107

<!--是否允许使用表达式语法，默认为true.-->

108

<

constant

name

=

"struts.tag.altSyntax"

value

=

"true"

/>

109

110

<!--设置当struts.xml文件改动时，是否重新加载-->

111

<

cosntant

name

=

"struts.configuration.xml.reload"

value

=

"true"

/>

112

113

<!--设置struts是否为开发模式，默认为false,测试阶段一般设为true.-->

114

<

cosntant

name

=

"struts.devMode"

value

=

"true"

/>

115

116

<!--设置是否每次请求，都重新加载资源文件，默认值为false.-->

117

<

cosntant

name

=

"struts.i18n.reload"

value

=

"false"

/>

118

119

<!--标准的UI主题，默认的UI主题为xhtml,可以为simple,xhtml或ajax-->

120

<

cosntant

name

=

"struts.ui.theme"

value

=

"xhtml"

/>

121

122

<!--模板目录-->

123

<

cosntant

name

=

"struts.ui.templateDir"

value

=

"template"

/>

124

125

<!--设置模板类型.可以为ftl,vm,orjsp-->

126

<

cosntant

name

=

"struts.ui.templateSuffix"

value

=

"ftl"

/>

127

128

<!--定位velocity.properties文件.默认velocity.properties-->

129

<

cosntant

name

=

"struts.velocity.configfile"

value

=

"velocity.properties"

/>

130

131

<!--设置velocity的context.-->

132

<

cosntant

name

=

"struts.velocity.contexts"

value

=

"...."

/>

133

134

<!--定位toolbox-->

135

<

cosntant

name

=

"struts.velocity.toolboxlocation"

value

=

"...."

/>

136

137

<!--指定web应用的端口-->

138

<

cosntant

name

=

"struts.url.http.port"

value

=

"80"

/>

139

140

<!--指定加密端口-->

141

<

cosntant

name

=

"struts.url.https.port"

value

=

"443"

/>

142

143

<!--设置生成url时，是否包含参数.值可以为:none,getorall-->

144

<

cosntant

name

=

"struts.url.includeParams"

value

=

"get"

/>

145

146

<!--设置要加载的国际化资源文件，以逗号分隔.-->

147

<

cosntant

name

=

"struts.custom.i18n.resources"

value

=

"application"

/>

148

149

<!--对于一些web应用服务器不能处理HttpServletRequest.getParameterMap(),

150

像WebLogic,Orion,andOC4J等，须设置成true,默认为false.-->

151

<

cosntant

name

=

"struts.dispatcher.parametersWorkaround"

value

=

"false"

/>

152

153

<!--指定freemarker管理器-->

154

<

cosntant

name

=

"struts.freemarker.manager.classname"

value

=

"org.apache.struts2.views.freemarker.FreemarkerManager"

/>

155

156

<!--设置是否对freemarker的模板设置缓存,效果相当于把template拷贝到WEB_APP/templates.-->

157

<

cosntant

name

=

"struts.freemarker.templatesCache"

value

=

"false"

/>

158

159

<!--通常不需要修改此属性.-->

160

<

cosntant

name

=

"struts.freemarker.wrapper.altMap"

value

=

"true"

/>

161

162

<!--指定xsltresult是否使用样式表缓存.开发阶段设为true,发布阶段设为false.-->

163

<

cosntant

name

=

"struts.xslt.nocache"

value

=

"false"

/>

164

165

<!--设置struts自动加载的文件列表.-->

166

<

cosntant

name

=

"struts.configuration.files"

value

=

"struts-default.xml,struts-plugin.xml,struts.xml"

/>

167

168

<!--设定是否一直在最后一个slash之前的任何位置选定namespace.-->

169

<

cosntant

name

=

"struts.mapper.alwaysSelectFullNamespace"

value

=

"false"

/>

170

</

struts

>