Java 注解

//1. 定义一个接口
interface Info{
    void show();
}
//2. 创建一个类,实现接口 info 实现方法~
class Student implements Info{
    //一般工具都会自动加一个注解, 
    //	表示： 改方法是实现接口的重写方法(); 当然不加也没啥事情,只是一个程序提示~
    @Override
    public void show() {   }
}

Date date = new Date(2000,9,9); 
//这段代码并不会报错：创建一个日期对象 2000-09-09 日期对象;
//	但 new Date(); 方法上会有一个 删除线， 提示改方法以及淘汰~

//ctrl+右击  查看源码发现,改方法被注解为已淘汰~
@Deprecated
public Date(int year, int month, int date) {
    this(year, month, date, 0, 0, 0);
}

/** 自定义注解1.0 */
@Retention(RetentionPolicy.RUNTIME)					//一种元注解: 标识注解的执行生命周期 (什么时候被执行！)
public @interface MyAnnotation {

    //这是自定义注解中,属性的声明方式: 数据类型 参数名;
//    String value();

    //指定成员变量的初始值可使用 default 关键字
    String value() default "wsm";                   /** 如果只有一个参数成员，建议使用参数名为value */
}

package com.wsm.anotation;
import java.lang.annotation.Annotation;
/** 步骤2 */
public class TestAnnotation {
    public static void main(String[] args) {
        //使用反射,来完成注解是实习,这里只是简单的输出.
        //  很多时候反射,扫描所有的类,并判断注解的参数 完善类添新的功能~
        Class clazz = Wsm.class;
        Annotation[] annotations = clazz.getAnnotations();      //获取当前类的注解集合~
        for(int i = 0;i < annotations.length;i++){              //输出注解集合的值！
            System.out.println(annotations[i]);
        }
    }
}

/** 步骤1 */
//@MyAnnotation                     //啥也不写默认值~
//@MyAnnotation(value = "abc")      //手动填写
@MyAnnotation("efg")              //如果注解的只有一个属性且属性名是 value: 可以省略不写
class Wsm{
    //一个空的类,使用 自定义注解~
    @MyAnnotation
    public void show(){
        System.out.println("show方法()");
    }
}

**RetentionPolicy.SOURCE**
- **注解只在源码阶段保留，在编译器进行编译时它将被丢弃忽视**

**RetentionPolicy.CLASS**
- **当运行Java 程序时, JVM不会保留注解，这是`默认值`**
- **实例：** `@Override、@Deprecated、@SuppressWarnning`

**RetentionPolicy.RUNTIME**
- **当运行 Java 程序时, JVM 会保留注释，`程序可以通过反射获取该注释`**
- **实例：** `@Controller、@Autowired、@RequestMapping`
- `自定义注解,想要被扫描到,需要添加改注解 @Retention(RetentionPolicy.RUNTIME)`

顾名思义，这个元注解肯定是和文档有关。它的作用是能够将注解中的元素包含到 Javadoc 中去ElementType.ANNOTATION_TYPE 可以给一个注解进行注解
ElementType.CONSTRUCTOR 	可以给构造方法进行注解
ElementType.FIELD 			可以给属性进行注解
ElementType.LOCAL_VARIABLE 	可以给局部变量进行注解
ElementType.METHOD 			可以给方法进行注解
ElementType.PACKAGE 		可以给一个包进行注解
ElementType.PARAMETER 		可以给一个方法内的参数进行注解
ElementType.TYPE 			可以给一个类型进行注解，比如类、接口、枚举

ElementType.TYPE_PARAMETER	可以给一个泛型进行注解
ElementType.TYPE_USE 		表示该注解能写在使用类型的任何语句中 `声明了改类型就不用在声明其它方式了.`

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotations {
    MyAnnotation[] value();             //注解属性,是可重复注解的数组~
}

import java.lang.annotation.Repeatable;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.RUNTIME)
@Repeatable(MyAnnotations.class)           //1.8新增可重复注解,知道注解容器~
public @interface MyAnnotation {
    String value();                         //参数~
}

import java.lang.annotation.Annotation;

/** 步骤2 */
public class TestAnnotation {
    public static void main(String[] args) {
        //使用反射,来完成注解是实习,这里只是简单的输出.
        //  很多时候反射,扫描所有的类,并判断注解的参数 完善类添新的功能~
        Class clazz = Wsm.class;
        Annotation[] annotations = clazz.getAnnotations();      //获取当前类的注解集合~
        for(int i = 0;i < annotations.length;i++){              //输出注解集合的值！
            System.out.println(annotations[i]);
        }
    }
}

/** 步骤1 */
@MyAnnotation("abc")        //可重复注解,可以一次添加多个属性！
@MyAnnotation("efg")
class Wsm{
    //一个空的类,使用 自定义注解~
    public void show(){
        System.out.println("show方法()");
    }
}

@com.wsm.annotation2.MyAnnotations(value[@com.wsm.annotation2.MyAnnotation(value=abc),@com.wsm.annotation2.MyAnnotation(value=efg)])