注解定义

  • Annontation是Java5开始引入的新特征,中文名称叨注解。
  • 它提供了一种安全的类似注释的机制,用来将任何的信息戒元数据(metadata)与程序 元素(类、方法、成员变量等)进行关联。
  • 为程序的元素(类、方法、成员变量)加上更直观更明了的说明,这些说明信息是与程 序的业务逻辑无关,并且供指定的工具戒框架使用。
  • Annontation像一种修饰符一样,应用于包、类型、构造方法、方法、成员变量、参数 及本地变量的声明语句中。
  • Java注解是附加在代码中的一些元信息,用于一些工具在编译、运行时进行解析和使用, 起到说明、配置的功能。
  • 注解不会也不能影响代码的实际逻辑,仅仅起到辅劣性的作用。包含在 java.lang.annotation 包中。

注解的作用

  • 生成文档。这是最常见的,也是java 最早提供的注解。常用的有 @param @return 等
  • 跟踪代码依赖性,实现替代配置文件功能。
  • 在编译时进行格式检查。如@override 放在方法前,如果你这个 方法并不是覆盖了超类方法,则编译时就能检查出。

自定义注解

元注解

  • 元注解的做哟个是负责注解其他注解,java中定义了四个标准的 meta-annotation类型,他们被用来提供对其他annotation类型 作说明
  • 这些类型和它们所支持的类在java.lang.annotation包中
    – @Target:用来描述注解的使用范围(注解可以用在什么地方)
    – @Retention:表示需要在什么级别保存该注释信息,描述注解的生命周期
  • Source < Class < Runtime
    – @Document:说明该注解将被包含在javadoc中 – @Inherited:说明子类可以继承父类中的该注解
@MyAnnotation(name = "wang",age=1,likes = {"play"})
public class TestAnnotation {

    @MyAnnotation
    public void test() {

    }
}


//target 用来声明当前自定义注解适合用于什么地方，类、包、方法、变量   --必加
@Target({ElementType.METHOD, ElementType.TYPE})
//retention 用来表示当前注解是用于什么环境  源码、类级别、运行时环境  一般都是运行时环境     --必加
@Retention(RetentionPolicy.RUNTIME)
//表示该注解是否会显示在Java doc 中
@Documented
// 表示当前注解是否能被继承
@Inherited
@interface MyAnnotation {

    //定义的方式看起来像是方法，但是实际上是用在使用注解的时候填写的参数的名称，默认的名称是value，只有value一个的时候可以省略value=
    //自定义注解中填写的所有方法都需要在使用注解的时候添加值，所以一般会给默认值
    String name() default "aa";

    int age() default 11;

    String[] likes() default {"asd"};

}

最后多说一句，想玩转注解必须要懂反射，反射这个东西是值得我们去花心思好好扣一遍，因为这个东西用的地方非常多，你看框架源码的时候，到处都是反射，而且这个弄懂之后基本就不会变了，值得花时间好好看看，后续我也会整理一篇关于反射的笔记