Java进阶-注解

1.生成帮助文档。这是最常见的，也是 Java 最早提供的注解。常用的有 @see、@param 和 @return 等；
2.跟踪代码依赖性，实现替代配置文件功能。比较常见的是 Spring 2.5 开始的基于注解配置。作用就是减少配置。现在的框架基本都使用了这种配置来减少配置文件的数量；
3.在编译时进行格式检查。如把 @Override 注解放在方法前，如果这个方法并不是重写了父类方法，则编译时就能检查出。

public class AnnotationDemo {
    private String name="";
    private int age;
    //...
    //@Override注解： 告诉编译器检查这个方法，保证父类要包含一个被该方法重写的方法，否则就会编译出错。
    @Override
    public String t0String(){ // toString写错，@Override下面会有红色波浪线提示(Method does not override method from its superclass)
        return "Person [name="+name+",age="+age+"]";
    }
}

@Deprecated
public class Person {
    @Deprecated
    protected String name;
    private  int age;

    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public int getAge() {
        return age;
    }
    public void setAge(int age) {
        this.age = age;
    }
    @Deprecated
    public void setNameAndAge(String name,int age){
        this.name=name;
        this.age=age;
    }
    @Override
    public String toString(){
        return "Person[name"+name+",age="+age+"]";
    }
}

forRemoval：指定该 API 在将来是否会被删除。
since：指定该 API 从哪个版本被标记为过时。

class Test {
    // since属性指定从哪个版本开始被标记成过时，forRemoval指定该API将来会被删除
    @Deprecated(since = "9", forRemoval = true)
    public void print() {
        System.out.println("你好，李四！");
    }
}
public class DeprecatedTest {
    public static void main(String[] args) {
        // 下面使用info()方法时将会被编译器警告
        new Test().print();
    }
}

public class PersonTest {
    @SuppressWarnings({ "deprecation" })
    public static void main(String[] args) {
        Person p = new Person();
        p.setNameAndAge("zhangsan",22);
        p.name="lishi";
    }
}

public class Test {
    public static void main(String[] args) {
        // 传递可变参数，参数是泛型集合
        display(10, 20, 30);
        // 传递可变参数，参数是非泛型集合
        display("10", 20, 30); // 会有编译警告
    }
    public static <T> void display(T... array) { // 可变参数形式：方法名(类型...数组名)
    //方法display()提示Annotate as '@SafeVararg'(即要在上一行添加@SafeVararg注解)
        for (T arg : array) {
            System.out.println(arg.getClass().getName() + ":" + arg);
        }
    }
}

java.lang.Integer:10
java.lang.Integer:20
java.lang.Integer:30
java.lang.String:10
java.lang.Integer:20
java.lang.Integer:30

// 使用@FunctionalInterface修饰函数式接口。
public interface FunInterface {
    static void print() { // 静态方法
        System.out.println("我的个人网站：https://zhengyquan.gitee.io/");
    }
    default void show() {
        System.out.println("我的腾讯云社区首页：https://cloud.tencent.com/developer/user/10491946");
    }
    void test(); // 只定义一个抽象方法
}
// @FunctionalInterface 注解的作用只是告诉编译器检查这个接口，保证该接口只能包含一个抽象方法，否则就会编译出错。

public @interface Test {}

1.标记注解：没有定义成员变量的注解类型（仅利用自身的存在与否来提供信息）
2.元数据注解：包含成员变量的注解，由于可以接受更多的元数据，也被称为元数据注解。

// 定义一个标记注解
public @interface Test {
}

public @interface MyTag {
    // 定义带两个成员变量的注解
    // 注解中的成员变量以方法的形式来定义
    String name();
    int age();
    // 成员变量也可以有访问权限修饰符，但是只能有公有权限和默认权限。
}

public class Test {
    // 使用带成员变量的注解时，需要为成员变量赋值
    @MyTag(name="xx", age=6)
    public void info() {
        ...
    }
    ...
}

public @interface MyTag {
    // 定义了两个成员变量的注解
    // 使用default为两个成员变量指定初始值
    String name() default "李四";
    int age() default 18;
}

public class Test {
    // 使用带成员变量的注解
    // MyTag注释的成员变量有默认值，所以可以不为它的成员变量赋值
    @MyTag
    public void info() {
        ...
    }
    ...
}