struts2注解小谈

http://bbs.csdn.net/topics/390673267

21.3  通过注解来实现零配置

21.3.1  概述
在实际开发中，光是简单的通过默认的方式来进行配置，是满足不了实际项目的需要的，这就需要使用注解，来进一步控制程序各个部分的对应关系。
就其实质，就是把原本在struts.xml中的配置信息，通过使用注解来把这些信息搬移到Action类上进行配置。所以零配置并不是不配置，只是不在struts.xml里面配置而已。
21.3.2  HelloWorld
接下来，通过一个示例来看看如何通过注解来实现零配置。
修改刚才的HelloWorldAction类，不再实现execute方法，而是实现一个method1的方法，在这个方法上添加上一个最简单的Action注解，示例代码如下：
 
java代码：
查看复制到剪贴板打印
public class HelloWorldAction extends ActionSupport{  
    @Action("/t1")  
    public String method1() throws Exception {  
        System.out.println("now is HelloWorld");  
        return this.SUCCESS;  
    }  
}  
上面示例中的注解“@Action("/t1")”，表示访问Action的这个方法的映射就是t1，也就是说，通过URL：http://localhost:9080/helloworld/t1，就可以访问到HelloWorldAction中的method1方法，执行后返回success。然后到WEB-INF/content文件夹下，优先匹配t1-success.jsp，如果没有，匹配t1.jsp也可以。
       这就可以看得出来，注解的方式明显比完全依靠约定的方式要更灵活，让程序人员有更大的控制力，从而可以实现更复杂的功能。
所有可以引用的注解都在org.apache.struts2.convention.annotation这个包中。接下来，就来一一介绍最常用的几个。
21.3.3  @Action和@Actions
@Action注解可谓是集大成者，可以使用它为Action类指定引用名，也就是在URL中的映射名称，它同时还可以包含其他的注解。
@Action注解有以下属性：
value：指定URL中的映射名称。
params：指定需要注入到Action的参数。
results：指定结果。
interceptorRefs：指定拦截器引用。
excepitonMappings：声明错误处理。

java代码：
查看复制到剪贴板打印
public class HelloWorldAction extends ActionSupport{  
    @Action(value="/annoAction",  
           params={"str","param1","str2","param2"},  
           results={                     
             @Result(name="success",location="/anno/success.jsp"),           @Result(name="another",location="/anno/another.jsp")  
           },         interceptorRefs={@InterceptorRef("timer"),@InterceptorRef("defaultStack")},  
           exceptionMappings={                         @ExceptionMapping(exception="java.lang.NullPointerException",  
    result="nullError"),            @ExceptionMapping(exception="java.lang.Exception",result="error")  
           }  
    )  
    public String method1() throws Exception {  
       System.out.println("now is HelloWorld=="+str+" , str2="+str2);  
       return this.SUCCESS;  
    }  
    private String str,str2;  
    public String getStr() {  
       return str;  
    }  
    public void setStr(String str) {  
       this.str = str;  
    }  
    public String getStr2() {  
       return str2;  
    }  
    public void setStr2(String str2) {  
       this.str2 = str2;  
    }  
}  


这样的注解就相当于在struts.xml中注册：
 
java代码：
查看复制到剪贴板打印
<action name="annoAction" class="……">  
<param name="str">param1</param>  
<param name="str2">param2</param>  
        <interceptor-ref name="timer"/>  
        <interceptor-ref name="defaultStack"/>  
        <exception-mapping result="nullError"  
        exception="java.lang.NullPointerException"/>  
        <exception-mapping result="error" exception="java.lang.Exception"/>  
        <result name="success">/anno/success.jsp</result>  
        <result name="another">/anno/another.jsp</result>  
</action>  
特别要注意params的定义：params={"str","param1","str2","param2"}，它里面全部用的都是逗号，也就是第一个为参数的key，第二个就为相应的值，而第三个又为参数的key，第四个为相应的值，以此类推。另外参数的key一定要对应Action中的属性，因为这些参数在传递给Action的时候，需要有接收的地方。
而@Actions是可以包含多个@Action的注解，示例如下：
 
java代码：
查看复制到剪贴板打印
public class HelloWorldAction extends ActionSupport{  
    @Actions({  
        @Action(value="/annoAction"),  
        @Action(value="/t1")      
    })  
    public String method1() throws Exception {  
        System.out.println("now is HelloWorld");  
        return this.SUCCESS;  
    }  
}  
这样的注解，表明使用如下的URL：“http://localhost:9080/helloworld/t1”或者“http://localhost:9080/helloworld/annoAction”，都能够访问到method1这个方法。
另外要注意：@Action和@Actions都是既可以用在类级，又可以用在方法级上，上面的示例就是在方法级上。
21.3.4  @Result和@Results
@Result注解用于声明一个结果，有以下属性：
name：指定结果的名字，默认为success。
type：指定结果的类型，默认为在<result-types>中定义的默认类型。
location：指定结果的页面位置。
params：指定结果的可选参数。

java代码：
查看复制到剪贴板打印
@Result(name="success",location="/anno/success.jsp")  
public class AnnotationAction extends ActionSupport{  
…  
}  
这样的注解就相当于在struts.xml中注册：

java代码：
查看复制到剪贴板打印
<result name =” success”>/ anno /success.jsp</result>  
@Results注解用来声明多个结果，它只有一个value属性，而这个value属性又需要一个@Result数组。
       Java注解规定在同一个语法单元上，同一种注解只能使用一个，因此，如果一个Action可能有多个后继页面的时候，决不能在同一个Action类上使用多个@Result，而是应该使用@Results包含了多个@Result。如：
 
java代码：
查看复制到剪贴板打印
@Results({  
        @Result(name="success",location="/anno/success.jsp"),  
        @Result(name="another",location="/anno/another.jsp")  
})  
public class AnnotationAction extends ActionSupport{  
…  
}  
注意：上面的注解出现了一对花括号{}，这是表示@Results注解中有两个@Result注解组成的数组，一定要注意。
       这样的注解就相当于在struts.xml中注册：
 
java代码：
查看复制到剪贴板打印
<result name="success">/wait/success.jsp</result>  
<result name="another">/wait/another.jsp</result>  
另外要注意：@Result和@Results是用在类级上，不能直接用在方法上，相当于整个Action的全局的Result。当然可以把他们配置在方法级使用的@Action里面，当做局部的result配置。
21.3.5  @Namespace
@Namespace注解用来这个Action类的包命名空间，只有value属性，用来指明包命名空间。
 
java代码：
查看复制到剪贴板打印
@Namespace (“/helloworld")  
public class AnnotationAction extends ActionSupport{  
…  
}  
这样的注解就相当于在struts.xml中注册：
 
java代码：
查看复制到剪贴板打印
<package namespace="/helloworld">  
<action …>  
</action>  
21.3.6  @InterceptorRef和@InterceptorRefs
@Interceptor注解用来为这个Action引用拦截器，只有一个value属性，用来指定拦截器或者是拦截器栈的名字。
 
java代码：
查看复制到剪贴板打印
@InterceptorRef("defaultStack")  
public class AnnotationAction extends ActionSupport  
这样的注解就相当于在struts.xml中注册：
 
java代码：
查看复制到剪贴板打印
<action …>  
    <interceptor-ref name="defaultStack"/>  
</action>  
@InterceptorRefs注解用来声明多个拦截器引用，它只有一个value属性，而这个value属性又需要一个@InterceptorRef数组。
       注意：@InterceptorRefs和@InterceptorRef的关系与@Results和@Result的关系类似。一个类上也不能同时出现两个@IntercptorRef注解，因此，请读者对比@Results，请写出如何在一个Action上引用两个拦截器。
21.3.7  @ExceptionMapping和@ExceptionMappings
@ExceptionMapping注解用来为这个Action声明错误处理，有以下属性：
exception：指定处理的例外。
result：指定捕获了指定例外之后跳转到哪个结果。
params：指定额外的参数。
 
java代码：
查看复制到剪贴板打印
@ExceptionMapping(exception="java.lang.Exception",result="error")  
public class AnnotationAction extends ActionSupport  
这样的注解就相当于在struts.xml中注册：
 
java代码：
查看复制到剪贴板打印
<action …>  
    <exception-mapping result="error" exception="java.lang.Exception"/>  
</action>  
@ExceptionMappings注解用来声明多个错误处理，它只有一个value属性，而这个value属性又需要一个@ExceptionMapping数组。
       注意：@ExceptionMappings和@ExceptionMapping的关系与@Results和@Result的关系类似。一个类上也不能同时出现两个@ExceptionMapping注解。
21.3.8  @ParentPackage
@ParentPackage注解用来为Action指定父包，它只有一个value属性，用来指定父包的名字。
这听起来有些不可思议，父包都是在包上指定的啊，只有<package>元素才有parent属性来指定父包啊，Action上怎么也能指定呢？零配置的时候，所有的Action都是单独放置的，暂时还没有包这个概念，所以需要在每个Action上指定自己的父包，如果不指定的话默认为struts-default。
21.3.9  用注解来替代struts.xml
到这里，已经把使用注解实现零配置的细节都学完了，您是不是已经欢呼雀跃的说，“我已经会了，不就是用注解来替代struts.xml嘛！”。
但是请注意一点，到现在为止，注解还不能完全替代struts.xml。事实上用注解替代的不是struts.xml文件，而是替代struts.xml中的一些配置信息，主要的是struts.xml中<action>元素部分的配置。
除了<action>元素，struts.xml中还有很多东西，比如：指定全局结果<global-result>；声明一个拦截器<interceptor>等等，到现在为止，注解还做不到。
       因此，请大家注意：注解实现零配置不能完整的替代struts.xml，而是替代了其中Action部分的配置信息。那么，其他部分该怎么办呢？
很简单，让struts.xml和注解实现的零配置共存来解决这个问题。也就能用注解代替的部分写到Action类里面，其他的还是写到struts.xml里面就可以了。
私塾在线原创