package cn.JAVandReflection.AnnotationTest;
import java.lang.annotation.*;
/**
* 介绍什么是注解，以及自定义注解：
* Annotation:
* 作用：方便阅读程序、 对程序的检查和约束、 可以被其他程序读取（如用反射操作注解，ORM内部的一些原理等下一期讲解）作用对象：
* 注解可以作用在包、类、方法、属性等上面
* 常见注解：
* @Override
* @Deprecated <:不赞成、反对> 不推荐使用某个方法等时使用
* @FunctionalInterface 函数式接口使用
* 本质： 接口
* 理解概念：
* 元注解： 用于描述注解的注解 单词： meta-annotation
* 常见的元注解：
* @Target : 用于描述注解的作用范围，即被描述的注解可以作用在什么地方，是类、方法亦或是变量
* @Retention: <:保留>表示什么级别保存该注解信息，用于描述注解的生命周期 三个周期： SOURCE < CLASS < RUNTIME
* 注意： 自定义的一般都是 RUNTIME
* @Document: 说明该注解是否被博阿寒在javadoc中
* @Inherited: <：继承的>表明子类可以继承父类的注解
* 自定义注解： 用下面代码简单理解
*/
// 下面自定义一个注解
@Target(value = {ElementType.FIELD, ElementType.TYPE})
/**
* ElementType 这个枚举类型里面限制了我们要使用的字段：但是常用的有以下几个
* .TYPE 表示作用域是类
* .FIELD 表示作用域是变量
* .METHOD 表示作用域是方法
* 可以同时设置作用多个作用域
*/
@Retention(value = RetentionPolicy.RUNTIME)
/*
RetentionPlicy 同样枚举类型 至于三个 SOURCE CLASS RUNTIME
*/
@Documented // 表示转成文档时候保留
@Inherited // 表示子类可以继承该注解
@interface myAnnocation { // 这个名就是注解名
// 里面写注解描述参数即可，他们是参数，但是样子像方法
String name();
String id();
int age() default 18; // 可以这样的形式设置一个默认值
// 以下这个仅演示可行性
char[] a() default {'d', 'b'};
}
// 通过上面方式简单定义了一个注解 注解的基本使用如下
/*
注意点： 定义过的注解参数而且没有设置默认值的必须像@Retention(value = RetentionPolicy.RUNTIME)
写上，但是 @Retention(RetentionPolicy.RUNTIME) 你们可能看见遮掩的形式：
因为， 在注解参数只有一个，且其名字为value时候，可以省略写，下面是上面的省略写法
*/
// 简单使用 这样就可以注解啦 ，当然 我们的作用域还有变量，我们也可以在变量上使用
@myAnnocation(name="WhatAnnotation Class", id="001")
public class WhatAnnotation {
// 这样是可行
@myAnnocation(name="name field", id="001-1")
String name ;
public WhatAnnotation() {
}
}
