本文共 5555 字，大约阅读时间需要 18 分钟。
开始Struts2最常用的几个注解的学习吧。
@Action
使用@Action注解改变Convention plug约定的action与url之间的映射关系。
废话少说代码说事儿。
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | package com.ponpon.actions; import org.apache.struts2.convention.annotation.Action; import com.opensymphony.xwork2.ActionSupport; public class myAction extends ActionSupport { @Action ( "/v1/url" ) public String execute() { return SUCCESS; } } |
本例***赟tring execute()方法上使用了@Action("/v1/url")，它改变了Action 与Action URL之间的映射关系，而这种改变并不是“OverWrite”而是在原来约定的基础上增加了另外一种调用方式。
原本在没有@Action("/v1/url")注解的情况下，我们可以在浏览器中输入：http://应用服务器ip:端口/应用/myaction,即可访问到com.ponpon.actions.myAction,并最终显示http://应用服务器ip:端口/应用/myaction.jsp页面。（当然这里也可能是html等页面）。
在@Action("/v1/url")注解的情况下，除了上述的访问方式外，我们还可以在浏览器中输入：http://应用服务器ip:端口/应用
/v1/url，也可访问到com.ponpon.actions.myaction，但最终显示http://应用服务器ip:端口/应用/v1/url.jsp页面。
使用@Action注解解决一个ACTION中的一个方法，响应多个不同的URL.
实际项目开发过程中有很大的几率碰到Action的处理相同，但是最终跳转的页面不同的情况。将@Actions和@Action组合起来用即可解决这样的需求。
还是先上代码
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | package com.ponpon.actions; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Actions; import com.opensymphony.xwork2.ActionSupport; public class myaction1 extends ActionSupport { private String message; public String getMessage() { return message; } @Actions ( { @Action ( "/one/url" ), @Action ( "/another/url" ) }) public String execute() { message = "myaction1 execute()" ; return SUCCESS; } } |
本例***赟tring execute()方法上使用了@Actions和@Action注解。其中@Actions注解包含@Action("/one/url")和@Action("/another/url")注解。这样的注解除了可以通过http://应用服务器ip:端口/应用/myaction1访问com.ponpon.actions.myaction1,并最终显示http://应用服务器ip:端口/应用/myaction.jsp之外，还有两种访问方式：
即：
通过http://应用服务器ip:端口/应用/one/url,访问com.ponpon.actions.myaction1,并最终显示http://应用服务器ip:端口/应用/one/url.jsp。
通过http://应用服务器ip:端口/应用/another/url,访问com.ponpon.actions.myaction1,并最终显示http://应用服务器ip:端口/应用/another/url.jsp。
这样就达到了一个ACTION中的一个方法，响应多个不同的URL的效果。
使用@Action注解解决一个ACTION中的多个方法，其中每个方法响应不同的URL.
这是实际项目开发过程中最常用的。 再上一个代码示例：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 | package com.ponpon.actions; import org.apache.struts2.convention.annotation.Action; import com.opensymphony.xwork2.ActionSupport; public class myaction2 extends ActionSupport { private String message; public String getMessage() { return message; } @Action ( "/v1/url" ) public String execute() { message = "myaction2 execute()!" ; return SUCCESS; } @Action ( "url" ) public String doSomething() { message = "myaction2 doSomething()!" ; return SUCCESS; } } |
这个例子里面需要注意的是@Action("/v1/url")和@Action("url")的不同，在“url”前并没有“/”这意味着"url"是基于myaction2的命名空间的。假设myaction2所在的包是com.ponpon.actions.aaa，那么，只有通过http://应用服务器ip:端口/应用/aaa/url才可以访问到com.ponpon.actions.aaa.myaction2，并最终显示http://应用服务器ip:端口/应用/aaa/url.jsp。而“/v1/url”是基于“/”命名空间的。
在上文中，对于结果页面采用Convention Plugin的约定，但是这一节需要利用@Results和@Result改变一下这种约定。以及@Results和@Result对类和方法进行注解后所产生的效果。
还是先看一段代码：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 | package com.ponpon.actions; import org.apache.struts2.convention.annotation.Action; import org.apache.struts2.convention.annotation.Result; import org.apache.struts2.convention.annotation.Results; import com.opensymphony.xwork2.ActionSupport; @Results ( { @Result (name = "global" , location = "/global.jsp" ) }) public class myaction3 extends ActionSupport { @Action (value = "/v1/url" , results = { @Result (name = SUCCESS, location = "/v1/success.jsp" ), @Result (name = "failure" , location = "/v1/fail.jsp" ) }) public String execute() { if (System.currentTimeMillis() % 3 == 0 ) { return "failure" ; } else if (System.currentTimeMillis() % 3 == 1 ) { return SUCCESS; } else { return "global" ; } } @Action ( "globalTest" ) public String global() { return "global" ; } @Action (value = "globalOverWrite" , results = { @Result (name = "global" , location = "/v1/globalOverWrite.jsp" ) }) public String globalOverWrite() { return "global" ; } } |
使用@Result注解改变Convention Plugin的约定跳转页面。
在代码的String execute()方法上进行了 @Action(value = "/v1/url", results = { @Result(name = SUCCESS, location = "/H5/success.jsp"),
@Result(name = "failure", location = "/H5/fail.jsp") })注解。如果@Action(...)没有results = { @Result(name = SUCCESS, location = "/v1/success.jsp"),
@Result(name = "failure", location = "/H5/fail.jsp") }，那么依据Convention Plugin的约定，结果页面会是/v1/url.jsp。加上红色字体的部分后，execute()方法执行后，会根据红色字体的配置，将结果跳转到对应的页面。
对Action类添加@Result注解，@Result将被Action类中的所有方法所共享。
仔细观察上述代码，在HelloWorld5上进行了@Results( { @Result(name = "global", location = "/global.jsp") })注解。这意味着该类及其子类的所有方法都可以返回一个名字为“global”的结果页面。而这个页面是"/global.jsp"。这就使得不用在每个需要跳转到"/global.jsp"的方法都进行@Result(name = "global", location = "/global.jsp")注解。这在实际工作中也是非常常见的一种情况。可以仔细观察的execute()方法和global()方法。他们都可能跳转到名字为“global”的结果页面（即location属***定义的“/global.jsp”页面）。
对Action类中的方法添加@Result注解，@Result将只作用于被添加的方法。Action类方法上添加的@Result优先级高于Action类上添加的@Result。（前者覆盖后者）
再仔细观察上述代码的globalOverWrite()方法，该方法也跳转到名字为“global”的页面。但是在该方法上使用了@Action(value = "globalOverWrite", results = { @Result(name = "global", location = "/v1/globalOverWrite.jsp") })注解。并且其中@Result(...)注解中也有一个名字为“global”的结果页面定义。此时，该方法的结果页面就会跳转到/H5/globalOverWrite.jsp页面而不是在类上进行注解时候的“/global.jsp”页面。