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

接上篇。

4,Namespace annotation

可以定义在Action中或者是定义在package-info.java文件中。在Action中定义的@Namespace会应用在该Action中所有的相对url上。如果定义在package-info.java文件中，那么该包中的所有的Action的namespace（不包括子包中的action）。

实例代码一：在Action中使用@Namespace注解。

Java代码



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注解

Java代码



@org.apache.struts2.convention.annotation.Namespace("/custom")

package com.example.actions;

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

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

Java代码



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（不好意思，这几个单词怎么翻译觉得都不好，就直接引用了）。示例代码如下

Java代码



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：

Java代码



@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属性传入要设置的参数

Java代码



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文件中做如下设置

Java代码



<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，可以在配置文件中做如下配置

Java代码



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