struts2中struts.xml配置文件

发布时间 2023-03-27 15:15:07作者: YorkShare

1.struts2.xml文件有什么用(原文链接:https://blog.csdn.net/qq_40247570/article/details/121691396)

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

struts.xml 文件通常放在 Web 应用的 WEB-INF/classes 目录下,在该目录下的 struts.xml 文件可以被 Struts2 框架自动加载。由于 MyEclipse 开发工具在编译时会自动将 src 路径下的 struts.xml 文件编译后放到 WEB-INF/classes 路径下,所以直接将其放到项目的 src 路径下即可。
2.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>
    <!-- 所有匹配*.action的请求都由struts2处理 -->
    <constant name="struts.action.extension" value="action" />
    <!-- 是否启用开发模式 -->
    <constant name="struts.devMode" value="true" />
    <!-- struts配置文件改动后,是否重新加载 -->
    <constant name="struts.configuration.xml.reload" value="true" />
    <!-- 设置浏览器是否缓存静态内容 -->
    <constant name="struts.serve.static.browserCache" value="false" />
    <!-- 请求参数的编码方式 -->
    <constant name="struts.i18n.encoding" value="utf-8" />
    <!-- 每次HTTP请求系统都重新加载资源文件,有助于开发 -->
    <constant name="struts.i18n.reload" value="true" />
    <!-- 文件上传最大值 -->
    <constant name="struts.multipart.maxSize" value="104857600" />
    <!-- 让struts2支持动态方法调用 -->
    <constant name="struts.enable.DynamicMethodInvocation" value="true" />
    <!-- Action名称中是否还是用斜线 -->
    <constant name="struts.enable.SlashesInActionNames" value="false" />
    <!-- 允许标签中使用表达式语法 -->
    <constant name="struts.tag.altSyntax" value="true" />
    <!-- 对于WebLogic,Orion,OC4J此属性应该设置成true -->
    <constant name="struts.dispatcher.parametersWorkaround" value="false" />

    <package name="basePackage" extends="struts-default">
    </package>

</struts>
<?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> <!-- include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 --> <include file="struts-default.xml"></include> <!-- package提供了将多个Action组织为一个模块的方式 package的名字必须是唯一的 package可以扩展 当一个package扩展自 另一个package时该package会在本身配置的基础上加入扩展的package 的配置 父package必须在子package前配置 name:package名称 extends:继承的父package名称 abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false namespace:定义package命名空间 该命名空间影响到url的地址,例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action --> <package name="com.kay.struts2" extends="struts-default" namespace="/test"> <interceptors> <!-- 定义拦截器 name:拦截器名称 class:拦截器类路径 --> <interceptor name="timer" class="com.kay.timer"></interceptor> <interceptor name="logger" class="com.kay.logger"></interceptor> <!-- 定义拦截器栈 --> <interceptor-stack name="mystack"> <interceptor-ref name="timer"></interceptor-ref> <interceptor-ref name="logger"></interceptor-ref> </interceptor-stack> </interceptors> <!-- 定义默认的拦截器 每个Action都会自动引用 如果Action中引用了其它的拦截器 默认的拦截器将无效 --> <default-interceptor-ref name="mystack"></default-interceptor-ref> <!-- 全局results配置 --> <global-results> <result name="input">/error.jsp</result> </global-results> <!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同) name:action名称 class: 对应的类的路径 method: 调用Action中的方法名 --> <action name="hello" class="com.kay.struts2.Action.LoginAction"> <!-- 引用拦截器 name:拦截器名称或拦截器栈名称 --> <interceptor-ref name="timer"></interceptor-ref> <!-- 节点配置 name : result名称 和Action中返回的值相同 type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher --> <result name="success" type="dispatcher">/talk.jsp</result> <!-- 参数设置 name:对应Action中的get/set方法 --> <param name="url">http://www.sina.com</param> </action> </package> </struts>

元素说明:

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

3.常量的配置的三种方式
(1)在 struts.xml 文件中使用 <constant> 元素配置常量(常用方式)。
(2)在 struts.properties 文件中配置常量。
(3)在 web.xml 文件中通过 <init-param> 元素配置常量。
其中,在 struts.xml 文件中通过元素配置常量,是项目开发时最常用的方式,在 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 框架加载常量是有一定顺序的,通常的搜索顺序如下。

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

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

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

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

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

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

4.包配置

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

<package name="default" namespace="/" extends="struts-default">
    ...
</package>

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

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

5.包含配置

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

在 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 文件通过 元素包含了四个配置文件,其中 file 属性用于指定被包含配置文件的名称。如果被包含的配置文件在 src 路径下,则直接指定文件名即可,如果被包含的配置文件在具体的包中,则需要引入被包含文件的包路径。

需要注意的是,每一个被包含的配置文件都是标准的 Struts2 配置文件,同样包含 DTD 信息、Struts2 配置文件的根元素等信息。由于 struts.xml 文件包含了其他的配置文件,所以在 Struts2 框架自动加载 struts.xml 文件时,就会完成所有配置信息的加载。
————————————————
版权声明:本文为CSDN博主「EOPG」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/qq_40247570/article/details/121691396