Java自定义注解

Java自定义注解

简介：

  Annotation是Java5开始引入的新特征，它提供了一种安全的类似注释的机制，用来将任何的信息和元数据（metadata）与程序元素（类、方法、成员变量等）进行关联。为程序的元素加上更直观的说明，这些说明信息是与程序的业务逻辑无关，并且供指定的工具或框架使用。它是附加在代码中的一些元信息，用于一些工具在编译、运行时进行解析和使用，起到说明、配置的功能。注解不会也不能影响代码的实际逻辑，仅仅起到辅助性的作用，包含在java.lang.annotation包中。

注解的作用：

1. 生成文档：这是最常见的也是Java最早提供的注解，常用的有@param、@return等；
2. 跟踪代码依赖性，实现替代配置文件功能；
3. 在编译时进行格式检查，如@override放在方法上，如果该方法不是覆盖了父类方法，则编译时就能检查出来；

内置注解：

1. @Override：定义在java.lang.Override中，此注释只适用于修饰方法，表示一个方法声明打算重写超类中的另一个方法声明；
2. @Deprecated：定义在java,lang.Deprecated中，此注释可以修饰方法、属性、类，表示不鼓励程序员使用这样的元素，通常是因为它很危险或者存在更好的选择；
3. @SuppressWarnings：定义在java.lang.SupressWarnings中，用来抑制编写编译时的警告信息；

元注解：

  元注解的作用是负责注解其他注解，Java中定义了四个标准的meta-annotation类型，这些类型和它们所支持的类在java.lang.annotation包中。定义注解时，必须说明Target和Retention，该注解的属性默认为value，也可以自行定义。属性可以有默认值，如果没有定义默认值，则需要在使用注解时输入相应的参数。

1. @Target：用来描述注解的使用范围（注解可以用在什么地方）；
2. @Retention：表示需要在什么级别保存该注释信息，描述注解的生命周期，Source<Class<Runtime;
3. @Document：说明该注解将被包含在javadoc中；
4. @Inherited：说明子类可以继承父类；

示例：

@MyAnnotation(id = 2,name = "lisi",classes = {"Chinese","Math","English"})
public class MetaAnnotation {
    
}


@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@interface MyAnnotation{
    int id() default 1;
    String name() default "ZhangSan";
    String[] classes() default {"java","python","php"};
}