Struts2配置文件详解2

出自： http://blog.csdn.net/u014236541/article/details/49247997

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts PUBLIC     "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"     "http://struts.apache.org/dtds/struts-2.3.dtd"> <struts>     <!-- 把它设置为开发模式，发布时要设置为false -->     <constant name="struts.devMode" value="true" />     <!-- 设置在class被修改时是否热加载，发布时要设置为false -->     <constant name="struts.convention.classes.reload" value="true"/>     <!-- 自动动态方法的调用，使用这个设置后可以这样调用：action!method -->     <constant name="struts.enable.DynamicMethodInvocation" value="true" />     <!-- 指定jsp文件所在的目录地址 -->     <constant name="struts.convention.result.path" value="/WEB-INF/content/" />     <!-- 使用struts-default默认的转换器，如果是rest的使用：rest-default，rest需要rest的jar插件 -->     <constant name="struts.convention.default.parent.package" value="struts-default"/>     <!-- 用于配置包名后缀。默认为action、actions、struts-->     <constant name="struts.convention.package.locators" value="actions" />     <!-- 用于配置类名后缀，默认为Action，设置后，Struts2只会去找这种后缀名的类做映射 -->     <constant name="struts.convention.action.suffix" value="Action"/>     <!-- 设置即使没有@Action注释，依然创建Action映射。默认值是false。因为Convention-Plugin是约定优于配置的风格，         可以不通过注解根据预先的定义就能访问相应Action中的方法 -->     <constant name="struts.convention.action.mapAllMatches" value="true"/>     <!-- 自定义jsp文件命名的分隔符 -->     <constant name="struts.convention.action.name.separator" value="-" />     <!-- 国际化资源文件名称 -->     <constant name="struts.custom.i18n.resources" value="i18n" />     <!-- 是否自动加载国际化资源文件  -->     <constant name="struts.i18n.reload" value="true" />     <!-- 浏览器是否缓存静态内容 -->     <constant name="struts.serve.static.browserCache" value="false" />      <!-- 上传文件大小限制设置 -->     <constant name="struts.multipart.maxSize" value="-1" />     <!-- 主题，将值设置为simple，即不使用UI模板。这将不会生成额外的html标签 -->     <constant name="struts.ui.theme" value="simple" />     <!-- 编码格式 -->     <constant name="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表达式或无法找到属性时抛出RuntimeExceptionstruts.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的实体工厂，该工厂同时也生成默认的ActionInvoctationstruts.xworkConverter 设置XWorkConverter对象，该对象用于获取各种类型的转换器。struts.unknownHandlerManager 设置UnknownHandlerManager的实现类，用于处理无法找到方法等异常。struts.multipart.handler  设置mutipartRequest的handler （默认是jakarta）对应类，org.apache.struts2.dispatcher.multipart.JakartaMultiPartRequeststruts.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所对应的parameterNamestruts.ognl.allowStaticMethodAccess （默认false）设置ognl表达式是否支持静态方法。struts.configuration 设置struts2的Settings类。（2.1.2后不再使用）struts.urlRenderer 设置struts2的URL render（用于生成的URL），（默认struts），类名org.apache.struts2.components.ServletUrlRendererstruts.objectFactory 设置struts2的对象工厂，默认（struts），类名org.apache.struts2.impl.StrutsObjectFactory，当引入struts2-spring插件之后，则被修改为org.apache.struts2.spring.StrutsSpringObjectFactorystruts.xworkTextProvider 设置struts2的资源文件内容提供类的实现。默认为com.opensymphony.xwork2.TextProviderSupportstruts.actionValidatorManager 设置ActionValidatorManager 的实现类。struts.valueStackFactory 设置struts2的ValueStack工厂的实现。struts.reflectionProvider 设置ReflectionProvider的实现类struts.reflectionContextFactory 设置ReflectionContextFactory的实现类struts.patternMatcher 设置PatternMatcher的实现类struts.staticContentLoader 设置StaticContentLoader的实现类 例子：、

<? xml version = "1.0" encoding = "UTF-8" ?> < ! DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd" > < struts > < ! --指定 Web应用的默认编码集 .该属性对于处理中文请求参数非常有用，对于获取中文请求参数值，应该将该属性值设置为 GBK或者 GB2312            提示 :当设置该参数为 GBK时，相当于调用 HttpServletRequest的 setCharacterEncoding方法 > < constant name = "struts.i18n.encoding" value = "UTF-8" / >   < ! --指定 Struts2默认的 ObjectFactory Bean，该属性默认值是 spring . > < constant name = "struts.objectFactory" value = "spring" / >   < ! --指定 Spring框架的自动装配模式，该属性的默认值是 name，即默认根据 Bean的 name属性自动装配 . > < constant name = "struts.objectFactory.spring.autoWire" value = "name" / >   < ! --该属性指定整合 Spring框架时，是否缓存 Bean实例，该属性只允许使用 true和 false两个属性值，它的默认值是 true .通常不建议修改该属性值 . > < constant name = "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路径下 . > < constant name = "struts.multipart.parser" value = "jakarta" / >   < ! --该属性指定上传文件的临时保存路径，该属性的默认值是 javax . servlet . context . tempdir . > < constant name = "struts.multipart.saveDir" value = "" / >   < ! --该属性指定 Struts 2文件上传中整个请求内容允许的最大字节数 . > < constant name = "struts.multipart.maxSize" value = "1000000000000" / >   < ! --该属性指定需要 Struts 2处理的请求后缀，该属性的默认值是 action，即所有匹配 * . action的请求都由 Struts 2处理 . 如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号 (， )隔开 . > < constant name = "struts.action.extension" value = "do" / >   < ! --该属性设置是否通过 JAR文件提供静态内容服务，该属性只支持 true和 false属性值，该属性的默认属性值是 true . > < constant name = "struts.serve.static" value = "true" / >   < ! --该属性设置浏览器是否缓存静态内容 .当应用处于开发阶段时，我们希望每次请求都获得服务器的最新响应，则可设置该属性为 false . > < constant name = "struts.serve.static.browserCache" value = "true" / >   < ! --该属性设置 Struts 2应用是否使用开发模式 .如果设置该属性为 true，则可以在应用出错时显示更多、更友好的出错提示 . 该属性只接受 true和 flase两个值，该属性的默认值是 false .通常，应用在开发阶段，将该属性设置为 true，当进入产品发布阶段后，则该属性设置为 false . > < constant name = "struts.devMode" value = "false" / >   < ! --该属性设置是否每次 HTTP请求到达时，系统都重新加载资源文件 (允许国际化文件重载 ) .该属性默认值是 false . 在开发阶段将该属性设置为 true会更有利于开发，但在产品发布阶段应将该属性设置为 false . 提示 :开发阶段将该属性设置了 true，将可以在每次请求时都重新加载国际化资源文件，从而可以让开发者看到实时开发效果 ; 产品发布阶段应该将该属性设置为 false，是为了提供响应性能，每次请求都需要重新加载资源文件会大大降低应用的性能 . > < constant name = "struts.i18n.reload" value = "false" / >   < ! --该属性指定视图标签默认的视图主题，该属性的默认值是 xhtml . > < constant name = "struts.ui.theme" value = "simple" / >   < ! --该属性指定模板文件的后缀，该属性的默认属性值是 ftl .该属性还允许使用 ftl、 vm或 jsp，分别对应 FreeMarker、 Velocity和 JSP模板 . > < constant name = "struts.ui.templateSuffix" value = "ftl" / >   < ! --该属性设置当 struts . xml文件改变后，系统是否自动重新加载该文件 .该属性的默认值是 false . > < constant name = "struts.configuration.xml.reload" value = "false" / >   < ! --该属性指定 Struts 2应用所需要的国际化资源文件，如果有多份国际化资源文件，则多个资源文件的文件名以英文逗号 (， )隔开 . > < constant name = "struts.custom.i18n.resources" value = "nationz" / >   < ! --对于某些 Java EE服务器，不支持 HttpServlet Request调用 getParameterMap ( )方法，此时可以设置该属性值为 true来解决该问题 . 该属性的默认值是 false . 对于 WebLogic、 Orion和 OC4J服务器，通常应该设置该属性为 true . > < constant name = "struts.dispatcher.parametersWorkaround" value = "false" / >   < ! --指定是否缓存 FreeMarker模版 .默认值 false . > < constant name = "struts.freemarker.templatesCache" value = "true" / >   < ! --该属性只支持 true和 false两个属性值，默认值是 true .通常无需修改该属性值 . > < constant name = "struts.freemarker.wrapper.altMap" value = "true" / >   < ! --该属性指定 XSLT Result是否使用样式表缓存 .当应用处于开发阶段时，该属性通常被设置为 true ;当应用处于产品使用阶段时， 该属性通常被设置为 false . > < constant name = "struts.xslt.nocache" value = "false" / >   < ! --该属性指定 Struts 2框架默认加载的配置文件，如果需要指定默认加载多个配置文件，则多个配置文件的文件名之间以英文逗号 (， )隔开 . 该属性的默认值为 struts - default . xml， truts - plugin . xml， struts . xml，看到该属性值，所以应该明白为什么 Struts 2框架默认加载 struts . xml文件了 . > < constant name = "struts.configuration.files" value = "struts-default.xml，struts-plugin.xml" / >   < ! --设置映射器是否总是选择完整的名称空间 .该属性的默认值时 false . > < constant name = "struts.mapper.alwaysSelectFullNamespace" value = "false" / >   < ! --设置 Convention插件定位视图资源的根路径 .默认值为 / WEB - INF / content > < constant name = "struts.convention.result.path" value = "/WEB-INF/content/" / > < ! -- Convention插件以该常量指定包作为根包 > < constant name = "struts.convention.action.package" value = "default" / > < ! --是否从包中搜索 Action > < constant name = "struts.convention.action.disableScanning" value = "false" / >        < ! -- 官方只说明在 jboss下需要设置，情况不明 -- > < constant name = "struts.convention.exclude.parentClassLoader" value = "true" / > < constant name = "struts.convention.action.fileProtocols" value = "jar，zip" / >   < ! --包括哪些 jar包中的 action .逗号分割字符串 . > < constant name = "struts.convention.action.includeJars" value = ".*?/_wl_cls_gen.*?jar(!/)?" / >   < ! --确定搜索包的路径 .只要是结尾为 action的包都要搜索 . > < constant name = "struts.convention.package.locators" value = "action" / > < / struts >

意思是 struts的action 由spring,进行实例化

struts.objectFactory这个属性用于说明Struts2的对象池创建工厂，Struts2也有自己的对象池，就像Spring那样，在配置文件中你可以引用对象池中的对象，你可以借助于Spring中的对象池，当想要得到Spring中的对象池时，申明struts.objectFactory为Spring的对象池构建工厂....

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

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

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

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

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

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

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

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

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

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