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

接上篇。 
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