Struts2基于注解Annotation的零配置开发（二）

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

Java代码 

1. package com.example.actions; 
2.  
3. import com.opensymphony.xwork2.ActionSupport;  
4. import org.apache.struts2.convention.annotation.Action; 
5. import org.apache.struts2.convention.annotation.Namespace; 
6.  
7. @Namespace("/custom") 
8. public class HelloWorld extends ActionSupport { 
9.   @Action("/different/url") 
10.   public String execute() { 
11.     return SUCCESS; 
12.   } 
13.  
14.   @Action("url") 
15.   public String doSomething() { 
16.     return SUCCESS; 
17.   } 
18. } 

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

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

Java代码 

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

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

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

Java代码 

1. package com.example.actions; 
2.  
3. import com.opensymphony.xwork2.ActionSupport;  
4. import org.apache.struts2.convention.annotation.Action; 
5. import org.apache.struts2.convention.annotation.ResultPath; 
6.  
7. @ResultPath("/WEB-INF/jsps") 
8. public class HelloWorld extends ActionSupport { 
9.   public String execute() { 
10.     return SUCCESS; 
11.   } 
12. } 

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

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

Java代码 

1. package com.example.actions; 
2.  
3. import com.opensymphony.xwork2.ActionSupport;  
4. import org.apache.struts2.convention.annotation.Action; 
5. import org.apache.struts2.convention.annotation.ParentPackage; 
6.  
7. @ParentPackage("customXWorkPackage") 
8. public class HelloWorld extends ActionSupport { 
9.   public String execute() { 
10.     return SUCCESS; 
11.   } 
12. } 

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

Java代码 

1. @ExceptionMappings({ 
2.     @ExceptionMapping(exception = "java.lang.NullPointerException", result = "success", params = {"param1", "val1"}) 
3. }) 
4. public class ExceptionsActionLevelAction { 
5.  
6.     public String execute() throws Exception { 
7.         return null; 
8.     } 
9. } 

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

Java代码 

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

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

Java代码 

1. <constant name="struts.devMode" value="true"/> 
2. <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，可以在配置文件中做如下配置

Java代码 

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