注解(Annotation)

注解(Annotation)

什么是注解

Annotation的作用

• 不是程序本身，但可以对程序作出解释(这一点跟注释(comment)没什么区别)
• 可以被其他程序(比如：编辑器)读取

Annotation的格式

• 注解格式“@注释名”，还有一些例外例如：@suppressWarnings(value="unchecked")

Annotation在哪里使用？

• 包，类，方法等等，相当于添加了辅助信息,我们可以通过反射机制编程实现对这些元数据的访问

内置注解

@Override

• 定义在java.lang包下，用于修饰方法，是一个方法准备重写父类的方法的声明##

@Deprecated

• 定义在java.lang包下，用于修饰方法，属性，类，表示不推荐使用，它很危险或有更好的方法

@SuppressWarnings

• 用于抑制警告信息，
• 跟前两个不同，这里你需要添加一个正确参数才能使用，这些参数都是定义好的，我们选择使用就好了

元注解

元注解的作用

• 就是负责注解其他注解，java定义了4个标准meta-annotation类型，他们用来提供对其他annotation类型作说明

那些类型

它们都在java.lang.annotation包中可以找到(@Target,@Retention,@Documented,@Inherited)

@Target

• 用于描述注解的使用范围

@Retention

• 表示需要在什么级别保持该注释信息，用于描述注解的生命周期(SOURCE<CLASS<RUNTIME)

@Documented

• 说明该注解将被包含在javadoc中

@Inherited

• 说明子类可以继承父类中的该注解

自定义注解

//定义一个注解
//Target 表示我们的注解可以用在那些地方
@Target(value ={ElementType.METHOD,ElementType.TYPE})
//RUNTIME 表示我们的注解在什么地方还有用(SOURCE<CLASS<RUNTIME)
@Retention(RetentionPolicy.RUNTIME)
//Deprecated 表示是否将我们的注解生成在文档中
@Deprecated

//interface 表示子类可以继承父类的注解
@interface MyAnnotation{

}

引用狂神注解视频中分析

public class Test02 {

    //注解可以显示赋值，如果没有默认值，我们就必须给注解赋值
    @MyAnnotation02(age = 18,name = "青牛")
    public void test01(){

    }
    @Myannotation03("青牛")
    public void test02(){

    }
}

@Target({ElementType.METHOD,ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation02{
    //注解的参数：参数类型+参数名();
    String name() default "";//default 代表默认值
    int age();
    int id() default -1;//如果默认值为-1，代表不存在

    String[] schools() default {"北京大学","清华大学"};
}

@Target({ElementType.METHOD,ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@interface Myannotation03{
    String value();
}