struts.xml配置文件详解

struts.xml 是 Struts2 框架的核心配置文件，该文件主要用于配置 Action 和请求的对应关系，以及配置逻辑视图和物理视图（逻辑视图就是在 struts.xml 文件中配置的 <result> 元素，它的 name 属性值就是逻辑视图名；物理视图是指 <result> 元素中配置的结果页面，如 JSP 文件）资源的对应关系。

struts.xml 文件通常放在 Web 应用的 WEB-INF/classes 目录下，在该目录下的 struts.xml 文件可以被 Struts2 框架自动加载。由于 MyEclipse 开发工具在编译时会自动将 src 路径下的 struts.xml 文件编译后放到 WEB-INF/classes 路径下，所以直接将其放到项目的 src 路径下即可。

下面来看一个典型的 struts.xml 文件结构，如下所示：

<?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>
    <!--<constant>元素用常量的配置-->
    <constant name="struts.enable.DynamicMethodInvocation" value="false" />
    <constant name="struts.devMode" value="true" />
    <!--<package>元素用于包配置-->
    <package name="default" namespace="/" extends="struts-default">
        <!--配置Action-->
        <action name="index" class="Xxx"/>
            <!--配置Result-->
            <result type="dispatcher">
                <param name="location">/index.jsp</param>
            </result>
        </action>
    </package>
    <!-- <include>元素用于包含配置 -->
    <include file="example.xml"/>
</struts>

在上述文件中，元素说明如下：

• <struts> 元素是文件的根元素，所有其他元素都放在 <struts></struts> 中。
• <constant> 元素用于进行常量配置。
• <package> 元素用于进行包配置，在 Struts2 框架中，包用于组织 Action 和拦截器等信息，每个包都是由零个或多个拦截器以及 Action 所组成的集合。
• <include> 元素用于在一个 struts.xml 配置文件中包含其他的配置文件。

下面，将分别针对这些常用的元素及其配置进行详细讲解。

常量配置

在使用 Struts2 框架开发的项目中，通常需要使用大量的常量，这些常量大多在默认的配置文件中已经配置好，但由于用户的需求不同，开发的要求也有所不同，这时可能就需要对这些常量值进行修改，其修改的方法就是在配置文件中对常量进行重新配置。

在 Struts2 中，常量的配置通常使用以下三种方式。

• 在 struts.xml 文件中使用 <constant> 元素配置常量（常用方式）。
• 在 struts.properties 文件中配置常量。
• 在 web.xml 文件中通过 <init-param> 元素配置常量。

上述三种配置方式中，在 struts.xml 文件中通过 <constant> 元素配置常量，是项目开发时最常用的方式，教程中的常量配置也是通过此种方式实现的，所以这里只介绍通过 <constant> 元素配置常量的方式，其他两种方式读者只需了解即可。

在 struts.xml 文件中通过 <constant.../> 元素配置常量时，需要指定两个必填的属性 name 和 value。其中 name 属性用于指定常量的常量名，value 属性用于指定常量的常量值。其配置的示例代码如下所示：

<struts>
    <!--设置默认编码集为UTF-8-->
    <constant name="struts.il8n.encoding" value="UTF-8" />
    <!--设置使用开发模式-->
    <constant name="struts.devMode" value="true" />
</struts>

在上述示例代码中，配置了常量 struts.i18n.encoding 和 struts.devMode。其中 struts.i18n.encoding 用于指定 Struts2 应用程序的默认编码集为 UTF-8，struts.devMode 用于指定项目使用的是开发模式。

Struts2 所支持的常量数量很多，在 struts2-core-2.3.37.jar 压缩文件的 org/apache/struts2 路径下有一个 default.properties 文件，该文件里为 Struts2 的所有常量都指定了默认值，读者可以通过查看该文件了解 Struts2 所支持的常量。

除了可以通过上述的三种方式配置常量以外，在 Struts2 内置的一些配置文件中也有对常量的配置。因此，如果在多个文件中配置了同一个 Struts2 常量，则 Struts2 框架加载常量是有一定顺序的，通常的搜索顺序如下。

1）default.properties：该文件保存在 struts2-core-2.3.37.jar 中的 org.apache.struts2 包中。

2）struts-default.xml：该文件保存在 struts2-core-2.3.37.jar 文件中。

3）struts-plugin.xml：该文件保存在 struts-Xxx-2.3.37.jar 等 Struts2 插件 JAR 包中。

4）struts.xml：该文件是 Web 应用自身的 Struts2 配置文件。

5）struts.properties：该文件是 Web 应用默认的 Struts2 配置文件。

6）web.xml：该文件是 Web 应用的配置文件。

上面指定了 Struts2 框架搜索 Struts2 常量的顺序，需要注意的是，如果在多个文件中配置了同一个 Struts2 常量，则后一个文件中配置的常量值会覆盖前面文件中配置的常量值。

包配置

在 Struts2 框架中，包用于管理 Action 和拦截器，每个包就是多个 Action、多个拦截器、多个拦截器引用的集合。在 struts.xml 文件中，使用 <package> 元素定义包配置，每个 <package> 元素都定义了一个包配置，其示例代码下所示：

在上述代码中，<package> 元素用到了三个关键属性 name、namespace、extends，具体说明如下。

• name：必填属性，用于指定该包的名称（该名称在配置文件中必须是唯一的），此名称是该包被其他包引用的 Key。
• namespace：可选属性，用于定义该包的命名空间。
• extends：可选属性，用于指定该包继承自其他包。其属性值必须是另一个包的 name 属性值，但该属性值通常都设置为 struts-default，这样该包中的 Action 就具有了 Struts2 框架默认的拦截器等功能。

包含配置

Struts2 允许将一个配置文件分解成多个配置文件，从而提高配置文件的可读性，<include> 元素用于在一个 struts.xml 配置文件中包含其他的配置文件。Struts2 默认只加载 WEB-INF/classes 下的 struts.xml 文件，一旦通过多个 XML 文件配置 Action，就必须通过 <include> 元素包含其他配置文件。

在 struts.xml 文件中包含配置的示例代码如下所示：

<struts>
    <!--不指定路径，默认在src下时的方式-->
    <include file="struts-post.xml"/>
    <include file="struts-user.xml"/>
    <include file="struts-dept.xml"/>
    <!--配置文件在具体包中时的方式-->
    <include file="com/mengma/action/struts-product.xml"/>
</struts>

在上述代码中，struts.xml 文件通过 <include> 元素包含了四个配置文件，其中 file 属性用于指定被包含配置文件的名称。如果被包含的配置文件在 src 路径下，则直接指定文件名即可，如果被包含的配置文件在具体的包中，则需要引入被包含文件的包路径。

需要注意的是，每一个被包含的配置文件都是标准的 Struts2 配置文件，同样包含 DTD 信息、Struts2 配置文件的根元素等信息。由于 struts.xml 文件包含了其他的配置文件，所以在 Struts2 框架自动加载 struts.xml 文件时，就会完成所有配置信息的加载。