Struts 2中的constant配置详解

2024-03-12 15:40:04 146

1.<constantname="struts.i18n.encoding"value="UTF-8"/>
指定Web应用的默认编码集，相当于调用HttpServletRequest的setCharacterEncoding方法。

2.<constantname="struts.i18n.reload"value="false"/>
该属性设置是否每次HTTP请求到达时，系统都重新加载资源文件。该属性默认值是false。在开发阶段将该属性设置为true会更有利于开发，但在产品发布阶段应将该属性设置为false。

3.<constantname="struts.custom.i18n.resources"value="application"/>
该属性指定Struts2应用所需要的国际化资源文件，如果有多份国际化资源文件，则多个资源文件的文件名以英文逗号（,）隔开。

4.<constantname="struts.action.extension"value="action"/>
该属性指定需要Struts2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（，）隔开。

5.<constantname="struts.serve.static.browserCache"value="true"/>
设置浏览器是否缓存静态内容，默认值为true（生产环境下使用），开发阶段最好关闭。

6.<constantname="struts.configuration.xml.reload"value="false"/>
当struts2的配置文件修改后，系统是否自动重新加载该文件，默认值为false（生产环境下使用），开发阶段最好打开。

7.<constantname="struts.configuration.files"value="struts-default.xml,struts-plugin.xml,struts.xml"/>
该属性指定Struts2框架默认加载的配置文件，如果需要指定默认加载多个配置文件，则多个配置文件的文件名之间以英文逗号(,)隔开。该属性的默认值为struts-default.xml,struts-plugin.xml,struts.xml，看到该属性值，读者应该明白为什么Struts2框架默认加载struts.xml文件了。

8.<constantname="struts.configuration"value="org.apache.struts2.config.DefaultConfiguration"/>
指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration，开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。

8.<constantname="struts.continuations.package"value=""/>
含有Actions的完整连续的package名称。

10.<constantname="struts.devMode"value="true"/>
开发模式下使用，这样可以打印出更详细的错误信息。

11.<constantname="struts.serve.static.browserCache"value="false"/>
该属性设置浏览器是否缓存静态内容。当应用处于开发阶段时，我们希望每次请求都获得服务器的最新响应，则可设置该属性为false。

12.<constantname="struts.enable.DynamicMethodInvocation"value="false"/>
该属性设置Struts2是否支持动态方法调用，该属性的默认值是true。如果需要关闭动态方法调用，则可设置该属性为false。

13.<constantname="struts.enable.SlashesInActionNames"value="false"/>
该属性设置Struts2是否允许在Action名中使用斜线，该属性的默认值是false。如果开发者希望允许在Action名中使用斜线，则可设置该属性为true。

14.<constantname="struts.tag.altSyntax"value="true"/>
该属性指定是否允许在Struts2标签中使用表达式语法，因为通常都需要在标签中使用表达式语法，故此属性应该设置为true，该属性的默认值是true。

15.<constantname="struts.devMode"value="false"/>
该属性设置Struts2应用是否使用开发模式。如果设置该属性为true，则可以在应用出错时显示更多、更友好的出错提示。该属性只接受true和flase两个值，该属性的默认值是false。通常，应用在开发阶段，将该属性设置为true，当进入产品发布阶段后，则该属性设置为false。

16.<constantname="struts.ui.theme"value="xhtml"/>
该属性指定视图标签默认的视图主题，该属性的默认值是xhtml，可以为simple,xhtml或ajax。

17.<constantname="struts.ui.templateDir"value="template"/>
该属性指定视图主题所需要模板文件的位置，该属性的默认值是template，即默认加载template路径下的模板文件。

18.<constantname="struts.ui.templateSuffix"value="ftl"/>
该属性指定模板文件的后缀，该属性的默认属性值是ftl。该属性还允许使用ftl、vm或jsp，分别对应FreeMarker、Velocity和JSP模板。

19.<constantname="struts.velocity.configfile"value="velocity.properties"/>
该属性指定Velocity框架所需的velocity.properties文件的位置。该属性的默认值为velocity.properties。

20.<constantname="struts.velocity.contexts"value=""/>
该属性指定Velocity框架的Context位置，如果该框架有多个Context，则多个Context之间以英文逗号（,）隔开。

21.<constantname="struts.velocity.toolboxlocation"value=""/>
该属性指定Velocity框架的toolbox的位置。

22.<constantname="struts.url.http.port"value="80"/>
该属性指定Web应用所在的监听端口。该属性通常没有太大的用处，只是当Struts2需要生成URL时（例如Url标签），该属性才提供Web应用的默认端口。

23.<constantname="struts.url.https.port"value="443"/>
该属性类似于struts.url.http.port属性的作用，区别是该属性指定的是Web应用的加密服务端口。

24.<constantname="struts.url.includeParams"value="none|get|all"/>
该属性指定Struts2生成URL时是否包含请求参数。该属性接受none、get和all三个属性值，分别对应于不包含、仅包含GET类型请求参数和包含全部请求参数。

25.<constantname="struts.dispatcher.parametersWorkaround"value="false"/>
对于某些JavaEE服务器，不支持HttpServletRequest调用getParameterMap()方法，此时可以设置该属性值为true来解决该问题。该属性的默认值是false。对于WebLogic、Orion和OC4J服务器，通常应该设置该属性为true。

26.<constantname="struts.freemarker.manager.classname"value=""/>
该属性指定Struts2使用的FreeMarker管理器。该属性的默认值是org.apache.struts2.views.freemarker.FreemarkerManager，这是Struts2内建的FreeMarker管理器。

27.<constantname="struts.freemarker.wrapper.altMap"value="true"/>
该属性只支持true和false两个属性值，默认值是true。通常无需修改该属性值。

28.<cosntantname="struts.freemarker.templatesCache"value="false"/>
设置是否对freemarker的模板设置缓存,效果相当于把template拷贝到WEB_APP/templates.

29.<constantname="struts.xslt.nocache"value="false"/>
该属性指定XSLTResult是否使用样式表缓存。当应用处于开发阶段时，该属性通常被设置为true；当应用处于产品使用阶段时，该属性通常被设置为false。

30.<constantname="struts.custom.properties"value="application,org/apache/struts2/extension/custom
"/>
指定Struts2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文件的文件名以英文逗号（,）隔开。(也就是说不要改写struts.properties!)
31.<constantname="struts.locale"value="zh_CN"/>
默认的国际化地区信息。

32.<constantname="struts.mapper.class"value="org.apache.struts2.dispatcher.mapper.DefaultActionMapper"/>
指定请求url与action映射器，默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper

33.<cosntantname="struts.mapper.alwaysSelectFullNamespace"value="false"/>
设定是否一直在最后一个slash之前的任何位置选定namespace

34.<constantname="struts.multipart.maxSize"value="2097152"/>
multipart请求信息的最大尺寸（文件上传用，该属性指定Struts2文件上传中整个请求内容允许的最大字节数）。

35.<constantname="struts.multipart.parser"value="cos"/>
该属性指定处理MIME-typemultipart/form-data，文件上传（cos、pell、jakarta）
专为multipart请求信息使用的org.apache.struts2.dispatcher.multipart.MultiPartRequest解析器接口（文件上传用)。

36.<constantname="struts.multipart.saveDir"value="/tmpuploadfiles"/>
指定上传文件时的临时目录，默认使用javax.servlet.context.tempdir。

37.<constantname="struts.objectFactory"value="spring"/>
该属性指定Struts2中的Action由Spring容器创建。

38.<constantname="struts.objectFactory.spring.autoWire"value="name"/>
指定spring框架的装配模式，装配方式有:name,type,auto,andconstructor(name是默认装配模式)

39.<constantname="struts.objectFactory.spring.useClassCache"value="true"/>
该属性指定整合spring时，是否对bean进行缓存，值为trueorfalse,默认为true。

40.<cosntantname="struts.objectTypeDeterminer"value="tiger"/>
指定类型检查,包含tiger和notiger

struts2中的constant配置详解

本文主要讲解一下struts2中的constant常量配置，内容主要来自于互联网的整理。

<?xmlversion="1.0"encoding="UTF-8"?>
<!DOCTYPEstrutsPUBLIC"-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<!--指定Web应用的默认编码集.该属性对于处理中文请求参数非常有用，对于获取中文请求参数值，应该将该属性值设置为GBK或者GB2312
提示:当设置该参数为GBK时，相当于调用HttpServletRequest的setCharacterEncoding方法>
<constantname="struts.i18n.encoding"value="UTF-8"/>

<!--指定Struts2默认的ObjectFactoryBean，该属性默认值是spring.>
<constantname="struts.objectFactory"value="spring"/>

<!--指定Spring框架的自动装配模式，该属性的默认值是name，即默认根据Bean的name属性自动装配.>
<constantname="struts.objectFactory.spring.autoWire"value="name"/>

<!--该属性指定整合Spring框架时，是否缓存Bean实例，该属性只允许使用true和false两个属性值，它的默认值是true.通常不建议修改该属性值.>
<constantname="struts.objectFactory.spring.useClassCache"value="true"/>

<!--该属性指定处理multipart/form-data的MIME类型(文件上传)请求的框架，该属性支持cos，pell和jakarta等属性值，即分别对应使用cos的文件上传框架，
pell上传及common-fileupload文件上传框架，该属性的默认值为jakarta.
注意:如果需要使用cos或者pell的文件上传方式，则应该将对应的JAR文件复制到Web应用中.例如，使用cos上传方式，则需要自己下载cos框架的JAR文件，
并将该文件放在WEB-INF/lib路径下.>
<constantname="struts.multipart.parser"value="jakarta"/>

<!--该属性指定上传文件的临时保存路径，该属性的默认值是javax.servlet.context.tempdir.>
<constantname="struts.multipart.saveDir"value=""/>

<!--该属性指定Struts2文件上传中整个请求内容允许的最大字节数.>
<constantname="struts.multipart.maxSize"value="1000000000000"/>

<!--该属性指定需要Struts2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理.
如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号(，)隔开.>
<constantname="struts.action.extension"value="do"/>

<!--该属性设置是否通过JAR文件提供静态内容服务，该属性只支持true和false属性值，该属性的默认属性值是true.>
<constantname="struts.serve.static"value="true"/>

<!--该属性设置浏览器是否缓存静态内容.当应用处于开发阶段时，我们希望每次请求都获得服务器的最新响应，则可设置该属性为false.>
<constantname="struts.serve.static.browserCache"value="true"/>

<!--该属性设置Struts2应用是否使用开发模式.如果设置该属性为true，则可以在应用出错时显示更多、更友好的出错提示.
该属性只接受true和flase两个值，该属性的默认值是false.通常，应用在开发阶段，将该属性设置为true，当进入产品发布阶段后，则该属性设置为false.>
<constantname="struts.devMode"value="false"/>

<!--该属性设置是否每次HTTP请求到达时，系统都重新加载资源文件(允许国际化文件重载).该属性默认值是false.
在开发阶段将该属性设置为true会更有利于开发，但在产品发布阶段应将该属性设置为false.
提示:开发阶段将该属性设置了true，将可以在每次请求时都重新加载国际化资源文件，从而可以让开发者看到实时开发效果;
产品发布阶段应该将该属性设置为false，是为了提供响应性能，每次请求都需要重新加载资源文件会大大降低应用的性能.>
<constantname="struts.i18n.reload"value="false"/>

<!--该属性指定视图标签默认的视图主题，该属性的默认值是xhtml.>
<constantname="struts.ui.theme"value="simple"/>

<!--该属性指定模板文件的后缀，该属性的默认属性值是ftl.该属性还允许使用ftl、vm或jsp，分别对应FreeMarker、Velocity和JSP模板.>
<constantname="struts.ui.templateSuffix"value="ftl"/>

<!--该属性设置当struts.xml文件改变后，系统是否自动重新加载该文件.该属性的默认值是false.>
<constantname="struts.configuration.xml.reload"value="false"/>

<!--该属性指定Struts2应用所需要的国际化资源文件，如果有多份国际化资源文件，则多个资源文件的文件名以英文逗号(，)隔开.>
<constantname="struts.custom.i18n.resources"value="nationz"/>

<!--对于某些JavaEE服务器，不支持HttpServletRequest调用getParameterMap()方法，此时可以设置该属性值为true来解决该问题.
该属性的默认值是false.
对于WebLogic、Orion和OC4J服务器，通常应该设置该属性为true.>
<constantname="struts.dispatcher.parametersWorkaround"value="false"/>

<!--指定是否缓存FreeMarker模版.默认值false.>
<constantname="struts.freemarker.templatesCache"value="true"/>

<!--该属性只支持true和false两个属性值，默认值是true.通常无需修改该属性值.>
<constantname="struts.freemarker.wrapper.altMap"value="true"/>

<!--该属性指定XSLTResult是否使用样式表缓存.当应用处于开发阶段时，该属性通常被设置为true;当应用处于产品使用阶段时，
该属性通常被设置为false.>
<constantname="struts.xslt.nocache"value="false"/>

<!--该属性指定Struts2框架默认加载的配置文件，如果需要指定默认加载多个配置文件，则多个配置文件的文件名之间以英文逗号(，)隔开.
该属性的默认值为struts-default.xml，truts-plugin.xml，struts.xml，看到该属性值，所以应该明白为什么Struts2框架默认加载struts.xml文件了.>
<constantname="struts.configuration.files"value="struts-default.xml，struts-plugin.xml"/>

<!--设置映射器是否总是选择完整的名称空间.该属性的默认值时false.>
<constantname="struts.mapper.alwaysSelectFullNamespace"value="false"/>

<!--设置Convention插件定位视图资源的根路径.默认值为/WEB-INF/content>
<constantname="struts.convention.result.path"value="/WEB-INF/content/"/>

<!--Convention插件以该常量指定包作为根包>
<constantname="struts.convention.action.package"value="default"/>

<!--是否从包中搜索Action>
<constantname="struts.convention.action.disableScanning"value="false"/>

<!--官方只说明在jboss下需要设置，情况不明-->
<constantname="struts.convention.exclude.parentClassLoader"value="true"/>
<constantname="struts.convention.action.fileProtocols"value="jar，zip"/>

<!--包括哪些jar包中的action.逗号分割字符串.>
<constantname="struts.convention.action.includeJars"value=".*?/_wl_cls_gen.*?jar(!/)?"/>

<!--确定搜索包的路径.只要是结尾为action的包都要搜索.>
<constantname="struts.convention.package.locators"value="action"/>

</struts>

Struts2-常用的constant总结

见注释

<?xmlversion="1.0"encoding="UTF-8"?>
<!DOCTYPEstrutsPUBLIC
"-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.3//EN"
"http://struts.apache.org/dtds/struts-2.3.dtd">

<struts>

<!--把它设置为开发模式，发布时要设置为false-->
<constantname="struts.devMode"value="true"/>
<!--设置在class被修改时是否热加载，发布时要设置为false-->
<constantname="struts.convention.classes.reload"value="true"/>
<!--自动动态方法的调用，使用这个设置后可以这样调用：action!method-->
<constantname="struts.enable.DynamicMethodInvocation"value="true"/>
<!--指定jsp文件所在的目录地址-->
<constantname="struts.convention.result.path"value="/WEB-INF/content/"/>
<!--使用struts-default默认的转换器，如果是rest的使用：rest-default，rest需要rest的jar插件-->
<constantname="struts.convention.default.parent.package"value="struts-default"/>
<!--用于配置包名后缀。默认为action、actions、struts-->
<constantname="struts.convention.package.locators"value="actions"/>
<!--用于配置类名后缀，默认为Action，设置后，Struts2只会去找这种后缀名的类做映射-->
<constantname="struts.convention.action.suffix"value="Action"/>
<!--设置即使没有@Action注释，依然创建Action映射。默认值是false。因为Convention-Plugin是约定优于配置的风格，
可以不通过注解根据预先的定义就能访问相应Action中的方法-->
<constantname="struts.convention.action.mapAllMatches"value="true"/>
<!--自定义jsp文件命名的分隔符-->
<constantname="struts.convention.action.name.separator"value="-"/>
<!--国际化资源文件名称-->
<constantname="struts.custom.i18n.resources"value="i18n"/>
<!--是否自动加载国际化资源文件-->
<constantname="struts.i18n.reload"value="true"/>
<!--浏览器是否缓存静态内容-->
<constantname="struts.serve.static.browserCache"value="false"/>
<!--上传文件大小限制设置-->
<constantname="struts.multipart.maxSize"value="-1"/>
<!--主题，将值设置为simple，即不使用UI模板。这将不会生成额外的html标签-->
<constantname="struts.ui.theme"value="simple"/>
<!--编码格式-->
<constantname="struts.i18n.encoding"value="UTF-8"/>

</struts>

基础Constants

struts.devMode可选值true,false（默认false），在开发模式下，struts2的动态重新加载配置和资源文件的功能会默认生效。同时开发模式下也会提供更完善的日志支持。
struts.i18n.reload可选值true,false（默认值依赖于struts.devMode），是否自动重新加载本地的资源文件。
struts.i18n.encoding主要用于设置请求编码（默认值（UTF-8）），Head和Include标签的解析编码。资源和配置文件的解析编码。
struts.configuration.xml.reload可选值true,false（默认值依赖于struts.devMode）是否自动重新加载XML配置文件
struts.action.extension设置struts的Action请求的后缀，支持多个时以逗号隔开。
struts.action.excludePattern设置struts所排除的url（通过正则表达式匹配）（支持多个，以逗号隔开）
struts.tag.altSyntax可选值true，false（默认true）是否支持ognl表达式
struts.url.http.port设置生成URL所对应的http端口
struts.url.https.port设置生成URL所对应的https端口
struts.url.includeParams可选值none,get,all(默认get)，设置URL是否包含参数，以及是否只包含GET方式的参数。
struts.locale设置struts2默认的locale，决定使用哪个资源文件。
struts.ui.templateDir该属性指定视图主题所需要模板文件的位置，该属性的默认值是template，即默认加载template路径下的模板文件
struts.ui.theme该属性指定视图标签默认的视图主题，该属性的默认值是xhtml。
struts.ui.templateSuffix该属性指定模板文件的后缀，该属性的默认属性值是ftl。该属性还允许使用ftl、vm或jsp，分别对应FreeMarker、Velocity和JSP模板
struts.multipart.saveDir设置上传临时文件的默认目录
struts.multipart.maxSize设置上传的临时文件的最大限制
struts.objectFactory.spring.autoWire可选值（name,type,auto,constructor,name）（默认name），设置spring的自动装配方式，只有引入spring插件后才有效。
struts.objectFactory.spring.autoWire.alwaysRespect（默认false）设置是否总是以自动装配策略创建对象。
struts.objectFactory.spring.useClassCache（默认false）对象工厂是否使用类缓存，开发模式无效。
struts.xslt.nocache（默认为false）设置XsltResult是否不是用缓存。
struts.custom.properties设置用户的自定义属性文件名列表（用，隔开）
struts.custom.i18n.resources设置用户自定义的资源文件路径列表（用，隔开）
struts.serve.static（默认false）设置是否支持静态资源请求（要求url在struts或static下）
struts.serve.static.browserCache（默认false）是否在静态资源响应中设置缓存。只有在支持静态资源时有效。
struts.el.throwExceptionOnFailure（默认false）是否在解析el表达式或无法找到属性时抛出RuntimeException
struts.ognl.logMissingProperties（默认false）是否日志无发找到的属性
struts.ognl.enableExpressionCache是否缓存ognl解析的表达式。
struts.enable.DynamicMethodInvocation（默认false）是否支持动态的方法调用,在URL上通过!method指定方法。
struts.enable.SlashesInActionNames在URL中的Action段中是否支持斜线
struts.mapper.alwaysSelectFullNamespace（默认false）是否总是用最后一个斜线前的URL段作为namespace
核心对象Constants

struts.actionProxyFactory设置ActionProxy的实体工厂，该工厂同时也生成默认的ActionInvoctation
struts.xworkConverter设置XWorkConverter对象，该对象用于获取各种类型的转换器。
struts.unknownHandlerManager设置UnknownHandlerManager的实现类，用于处理无法找到方法等异常。
struts.multipart.handler设置mutipartRequest的handler（默认是jakarta）对应类，org.apache.struts2.dispatcher.multipart.JakartaMultiPartRequest
struts.mapper.class可选值（struts，composite，restful，restful2）设置URL解析且映射到ACTION的实现，（默认struts）.
struts.mapper.prefixMapping通过URL前缀映射到对应的Mapper，格式为urlPrefix1:mapperName2,urlPrefix2:mapperName2。必须添加mapperClass为org.apache.struts2.dispatcher.mapper.PrefixBasedActionMapper，并指定struts.mapper.class为该mapper。
struts.mapper.composite设置是否支持复合（多个）actionMapper，mapperName用逗号隔开。必须配置struts.mapper.class为composite才会生效
struts.mapper.idParameterName用于Restful2ActionMapper作为URL中id所对应的parameterName
struts.ognl.allowStaticMethodAccess（默认false）设置ognl表达式是否支持静态方法。
struts.configuration设置struts2的Settings类。（2.1.2后不再使用）
struts.urlRenderer设置struts2的URLrender（用于生成的URL），（默认struts），类名org.apache.struts2.components.ServletUrlRenderer
struts.objectFactory设置struts2的对象工厂，默认（struts），类名org.apache.struts2.impl.StrutsObjectFactory，当引入struts2-spring插件之后，则被修改为org.apache.struts2.spring.StrutsSpringObjectFactory
struts.xworkTextProvider设置struts2的资源文件内容提供类的实现。默认为com.opensymphony.xwork2.TextProviderSupport
struts.actionValidatorManager设置ActionValidatorManager的实现类。
struts.valueStackFactory设置struts2的ValueStack工厂的实现。
struts.reflectionProvider设置ReflectionProvider的实现类
struts.reflectionContextFactory设置ReflectionContextFactory的实现类
struts.patternMatcher设置PatternMatcher的实现类
struts.staticContentLoader设置StaticContentLoader的实现类

Struts 2中的constant配置详解

热门推荐

随机推荐