开始Struts2最常用的几个注解的学习吧。
@Action
使用@Action注解改变Convention plug约定的action与url之间的映射关系。
废话少说代码说事儿。
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组合起来用即可解决这样的需求。
还是先上代码
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.
这是实际项目开发过程中最常用的。
再上一个代码示例:
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; } }
本例***赟tring execute()方法上使用了@Action("v1/url")注解。在StringdoSomething()方法中使用了@Action("url")。前者可以通过http://应用服务器ip:端口/应用/v1/url访问com.ponpon.actions.mycation2中的execute()方法,并最终显示http://应用服务器ip:端口/应用/v1/url.jsp。后者是通过http://应用服务器ip:端口/应用/url来访问com.ponpon.actions.myaction2中的doSomething()方法,并最终显示http://应用服务器ip:端口/应用/url.jsp。
这个例子里面需要注意的是@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对类和方法进行注解后所产生的效果。
还是先看一段代码:
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”页面。
本文出自 “Programming in XMU” 博客,请务必保留此出处http://liuxp0827.blog.51cto.com/5013343/1424355
原文地址:http://liuxp0827.blog.51cto.com/5013343/1424355