Java注解

注解，不仅仅是给人看的，还给程序看，还能被程序读取

一、什么是注解

1、Annotation是从JDK5.0开始引入的新技术

2、Annotation的作用

　　(1)、不是程序本身，可以对程序做出解释(这一点和注释(Comment)没什么区别)

　　(2)、可以被其他程序（比如编译器）读取

3、Annotation的格式:

　　(1)、注解是以“@注释名”在代码中存在的，还可以添加一些参数值，例如:@SuppressWarnings(value="all").

4、Annotation在哪里使用

　　(1)、可以附加在package、class、method、field等上面，相当于给他们添加了额外的辅助信息，我们可以通过反射机制编程实现对这些元数据的访问。

二、常用的内置注解

@Override：这个大家应该不陌生，重写。定义在java.lang.Override中，此注解只适用于修辞方法，表示一个方法声明打算重写超类中的另一个方法的声明

@Deprecated:定义在java.lang.Deprecated中，此注解可以用于修辞方法、属性、类，表示不鼓励程序员使用这样的元素，通常是因为它很危险，或者存在更好的选择

@SuppressWarnings：定义在java.lang.SuppressWarnings中，用来抑制编译时的警告信息，与前两个注解有所不同，你需要添加一个参数才能正确的使用，这些参数都是定义好了的，我们选择性使用就好了。

　　@SuppressWarnings("all");

　　@SuppressWarnings("unchecked");

　　@SuppressWarnings(value={"unchecked","deprecation"});

我对这几个参数的理解是:

@Override：重写，必须对父类的方法重写

@Deprecated:就是你使用这个注解过的方法或者属性时，它会出现一个中穿线。比如:Date date = new Date("2019-07-11");它可以使用，但是不推荐使用，可能会出现bug

@SuppressWarnings("all"):比如你定义了一个变量，而没有去使用它，它就会提醒你。但是使用这个注解，那么它就是不会提醒你。慎用！！

三、元注解

1、元注解的作用是负责注解其他注解，java定义了四个标准的meta-annotation类型，他们被用来提供对其他annotation类型作说明

2、这些类型和它们所支持的类在java.lang.annotation包中可以找到(@Target,@Retention,@Documented,@Inherited)

　　@Target:用于描述注解的使用范围(即:被描述的注解可以用在什么地方)

　　@Retention:表示需要在什么级别保存该注释信息，用于描述注解的生命周期(SOURCE<CLASS<RNTIME)

　　@Documented:说明该注解将被包含在javadoc中

　　@Inherited:说明子类可以继承父类中的该注解

//Target表示我们的注解可以用在哪些地方
@Target(value={ElementType.METHOD,ElementType.Type})
//Retention表示我们的注解在什么地方还有效
@Retention(value=RetentionPolicy.RunTime)
//@Documented:表示是否将我们的注解生成灾javadoc中
@Documented
//Inherited表示子类可以继承父类的注解
@Inherited
@interface myAnnotation{
}

四、自定义注解

1、使用@Interface自定义注解时，自动继承了java.lang.Annotation接口

2、分析:

　　2.1、@interface用来声明一个注解，格式:public @interface 注解名{自定义的内容}

　　2.2、其中的每一个方法实际上是声明了一个配置参数

　　2.3、方法的名称就是参数的名称

　　2.4、返回值类型就是参数的类型（返回值只能是基本类型，class，String，enum）

　　2.5、可以通过default来声明参数的默认值

　　2.6、如果只有一个参数成员，一般参数名为value

　　2.7、注解元素必须要有值，我们定义注解元素时，经常使用空字符串或者0，作为默认值

例如:

public class Test{

//注解可以显示赋值，如果没有默认值，我们必须给注解赋值
@myAnnotation()
public void test(){

}


//Target表示我们的注解可以用在哪些地方
@Target(value={ElementType.METHOD,ElementType.Type})
//Retention表示我们的注解在什么地方还有效
@Retention(value=RetentionPolicy.RunTime)
//@Documented:表示是否将我们的注解生成灾javadoc中
@Documented
//Inherited表示子类可以继承父类的注解
@Inherited
@interface myAnnotation{
      String name() default "";
        int id() default 0;
        String[] Arr() default{"aaa","bbb"};
    }
//注意：如果注解只是定义一个参数，可以取名为value，在调时，
//value可以省略
}