Struts2 struts.xml package继承 配置Action包的extends属性

千涛同学_1100

千涛同学_1100

2026-02-15

814人浏览

原创

struts.xml中package的extends仅继承父包的interceptors、results等配置,不继承action标签;父包须设abstract="true",子包需自行定义action并正确配置namespace。

struts2 struts.xml package继承 配置action包的extends属性

struts.xml 里 package 的 extends 属性到底继承什么

它只继承父 package 声明的 interceptors、results、global-results、global-exception-mappings 和 default-interceptor-ref,不继承 action 标签本身——子包必须自己定义 action。

常见错误是以为写了 extends="base" 就能直接用父包里定义的 ,结果 404。Struts2 不支持 action 级别的继承,只有配置结构复用。

  • 父包必须设 abstract="true" 才能被继承(否则启动报错 Package [xxx] cannot be extended)
  • 父包里定义的 或自定义拦截器栈,子包可直接引用名字,不用重复声明
  • 如果子包也声明了同名 (比如 name="success"),会覆盖父包的定义,不是合并

为什么 extends="struts-default" 是几乎每个 package 的标配

因为 struts-default 是 Struts2 自带的抽象包,它预定义了最常用的拦截器栈 defaultStack、JSON/REST 相关 result 类型、常用异常映射等。不继承它,你的 action 默认连参数绑定、字段验证、类型转换都失效。

典型现象:action 方法执行了,但 String username 始终为 null,或者表单提交后页面空白没跳转——大概率是忘了 extends="struts-default" 或误写成 extends="default"(后者不存在)。

  • 检查拼写:struts-default 中间是短横线,不是下划线或空格
  • 不能写成 extends="struts-default, json-default":Struts2 不支持多继承,只能单继承,如需 JSON 支持,应继承 json-default(它自己已继承 struts-default)
  • 自定义拦截器栈若依赖 defaultStack 里的拦截器(比如 params),就必须确保父包最终链到 struts-default

多个 package 继承同一父包时,interceptor 栈会不会冲突

不会。每个 package 的 interceptor-ref 是独立解析的,即使都引用 defaultStack,运行时也是各自创建拦截器实例链,互不影响。

真正容易出问题的是:在父包里改了 defaultStack 的定义(比如删掉 validation 拦截器),所有继承它的子包都会受影响——这不是冲突,是预期中的传递性变更。

  • 调试技巧:启动时加 JVM 参数 -Dstruts.devMode=true,访问 /struts/ 路径可查看所有 package 和拦截器栈展开结构
  • 避免在父包中重定义 defaultStack,如需定制,建议新建栈名(如 myStack),用 显式组装
  • 如果子包要临时禁用某个拦截器(比如登录 action 不需要验证),应在 action 级用 替代全局引用

extends 配置生效但 action 找不到,可能卡在哪几个地方

最常忽略的是命名空间(namespace)和路径匹配逻辑。Struts2 匹配 action 时,是“先找 namespace 匹配的 package,再在该 package 内找 action name”,extends 只影响配置复用,不改变查找路径。

例如:父包 name="base"、namespace="/api",子包 name="user"、namespace="/api/v2"、extends="base"。此时子包里的 对应 URL 是 /api/v2/list.action,不是 /api/list.action。

  • 检查 namespace 是否以 / 开头(不加会变成相对命名空间,行为难预测)
  • 确认请求 URL 的路径前缀和 package 的 namespace 完全一致(包括末尾斜杠)
  • 用 struts.devMode=true 查看控制台日志,搜索 Unable to find action,它会打印出 Struts2 实际尝试匹配的 package 名和 action 名
  • 不要在子包里漏写 namespace:如果不写,它默认是 ""(根命名空间),和父包的 /api 完全无关

Struts2 的 extends 是静态配置复用机制,不是面向对象继承;它不解决 action 复用,也不绕过命名空间隔离——这两点最容易让人反复踩坑。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2195

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3482

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1156

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3999

7

struts框架介绍
struts框架介绍

本专题介绍了struts框架相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.06

3957

8

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

6799

3

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

549

3

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

2024.03.01

1698

6

go语言 面向对象
go语言 面向对象

本专题整合了go语言面向对象相关内容,阅读专题下面的文章了解更多详细内容。

2025.09.05

6975

14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习