struts2 配置详解

基础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的URL render（用于生成的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的实现类