Struts2零配置开发（注解Annotation的使用）二

接上篇http://lichuanbao.iteye.com/admin/blogs/1090836。
4,Namespace annotation
可以定义在Action中或者是定义在package-info.java文件中。在Action中定义的@Namespace会应用在该Action中所有的相对url上。如果定义在package-info.java文件中，那么该包中的所有的Action的namespace（不包括子包中的action）。
实例代码一：在Action中使用@Namespace注解。

package com.example.actions;

import com.opensymphony.xwork2.ActionSupport; 
import org.apache.struts2.convention.annotation.Action;
import org.apache.struts2.convention.annotation.Namespace;

@Namespace("/custom")
public class HelloWorld extends ActionSupport {
  @Action("/different/url")
  public String execute() {
    return SUCCESS;
  }

  @Action("url")
  public String doSomething() {
    return SUCCESS;
  }
}

如上代码，execute()访问的url为/different/url,doSomething()的访问url为/custom/url，这个路径前面追加了@Namespace。

示例代码二：在package-info.java中配置@Namespace注解

@org.apache.struts2.convention.annotation.Namespace("/custom")
package com.example.actions;

那么包com.example.actions中所有的action的Namespace都被指向了/custom。

5,ResultPath annotation，用来改变结果页面所在的目录。如下例所示

package com.example.actions;

import com.opensymphony.xwork2.ActionSupport; 
import org.apache.struts2.convention.annotation.Action;
import org.apache.struts2.convention.annotation.ResultPath;

@ResultPath("/WEB-INF/jsps")
public class HelloWorld extends ActionSupport {
  public String execute() {
    return SUCCESS;
  }
}

该Action跳转的结果页面将指向/WEB-INF/jsps目录。

6,ParentPackage annotation，用来改变特定的Action类或者是java包的parent XWork packages（不好意思，这几个单词怎么翻译觉得都不好，就直接引用了）。示例代码如下

package com.example.actions;

import com.opensymphony.xwork2.ActionSupport; 
import org.apache.struts2.convention.annotation.Action;
import org.apache.struts2.convention.annotation.ParentPackage;

@ParentPackage("customXWorkPackage")
public class HelloWorld extends ActionSupport {
  public String execute() {
    return SUCCESS;
  }
}

7,ExceptionMapping Annotation，用来配置action出现异常时的跳转路径。该注解同样可以使用params属性配置要传入的参数。该注解可以配置在Action级别和Method级别，配置在Action级别对所有的Method都适用；配置在Method级别只对当前的Method使用。示例代码如下：
在Action上配置ExceptionMapping Annotation：

@ExceptionMappings({
    @ExceptionMapping(exception = "java.lang.NullPointerException", result = "success", params = {"param1", "val1"})
})
public class ExceptionsActionLevelAction {

    public String execute() throws Exception {
        return null;
    }
}

在Method上配置ExceptionMapping Annotation，使用params属性传入要设置的参数

public class ExceptionsMethodLevelAction {
    @Action(value = "exception1", exceptionMappings = {
            @ExceptionMapping(exception = "java.lang.NullPointerException", result = "success", params = {"param1", "val1"})
    })
    public String run1() throws Exception {
        return null;
    }
}

Convention Plugin在Action中的配置改变时，可以自动加载改变的内容而不用重新启动容器。这时需要在struts.xml文件中做如下设置

<constant name="struts.devMode" value="true"/>
<constant name="struts.convention.classes.reload" value="true" />

但这种加载方式只是实验性的并且还没有在所有的容器中进行测试，因此官方不推荐使用。

==========常见错误============
1,"There is no Action mapped for namespace /orders and action name view.",这说明URL"/orders/view.action"并没有被映射到任何一个action，这是你需要检查action的namespace或者action的名称是否正确。
2,如果碰见如“"No result defined for action my.example.actions.orders.ViewAction and result success"的错误，说明action被映射到了正确的url上，但是action返回success时要跳转的页面并没有找到，请确保您的工程的正确目录中含有诸如/WEB-INF/content/orders/view-success.jsp的页面。

============难点=============
1,要确保Action的namespace要有对应的页面。定位器(action,actions,struts,strutss)后面的namespace将作为action的namespace，并且用来定位该action要跳转到的页面。例如包my.example.actions.orders中有个名为ViewAction的action,那么他会被映射到/orders/view.action,该Action对应的页面必须在目录/WEB-INF/content/orders下面，例如/WEB-INF/content/orders/view-success.jsp。
2,关于Convention Plugin的日志输出。本插件在Debug模式下会输出大量的日志信息，因此不建议开启Debug模式。如果你是用的是JDK自带的logger,可以使用"trace"日志级别打印日志；如果使用的是Log4J，可以在配置文件中做如下配置

log4j.logger.org.apache.struts2.convention=DEBUG

评论

3 楼 xwqiang 2012-11-09  

1,"There is no Action mapped for namespace /orders and action name view.",这说明URL"/orders/view.action"并没有被映射到任何一个action，这是你需要检查action的namespace或者action的名称是否正确。
我出现了这个问题，找了好久不得其果

2 楼 jbpm 2012-07-04  

挺实用的一篇文章~

1 楼 zhuchao_ko 2011-06-16