注解

package com.atfu.java1;

import java.util.ArrayList;

/**
 * 注解的使用
 * 1.理解Annotation
 * ① jdk5.0新增的功能
 * ② Annotation其实就是代码里的特殊标记，这些标记可以在编译，类加载，运行时被读取，并执行相应的处理。
 * ③ Annotation可以像修饰符一样被使用，可用于修饰包，类，构造器，方法，成员变量，参数，局部变量的声明，这些信息被
 *   保存在Annotation的 "name = value"对中。
 * 2.Annotation的使用实例
 *      @Override: 限定重写父类方法，该注解只能用于方法
 *      @deprecated: 用于 表示所修饰的元素（类、方法等）已过时。
 *      @suppersswarnings: 抑制编译器警告
 *
 * 3.如何自定义注解：参照@suppersswarnings定义
 *      ① 注解用 @interface 来声明
 *      ② 内部定义成员，通常使用value表示
 *      ③ 可以指定成员的默认值，使用default来定义：String[] value() default "hello";
 *      ④ 如果自定义的注解没有成员，表示是一个标识作用
 *      ⑤ 如果注解有成员，在使用注解时，需要指明成员的值
 *      ⑥ 自定义注解必须配上注解的信息处理流程（使用反射）才有意义
 *      ⑦ 自定义注解通常都会指明两个元注解：Retention、Target
 *      ⑧ Annotation的成员变量在Annotation定义中以无参数方法的形式来声明。其方法名和返回值定义了该成员的名字和类型。我们称为
 *        配置参数。类型只能是八种基本数据类型、String类型、Class类型、Annotation类型、以上所有类型的数组。
 *
 *4.jdk提供的四种元注解
 *  元注解就是用来修饰其他注解的注解
 *  Retention：指定所修饰的Annotation的生命周期：SOURCE/CLASS(默认行为)/RUNTIME
 *              只有声明为RUNTIME生命周期的注解才能通过反射获取。
 *  Target：用于指定被修饰的Annotation能用于修饰哪些程序元素
 *  *********出现的频率较低**********
 *  Documented：表示所修饰的注解在被javadoc解析时，保留下来。默认情况下，javadoc是不包括注解的
 *                >>定义为Documented的注解必须设置Retention值为RUNTIME。
 *  Inherited：被它修饰的Annotation将具有继承性。如果某个类使用了被 @Inherited 修饰的Annotation，则其子类将自动具有该注解
 *
 *  5.jdk8 中注解的新特性：可重复注解、类型注解
 *   5.1可重复注解  ① 在MyAnnotation上声明 @Repeatable，成员值为 MyAnnotation.class
 *                 ②MyAnnotation的Target和Repeatable等元注解需要和MyAnnotations相同
 *   5.2类型注解：
 *              ElementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中（如：泛型声明）。
 *              ElementTYPE_USE 表示该注解能写在使用类型的任何语句中。
 * @author fu jingchao
 * @creat 2021/12/6-16:18
 */
@MyAnnotation(value = "hello")
public class AnnotationTest {
}

class Generic<@MyAnnotation T>{
    public void show() throws @MyAnnotation RuntimeException{
        ArrayList<@MyAnnotation String> list = new ArrayList<>();

        int num  = (@MyAnnotation int)10L;
    }

}

 

package com.atfu.java1;

import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;

/**
 * @author fu jingchao
 * @creat 2021/12/6-16:55
 */
@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE,FIELD,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE, TYPE_PARAMETER,TYPE_USE})
public @interface MyAnnotation {
    String value() default "what?";
}