Struts2核心配置文件“struts.properties”文件的配置

Struts 2 框架除了struts.xml 配置文件之外，还有另外一个核心配置文件，即" struts.properties "。struts.xml 文件主要负责管理 Struts 2 的 Action 映射以及 Result 等，而struts.properties 文件则用于配置 Struts 2 中所需的大量的属性（当然这些属性中有很多也可以在 struts.xml 文件中配置）。

struts.properties 文件是一个标准的属性文件，该文件包含了大量的 key - value 对，每个 key  就是一个 Struts 2 属性，该 key 对应的 value 就是 Struts 2 的一个属性值

struts.properties 文件一般放在 WEB-INF\classes 目录中，或将其放在Web应用程序的 CLASSPATH 路径下，如果将其放在这些路径下，Struts 2 框架就可以找到struts.properties，并装载这个文件。

struts.properties 文件中有很多 key - value 对，而且有很多 key - value 对都有其默认值。

• struts.configuration：该属性置顶加载 Struts 2 配置文件的配置管理器。默认值是 org.apache.struts2.config.DefaultConfiguration，这是 Struts 2 默认的配置管理器。如果要实现自己的配置管理器，可以编写一个实现 com.opensymphony.xwork2.config.Configuration 接口的类，并在该类中进一步处理 Struts 2 的配置信息。
• struts.locale：指定了Web应用程序默认的 locate和encoding scheme，默认值是 en_US 。
• struts.i18n.encoding：指定了Web应用程序的默认编码集，正确地设置该属性可以解决客户端请求的中文编码问题。该属性的默认值是 UTF - 8，因此，如果Web应用程序采用了 UTF - 8 格式，在请求中的中文就会以 UTF - 8 格式进行编码。如果设置了这个属性值（如设成GBK），就相当于调用了 HttpServletRequest 类的setCharacterEncoding方法。
• struts.objectFactory.spring.autoWire：指定 Spring 框架的自动装配模式，该属性的默认值是 name ，也就是说，在默认情况下，Spring 是根据 name 属性自动装配的。该属性可以取的值是 name 、type 、auto 和 constructor。
• struts.objectFactory.spring.useClassCache：指定在整合 Spring 框架时，是否缓存 Bean 的实例，该属性只允许设置 false 和 true，默认值是 true。（不建议改变此属性的值，除非确实有必要改变）
• struts.objectTypeDeterminer：指定了Struts  2的类型检测机制，该属性可以设置为 tiger 或 notiger ，也可以设置成实现com.opensymphony.xwork2.util.ObjectTypeDeterminer 接口的类。Struts 2 默认情况下使用 com.opensymphony.xwork2.util.DefaultObjectTypeDeterminer 类来处理类型检测。
• struts.multipart.parser：指定了处理 multipart / form - data 的 MIME 类型请求框架，该属性支持 cos、pell 和 jakarta，即分别对应于 cos 的文件上传框架、pell 文件上传框架common - fileupload 文件上传框架。该属性的默认值是 jakarta。
• struts.multipart.saveDir：指定了保存上传文件的临时路径，该属性的默认值是 javax.servlet.context.tempdir 属性所指的路径。
• struts.multipart.maxSize：该属性指定了 Struts2 允许的伤处啊年文件最大的字节数（所有上传文件的字节数之和），默认值是2097152，也就是2MB。
• struts.custom.properties：指定了 Struts 2 架载的用户自定义属性文件，该自定义属性文件指定的属性不会覆盖 struts.properties 文件中预定义的属性，因此，在自定义属性文件中只能设置用户新添加的自定义属性。如果有多个自定义属性文件，中间用逗号（,）分隔。
• struts.mapper.class：指定将 HTTP 请求映射到指定 Action 的映射器， Struts 2 提供了一个默认的映射器 ort.apache.struts2.dispatcher.mapper.DefaultActionMapper ，这个类也是该属性默认值。该映射器会根请求 URL 的前缀来匹配相应的 Action 的 name 属性来完成映射。
• struts.action.extension：该属性指定了由 Struts 2 处理的请求 URL 的后缀，默认值是 action ，即所有请求 URL 的后缀为 action 的请求都交由 Struts 2 来处理。如果用户要指定多个请求后缀，中间用逗号（,）隔开。
• strtus.serve.static：该属性设置是否从 jar 文件中获得静态内容服务，该属性只支持 true 和 false，默认值是 true。
• struts.serve.static.browserCache：该属性设置了浏览器是否缓存静态内容，但要注意，改属性只有在 struts.serve.static属性为 true 时才有效。该属性只支持 true 和 false 。默认值为 ture 。如果该属性值为 true ， Struts 2 会设置一些 HTTP 响应头（如 Date、Cache - Content 、Expires）来使浏览器混村静态内容。如果该属性值为false， Struts 2 也会通过一些HTTP响应头来关闭浏览器的缓存功能。
• struts.enable.DynamicMethodInvocation：该属性设置了 Struts 2 是否支持动态方法调用，默认值是 true 。
• struts.enable.SlashesInActionNames：该属性设置了 Struts 2 是否允许在 Action 名中使用斜杠（/），默认值是 false 。 
• struts.tag.altSyntax：该属性指定是否允许在 Struts 2 标签中使用表示式语法，默认值是 true 。
• struts.devMode：该属性指定 Struts 2 是否使用开发模式， 默认值是 false 。如果该属性值为 true ，则会显示出更多、更友好的提示信息。在开发阶段，一般将该属性设置为 true 。
• struts.i18n.reload：该属性指定在 HTTP 请求达到时， 是否每次都装载资源文件，默认值是 false 。在开发阶段，也将属性设置为 true 会更方便开发。
• struts.ui.theme：该属性指定了 UI 标签的默认视图主题。该属性的默认值是 xhtml 。 
• struts.ui.templateDir：该属性指定了视图主题所使用模板文件的位置，默认值是 template，默认加载 template 路径下的模板文件。
• struts.ui.templateSuffix：该属性指定了模板文件的后缀，该属性的默认值是 ftl 。该属性还允许使用 vm 和 jsp 。 ftl、vm 和 jsp分别对应 FreeMarker、Velocity  和 JSP 模板。
• struts.configuration.xml.reload：该属性指定了在 struts.xml 文件的内容改变后，系统是否会自动重新加载该文件。该属性默认值是 false。
• struts.velocity.configfile：该属性指定了 Velocity 框架所使用的 velocity.properties 文件的位置。该属性的默认值是 velocity.properties。
• struts.velocity.contexts：该属性制定了 Velocity 框架的Context，如果该框架有多个 Context，则中间用逗号 (,)分隔。
• struts.velocity.toolboxlocation：该属性指定了 Velocity 框架的 toolbox 的位置。
• struts.url.http.port：该属性指定了 Web 应用程序所使用的监听端口。该属性的默认值是80。该属性一般在使用 Struts2 URL 标签建立 URL 时使用。
• struts.url.https.port：该属性类似于 struts.url.http.port，区别是该属性设置的是 https 协议的监听端口。该属性的默认值是443。
• struts.url.includeParams：该属性制定了 Struts2 在生成URL时是否包含请求参数。该属性只支持note、get 和 all ，分别对应于不包含、只包含 GET 类型的请求参数和包含所有的请求参数
• struts.custom.i18n.resources：该属性制定了 Struts2 所使用的国际化资源文件，如果有多个资源文件，中间用逗号( , )分隔。
• struts.dispatcher.parametersWorkaround：如果某些JavaEE服务器不支持 HttpServletRequest 类的 getParameterMap 方法（如 WebLogic、Orion 和 OC4J），在这种情况下，该需要将该属性值的默认值是 org.apache.struts2.views.freemarker.FreemarkerManager，这是 Struts2 内建的 FreeMarker 管理器。
• struts.freemarker.templatesCache：指定是否打开 FreeMarker 模板的缓存。如果该属性值为 true，就相当于将模板复制到 WEB_APP/templates 路径下。该属性的默认值是 false。
• struts.freemarker.beanwrapperCache：该属性指定是否打开 BeanWrapper 上的模型的缓存。默认值是 false。
• struts.freemarker.wrapper.altMap：该属性只支持 true 和 false 两个属性值，默认值是 true。这个属性值一般不需要修改。
• struts.xslt.nocache：该属性指定 XSLTResult 类是否使用样式表缓存，如果出于开发阶段，一般将该属性设为 true。该属性的默认值是 false。
• struts.configuration.files：该属性指定了 Struts2 自动装载的配置文件列表。如果有多个配置文件，中间使用逗号 ( , )分隔。该属性的默认值是 struts-default.xml，struts-plugin.xml， struts.xml。struts 2 会自动装载 struts-default.xml、struts-plugin.xml 和 struts.xml 。
• struts.mapper.alwaysSelectFullNamespace：该属性指定是否一直在最后一个斜线 ( / )之前的任何位置选定 namespace ， 默认值是 false

除了在 struts.properties 文件中配置 Struts2 属性外，还可以通过 struts.xml配置文件的常量来配置 Struts 2 属性。

(-------------------------------------------------------------------原内容来自 《Java Web开发应用详解 (独门架构)(李  宁) 》--------------------------------------------------------------)