java注解的使用

转自：http://www.cnblogs.com/komojoemary/p/5776291.html

在讲注解之前，我们先来看下xml。
    xml作为一种可扩展的标记语言，我想大家都不会陌生，尤其对于我们开发人员而言。在我们开发过程中，xml最大的用武之地一般有两个：配置文件和异构系统之间的数据传输。今天我们讲的内容和前一块有关。
    在注解出现之前，作为配置文件应用的xml大量的出现在各种框架和系统中。比如鼎鼎有名的持久化框架hibernate，它里面有块非常重要内容：实体与数据库表的映射关系，依靠
的就是xml的配置完成。另外java里面开源web框架的先驱Structs，当初横空出世的时候，作为其核心的Controll就需要在xml中进行配置。

    在我们通过xml的配置方式进行解耦系统的时候，带来了一些预料之外的问题：
    1、我们需要花费额外的精力去维护这些xml文件
    2、xml中的配置内容使得与之紧密相关的内容进行了强分离，实际上它们本应是一个聚簇。比如我们的实体，本就应该和数据库表之间的关系存放在一起，两者共存才能叫做实体，
否则仅能称之pojo。
    3、ioc，也就是所谓的控制反转。xml虽然使得一些内容得到了耦合分离，但是从大的方面来讲，它还是属于一个大工厂模式，并且没有注入的概念。

    什么是注解？说起注解，得先提一提什么是元数据(metadata)。所谓元数据就是数据的数据。也就是说，元数据是描述数据的。就象数据表中的字段一样，每个字段描述了这个字段
下的数据的含义。而J2SE5.0中提供的注解就是java源代码的元数据，也就是说注解是描述java源代码的。在J2SE5.0中可以自定义注解。使用时在@后面跟注解的名字。

    注解的作用？结合上面我们讲的xml，注解在我们框架里面出现最多的地方就是实体和Action。

    注解如何作用的？它的原理是怎样的？我们下面以一个实际需求为例，与大家一起剖析下java的web框架里面controll的运作机制，这里我们的需求就是在客户端调用服务端
TestAction这个类中的pageLoad方法。
    我们先来看下servlet的实现过程：
    首先，我们要定义一个类，名字叫TestAction,继承HttpServlet，实现它的doGet、doPost方法，并且实现一个pageLoad方法，根据请求里面的参数如果是pageLoad的话就进行该方法调用;接着，我们在web.xml中进行servlet配置，配置我们写的action与servlet名字的一个映射关系;最后我们在前端写上一个ajax，请求地址填上我们的servlet名字，请求参数写上pageLoad。至此完成。
    接着我们来看应用注解的实现过程，我们截图TestAction的代码如下：
    @Name("testAction")
    public class TestAction{
        public void pageLoad() {
           System.out.println("java我来了");
        }
    }
    在上面这段代码中，我们定义了一个类，名字是TestAction，里面有个pageLoad方法。然后我们又有个页面,页面里面写了这样一段语句：#{testAction.pageLoad()}。
这个我想大家都不会陌生，是我们用的几乎要吐的EL表达式。这段代码的涵义是去调用testAction的pageLoad方法。作为一个刚学习完java，或者除了servlet对框架原理一无了解的开发人员来说，你是怎么去思考它其中的过程的呢？即为什么这样写它就能够调用到我们后台java类中的方法呢？因为对比servlet的实现过程，我们发现要简单的太多。其实它其中的原理大致如下：
    1、我们web程序启动的时候，框架会去扫描所有的class，运用反射技术解析出@Name("testAction")这样的注解内容，解析得到的就是testAction--->TestAction.class这样的映射关系，即testAction唯一关联到了我们这个action类。这个过程原先我们是通过xml配置得以完成的。最后进行全局缓存。
    2、客户端提交页面请求到服务端，服务端有个框架提供的全局通用的servlet，运用EL技术解析出这段#{testAction.pageLoad()}表达式的内容，无疑得到testAction调用pageLoad方法这样的概念。
    3、从第一步全局缓存中获取到testAction对应的是TestAction.class这个类。然后new  TestAction().pageLoad();进行最终方法的调用。从这里我们可以看出，@Name注解后面的值必须是唯一的，否则框架将无法区分它关联到哪个类中去。
    从上面一整个流程，其实我们也不难看出，一般web框架的核心是什么了：其实帮你做的最主要的事情就是封装了这样的一个通用的处理过程，让你少写代码，少做事。再集成前端和持久层就是一个标准web框架了。

    如何自定义注解？下面我们自定义了一个TX注解
 @Target({java.lang.annotation.ElementType.TYPE,java.lang.annotation.ElementType.METHOD, java.lang.annotation.ElementType.FIELD })
    @Retention(RetentionPolicy.RUNTIME)
    public @interface TX{
       public String name() default "hello";
    }
    1、注解使用@interface作为关键字，整个过程和创建java类一样。
    2、@Target用于指定注解的作用域，即可被用在什么上面。TYPE:是类上面;METHOD:是方法上面;FIELD:是属性上面。
    3、@Retention用于指定注解的生命周期。有SOURCE,CLASS和RUNTIME3种。SOURCE代表的是这个Annotation类型的信息只会保留在程序源码里，源码如果经过了编译之后，Annotation的数据就会消失,并不会保留在编译好的.class文件里面。ClASS的意思是这个Annotation类型的信息保留在程序源码里,同时也会保留在编译好的.class文件里面,在执行的时候，并不会把这一些信息加载到虚拟机(JVM)中去.注意一下，当你没有设定一个Annotation类型的Retention值时，系统默认值是CLASS. RUNTIME,表示在源码、编译好的.class文件中保留信息，在执行的时候会把这一些信息加载到JVM中去的。
    4、定义属性只能使用public修饰，或者删除采用默认的。如果设置默认值就写上default 默认值信息。
    5、实际应用：
    @TX(name="hello word")
    public class TestAction{
    }

    后记：
    注解的出现，大大的解放了xml的压力，在我看来，实在是一个了不得的创新。