Struts2注解零配置

1 、关于注解

注解放在什么语法单元头上？

一个语法单元头上同种注解只能放一个

注解中的默认方法名为value

每个方法都可以有默认值

如果注解中的方法需要一个数组，那么可以用一个单独元素来给定

2 、每个包都可以设置 package-info.java ，用于写这个包的注释和注解

java代码：

查看 复制到剪贴板 打印

1. /** 
2.  * Action包 
3.  */  
4. @ParentPackage("ssh-default")  
5. package cn.javass.ssh.doc.action;  
6.    
7. import org.apache.struts2.convention.annotation.ParentPackage;  
8.    

导出javadoc的时候需要设置-encoding utf-8 -charset utf-8。

在前面的学习中，把Struts2的配置信息都放在了struts.xml中，这种方式简单有效而且使用起来也非常方便。但是，还有没有更简洁的方式呢？

Struts2提供了按照约定来自动配置的方式，或者使用Java注解来替代struts.xml进行配置的方式，从而可以实现零配置。

先来看看struts.xml中的action都能配置些什么？直接看struts2的dtd中描述Action的部分，示例代码如下：

java代码：

查看 复制到剪贴板 打印

1. <!ELEMENT action (param|result|interceptor-ref|exception-mapping)*>  
2. <!ATTLIST action  
3.     name CDATA #REQUIRED  
4.     class CDATA #IMPLIED  
5.     method CDATA #IMPLIED  
6.     converter CDATA #IMPLIED  
7. >   

零配置就是要替代这些东西，通过约定或者是注解，把这些东西从struts.xml中移除，达到不需要配置就可以指定这些信息并正确运行应用的目的。

把struts2-convention-plugin-2.1.8.1.jar包拷贝到web工程的WEB-INF\lib包里面。

java代码：

查看 复制到剪贴板 打印

1. @ParentPackage("s2")  
2. @Namespace("/s2")  
3. @Action("/anno")  
4. @Results(  
5. @Result(name="success",location="/anno/success.jsp")  
6. )  
7. @ExceptionMappings(  
8. @ExceptionMapping(exception="java.lang.Exception",result="error")  
9. )  
10. @InterceptorRefs({  
11. @InterceptorRef("logger"),@InterceptorRef("myStack")  
12. })  
13. public class AnnoAction extends ActionSupport{  
14. …  
15. }  

1 、可以在 package-info.java 上添加注解，让这个包内的所有 Action 共享

java代码：

查看 复制到剪贴板 打印

1. @ParentPackage("ssh-default")  
2. @Namespace("/doc")  
3. @DefaultInterceptorRef("checkStack")  
4. package cn.javass.ssh.doc.action;  
5.    
6. import org.apache.struts2.convention.annotation.Namespace;  
7. import org.apache.struts2.convention.annotation.ParentPackage;  
8. import org.apache.struts2.convention.annotation.DefaultInterceptorRef;  

2 、可以给 <result><interceptor-ref> 等加上 <param>

@Result(type="json",name="jsonr",params={"root"," citys"}

其中的 params 是键值对，相当于

java代码：

查看 复制到剪贴板 打印

1. <result type="json" name=“jsonr">  
2. <param name="root">citys</param>  
3. </result>  

可以在struts.xml或struts.properties里设置常量来设置Struts2框架读取哪些类为Action。

1、struts.convention.action.packages：可以使用的Action的祖包，默认为没有， 设置为 cn.javass.ssh 就可以读取这个包及其子包的所有头上注册了【 @Action 】 的类。

 

2、 struts.convention.package.locators：可以使用的Action的上级包，默认为【action,actions,struts,struts2】，这样就可以读取所有在包中的所有头上注册了【@Action】的类；注意设置的action应为这个包的最后一级包，如cn.javass.ssh.user.action.UserAction。

 

3、 struts.convention.action.suffix：Action类类名的后缀，默认为Action。

  

在前面的例子中已经看到了，使用注解的方式实现零配置和struts.xml的方式是可以并存的。也可以各自独立存在。如何使用就看各自的写法了。

 

视频配套PPT，视频地址【 struts2 注解零配置视频教程 】

转自【 http://sishuok.com/forum/blogPost/list/0/2554.html#7329】