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

view source print?

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中配置的。该属性指定Struts 2框架默认加载的配置文件，如果需要指定默认加载多个配置文件，则多个配置文件的文件名之间以英文逗号（,）隔开。该属性的默认值为struts- default.xml,struts-plugin.xml,struts.xml，这就是上图中加载的三个配置文件。

013

014	Struts2常量的具体用法实例

015

016

Xml代码

017	<?xml version="1.0" encoding="UTF-8" ?>

018	<!DOCTYPE struts PUBLIC

019	"-//Apache Software Foundation//DTD Struts Configuration 2.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	该属性指定需要Struts 2处理的请求后缀，该属性的默认值是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, and constructor (name

063

是默认装配模式)

064

-->

065	<constant name="struts.objectFactory.spring.autoWire" value="name" />

066

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

068	<cosntant name="struts.objectFactory.spring.useClassCache" />

069

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

071	<cosntant name="struts.objectTypeDeterminer" value="tiger" />

072

073	<!-- 该属性指定处理 MIME-type multipart/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	<!-- 该属性指定Struts 2文件上传中整个请求内容允许的最大字节数 -->

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, or jsp -->

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,get or all -->

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, and OC4J等，须设置成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	<!-- 指定xslt result是否使用样式表缓存.开发阶段设为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>