Struts2中struts.xml的Action、namespace配置详解

今天做了个struts2练习，发现自己对struts.xml的action配置没有理解，如下图为项目大致结构：

 

首先是找不到struts.xml,发现 <init-param>
            <param-name>config</param-name>
          
            <param-value>struts-default.xml,struts.xml</param-value>
        </init-param> 也找不到struts.xml,我有换为/WEN-INF/classes/struts.xml还是找不到，我在src下新建了一个struts目录把 struts.xml拷贝去，改为 <init-param>
            <param-name>config</param-name>
          
            <param-value>struts-default.xml,/struts/struts.xml</param-value>
        </init-param> 就行了。

 

action配置：是以src以下包为起点的，我把项目名都加进了<package name="test1" extends="struts-default"  >
        <action name="HelloWorld" class="test.HelloWorld">
            <result>/HelloWorld.jsp</result>
        </action>
    </package>结果找不到action 正确的如下图

    form配置错误：

<s:form action="test.HelloWorld" >
            Name: <s:textfield name="name" />
            <s:submit />
        </s:form>

 No configuration found for the specified action: 'test.HelloWorld' in namespace: ''. Form action defaulting to 'action' attribute's literal value.

改为下图

才正确

下面查到

Struts2中struts.xml的Action配置详解

Struts2中struts.xml的Action配置详解
使用package可以将逻辑上相关的一组Action，Result，Interceptor等组件分为一组，Package有些像对象，可以继承其他的Package，也可以被其他package继承，甚至可以定义抽象的Package。

Package 的可以使用的属性：

属性	是否必须	说明
name	是	Package的表示，为了让其他的package引用
extends	否	从哪个package继承行为
namespace	否	参考Namespace配置说明
abstract	否	定义这个package为抽象的，这个package中不需要定义action

由于struts.xml文件是自上而下解析的，所以被继承的package要放在继承package的前边。 Namespace 将action分成逻辑上的不同模块，每一个模块有自己独立的前缀。使用namespace可以有效的避免action重名的冲突，例如每一个 package都可以有自己独立的Menu和Help action，但是事项方式各有不同。Struts2标签带有namespace选项，可以根据namespace的不同向服务器提交不同的 package的action的请求。
“/”表示根namespace，所有直接在应用程序上下文环境下的请求（Context）都在这个package中查找。
“”表示默认namespace，当所有的namespace中都找不到的时候就在这个namespace中寻找。

例如，有如下配置：
CODE:
<package name="default">
<action name="foo" class="mypackage.simpleAction>
<result name="success" type="dispatcher">
greeting.jsp
</result>
</action>
<action name="bar" class="mypackage.simpleAction">
<result name="success" type="dispatcher">bar1.jsp</result>
</action>
</package>

<package name="mypackage1" namespace="/">
<action name="moo" class="mypackage.simpleAction">
<result name="success" type="dispatcher">moo.jsp</result>
</action>
</package>

<package name="mypackage2" namespace="/barspace">
<action name="bar" class="mypackage.simpleAction">
<result name="success" type="dispatcher">bar2.jsp</result>
</action>
</package>1 如果请求为/barspace/bar.action
查 找namespace：/barspace，如果找到bar则执行对应的action，否则将会查找默认的namespace，在上面的例子中，在 barspace中存在名字为bar的action，所以这个action将会被执行，如果返回结果为success，则画面将定为到bar2.jsp

2 如果请求为/moo.action
根namespace（'/'）被查找，如果moo action存在则执行，否则查询默认的namespace，上面的例子中，根namespace中存在moo action，所以该action被调用，返回success的情况下画面将定位到moo.jsp、

Action配置

在struts2框架中每一个Action是一个工作单元。Action负责将一个请求对应到一个Action处理上去，每当一个Action类匹配一个请求的时候，这个Action类就会被Struts2框架调用。

一个Action配置示例：
CODE:
<action name="Logon" class="tutorial.Logon">
<result type="redirect-action">Menu</result>
<result name="input">/tutorial/Logon.jsp</result>
</action>每一个Action可以配置多个result，多个ExceptionHandler，多个Intercepter，但是只能有一个name，这个name和package的namespace来唯一区别一个Action。

每当struts2框架接受到一个请求的时候，它会去掉Host，Application和后缀等信息，得到Action的名字，例如如下的请求将得到Welcome这个Action。 http://www.planetstruts.org/struts2-mailreader/Welcome.action

在一个Struts2应用程序中，一个指向Action的链接通常有Struts Tag产生，这个Tag只需要指定Action的名字，Struts框架会自动添加诸如后缀等的扩展，例如：
CODE:
<s:form action="Hello">
<s:textfield label="Please enter your name" name="name"/>
<s:submit/>
</s:form将产生一个如下的链接的请求:
http://Hostname:post/appname/Hello.action
在定义Action的名字的时候不要使用.和/，最好使用英文字母和下划线。

Action中的方法

Action的默认入口方法由xwork2的Action接口来定义，代码清单为：
CODE:
public interface Action {

public String execute() throws Exception;

}有些时候我们想指定一个Action的多个方法，我们可以做如下两步：
1 建立一些execute签名相同的方法，例如：
Public String forward() throws Exception

2 在Action配置的时候使用method属性，例如：
<action name="delete" class="example.CrudAction" method="delete">

Action中的方法通配符

有些时候对Action中方法的调用满足一定的规律，例如edit Action对应edit方法，delete Action对应 delete方法，这个时候我们可以使用方法通配符，例如：
<action name="*Crud" class="example.Crud" method="{1}"> 这时，editCrud Action的引用将调用edit方法，同理，deleteCrud Action的引用将调用delete 方法。

另外一种比较常用的方式是使用下划线分割，例如：
<action name="Crud_*" class="example.Crud" method="{1}">
这样当遇到如下调用的时候可以找到对应的方法。
"action=Crud_input" => input方法
"action=Crud_delete"　=> delete方法

通配符和普通的配置具有相同的地位，可以结合使用框架的所有其他功能。

默认的Action

当我们没有指定Action的class属性的时候，例如：
<action name="Hello">
我们默认使用com.opensymphony.xwork.ActionSupport
ActionSupport有两个方法input和execute，每个方法都是简单的返回SUCCESS。

通 常情况下，请求的Action不存在的情况下，Struts2框架会返回一个Error画面：“404 - Page not found”，有些时候或许我们不想出现一个控制之外的错误画面，我们可以指定一个默认的Action，在请求的Action不存在的情况下，调用默认的 Action，通过如下配置可以达到要求：
CODE:
<package name="Hello" extends="action-default">
<default-action-ref name="UnderConstruction">
<action name="UnderConstruction">
<result>/UnderConstruction.jsp</result>
</action>默认通配符
CODE:
<action name="*" >
<result>/{1}.jsp</result>
</action>每个Action将会被映射到以自己名字命名的JSP上。

struts2中动态方法的调用

可以采用DMI（Dynamic Method Invocation，动态方法）调用来处理这种请求，动态方法调用是指表单元素的action并不是直接等于某个Action的名字，而是以如下形式来指定Form的action属性：
<!-- action属性为actionName!methodName的形式 -->
action="ActionName!methodName.action"

<! 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 >

 

Struts2的struts.xml配置中namespace的使用

Struts2 的 struts.xml 中是分 package 配置的，可以为 package 设置 namespace 属性，如

<package namespace="/secure"   ....>
    ......
</package>

如果没有指定 namespace 属性，默认 namespace 是 ""。使用 namespace 可以方便于按不同目的规划对应用的访问规则。比如不同 namespace 下配置了不同的拦截器就可以实现权限的控制，如 "/secure" 下已登陆用户才能访问，"/public" 下可公开访问的。

配置了 namespace 直接就是反应在访问 URL 上，例如 namespace="/secure"  name="test" 的 action

 <package namespace="/secure"   ....>
       <action name="test"  ....
</package>

访问它的 URL 就是 http://ip:port/context/secure/test.action ，那如果在 namespace "/secure" 下没有 test action 会出现什么情况呢？Struts 还会尝试在默认 namespace，即 "" 下找 test。

再举个例子，URL 是 http://ip:port/context/some/path/test.action   时，如果在 "/some/path" namespace 下找不到 test action，也是到 "" (default namespace) 下找 test action，但不会去 "/some" 下找的。

用标签 <s:url value="/secure/test.action"/>  对应页面源文件是 /context/secure/test.action

稍有麻的就是 <s:form action="/secure/test.action" .... 对应的源文件是 <form action="/context/secure/test.action" ...

但是后台会有警告：

警告: No configuration found for the specified action: '/secure/test.action' in namespace: ''. Form action defaulting to 'action' attribute's literal value.

Struts2 把 action 属性值当整一个 Action Name 了，但这也不影响使用，这个 URL 正好能与 (package namespace) + (action name) 合上拍。

但是对于使用了动态方法调用（struts.enable.DynamicMethodInvocation = true）就没这么幸运了。很容易想当然的
 
<s:form action="/secure/test!update.action" ....  生成的 HTML 源文件却是 action="/TestStruts2/om/test"

同时后台的警告信息是：

警告: No configuration found for the specified action: '/secure/test' in namespace: ''. Form action defaulting to 'action' attribute's literal value.

很显然对于这个 action="/TestStruts2/om/test"，提交时是会得到 HTTP Status 404 - /context/secure/test  错误。

正确的用法是 <s:action...> 也有一个 namespace 属性，对了，就是

<s:form namespace="/secure" action="test!login">  生成的 HTML 源文件是：<form action="/TestStruts2/om/test!login.action" ....>
我们要的就是这个。
如 果不配置 namespace 属性，我们能不能在访问 action 时也用上目录层次呢？可以，那是在 struts1 习惯的做法，配置 <action name="secure/test" ....> name 中使用斜杠，但在 Struts2 中 Action Name 中使用斜杠需要设置

struts.enable.SlashesInActionNames=true                      默认为 false

可是 Struts2 大概不赞同这种做法，力挺 namespace 的作用。

对于上面使用了斜框的 Action Name，<s:form 中的写法要用

<s:form action="secure/test">              　　 生成 HTML 源文件：<form action="/context/secure/test.action" .....

<s:form action="secure/test!update">            生成 HTML 源文件：<form action="/context/secure/test!login.action" .....

上面的 action 后加不加 .action 无所谓，只是要保证 <s:form>  的 action 属性一定要与 struts.xml 中的 <action> 的 name 匹配上，如果你自作多情的在前面加个斜杠，如写成了
 
<s:form action="/secure/test!update"> 、 <s:form action="/secure/test">  或者 <s:form action="/secure/test!update.action">   生成的 HTML 源文件就都成了：<form action="/context/secure/test" .....

这也是从 Struts1 带来的弊病，因为 Struts1 中 <html:form> action 属性对应的是 <action> 的 path，而 Struts2 中 <s:form> 的 action 属性对应的是 <action> 的 name；name 要完全匹配，path 可以加些层次。