### Struts `struts
.xml` 文件配置详解
#### 基本结构
`struts
.xml` 是 Struts2 的核心配置文件，用于定义框架的行为
和组件之间的交互逻辑。它是一个
XML 文档，遵循特定的 DTD 定义[^1]。
以下是 `struts
.xml` 文件的基本结构：
```
xml
<struts>
<!
-- 包括其他配置文件
-->
<include file="other
-config
-file
.xml"/>
<!
-- 定义全局常量
-->
<constant name="struts
.devMode" value="true"/>
<!
-- 定义包
-->
<package name="default" namespace="/" extends="struts
-default">
<!
-- 动作映射
-->
<action name="login" class="com
.example
.actions.LoginAction">
<result name="success">/welcome
.jsp</result>
<result name="error">/login
.jsp</result>
</action>
</package>
</struts>
```
---
#### `<include>` 元素
为了提高配置管理的灵活性，可以使用 `<include>` 元素将多个配置文件组合到一起。这样做的好处是可以将不同的功能模块分开维护，便于团队协作开发[^4]。
示例代码如下：
```
xml
<struts>
<include file="struts
-user
.xml"/>
<include file="struts
-admin
.xml"/>
<include file="common/configs/struts
-security
.xml"/>
</struts>
```
上述代码表示加载了三个外部配置文件：`struts
-user
.xml`、`struts
-admin
.xml`
和位于子目录下的 `struts
-security
.xml`[^2]。
---
#### `<constant>` 元素
通过 `<constant>` 可以设置 Struts2 框架运行时的各种参数。常见的配置项包括：
- **`struts
.devMode`**: 开发模式开关，启用后会显示更多调试信息。
- **`struts
.i18n
.encoding`**: 设置请求编码，默认为 UTF
-8。
- **`struts
.custom.i18n
.resources`**: 加载国际化资源文件。
示例：
```
xml
<constant name="struts
.devMode" value="false"/>
<constant name="struts
.i18n
.encoding" value="UTF
-8"/>
<constant name="struts
.custom.i18n
.resources" value="global
-messages"/>
```
---
#### `<package>` 元素
`<package>` 用于分组动作（
Actions），并继承默认行为或其他自定义行为。其主要属性包括：
- **`name`**: 包名，唯一标识符。
- **`namespace`**: URL 名称空间，区分不同模块的动作。
- **`extends`**: 继承父包名称，通常为 `struts
-default` 或其他自定义包。
示例：
```
xml
<package name="example
-package" namespace="/example" extends="struts
-default">
<action name="register" class="com
.example
.RegisterAction">
<result name="input">/register
.jsp</result>
<result name="success">/confirmation
.jsp</result>
</action>
</package>
```
---
#### `<action>` 元件
`<action>` 映射客户端请求到具体的 Action 类，并定义返回结果页面。常见属性包括：
- **`name`**: 请求路径中的动作名称。
- **`class`**: 对应的 Java Action 类。
- **`method`**: 调用的具体
方法（可选，默认调用 execute
方法）。
示例：
```
xml
<action name="logout" class="com
.security
.LogoutAction" method="performLogout">
<result name="redirect">/index
.jsp</result>
</action>
```
---
#### Form Bean 配置
虽然 Struts2 已经不再强制使用传统的 Form Bean 设计模式，但在某些场景下仍然可以通过 `<form
-beans>` 来声明表单对象[^5]。
示例：
```
xml
<form
-beans>
<form
-bean name="UserForm" type="com
.forms
.UserForm"/>
</form
-beans>
```
---
#### 默认配置文件
除了开发者手动编写的 `struts
.xml` 外，Struts2 还提供了一个内置的核心配置文件 `struts
-default
.xml`，存储于 JAR 包中。此文件定义了许多基础插件
和服务，因此大多数情况下无需重新编写这些部分[^3]。
---
本文详细介绍了如何通过API访问custom-actions.xml和custom-actionmodel.xml文件，涉及jar包、包路径、NmActionService服务接口、StandardNmActionService实现类以及NmActionServiceHelper工厂类等内容。
扫一扫
569
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
