JavaWeb1.3.2【基础加强：自定义注解（格式、本质、属性、元注解）】

package com.yubaby.annotation;

import com.yubaby.domain.Person;

/*
* 自定义注解
*
    * 格式：
        元注解
        public @interface 注解名称{
            属性列表;
        }

    * 本质：注解本质上就是一个接口，该接口默认继承Annotation接口
        * public interface MyAnno extends java.lang.annotation.Annotation {}

    * 属性：接口中的抽象方法
        * 要求：
            1. 属性的返回值类型有下列取值
                * 基本数据类型
                * String
                * 枚举
                * 注解
                * 以上类型的数组

            2. 定义了属性，在使用时需要给属性赋值
                1. 如果定义属性时，使用default关键字给属性默认初始化值，则使用注解时，可以不进行属性的赋值。
                2. 如果只有一个属性需要赋值，并且属性的名称是value，则value可以省略，直接定义值即可。
                3. 数组赋值时，值使用{}包裹。如果数组中只有一个值，则{}可以省略

    * 元注解：用于描述注解的注解
        * @Target：描述注解能够作用的位置
            * ElementType取值：
                * TYPE：可以作用于类上
                * METHOD：可以作用于方法上
                * FIELD：可以作用于成员变量上
        * @Retention：描述注解被保留的阶段
            * @Retention(RetentionPolicy.RUNTIME)：当前被描述的注解，会保留到class字节码文件中，并被JVM读取到
        * @Documented：描述注解是否被抽取到api文档中
        * @Inherited：描述注解是否被子类继承
 */
public @interface MyAnno {

    int value(); //基本数据类型
    People peo(); //枚举
    MyAnno2 an2(); //注解
    String[] strArr(); //String数组

//    void show(); //报错，不能是void
//    Person per(); //报错，不能是类 类型
    //返回值只能是上述5种
}

@interface MyAnno3{
    int value();
}

@interface MyAnno4{
    int age();
    String name();
    String sex() default "男男"; //
}

package com.yubaby.annotation;

/*
枚举类
 */
public enum People {
    P1, P2;
}

package com.yubaby.annotation;

@MyAnno(value = 11, peo = People.P1, an2 = @MyAnno2, strArr = {"111", "abc"})
@MyAnno4(age = 12, name = "tom") //若注解定义了属性，则在使用时必须给无默认值的属性赋值，不然使用类注解报错
@MyAnno3(666) //如果只有一个属性需要赋值，并且属性的名称是value，则value可以省略，直接定义值即可
@MyAnno5
public class Worker {

//    @MyAnno5 //报错
//    public String name;

    /*@MyAnno5 //报错
    public void show(){

    }*/

}

package com.yubaby.annotation;

//此处虽然没有显示写明@MyAnno5注解，
// 但父类Worker类写明了@MyAnno5注解，
// 且自定义的@MyAnno5注解中写明了元注解@Inherited，即父类使用的注解会被子类继承
public class Teacher extends Worker{
}

package com.yubaby.annotation;

import java.lang.annotation.*;

/*
 * 元注解：用于描述注解的注解
     * @Target：描述注解能够作用的位置
            * ElementType取值：
                 * TYPE：可以作用于类上
                 * METHOD：可以作用于方法上
                 * FIELD：可以作用于成员变量上
     * @Retention：描述注解被保留的阶段
            * @Retention(RetentionPolicy.RUNTIME)：当前被描述的注解，会保留到class字节码文件中，并被JVM读取到
     * @Documented：描述注解是否被抽取到api文档中
     * @Inherited：描述注解是否被子类继承
 */

@Target(value = {ElementType.TYPE}) //表明该MyAnno5注解只能作用于类上
// Target注解的value属性是一个数组，也可以添加其他取值，使MyAnno5注解可以作用于方法和成员变量上
// Target注解只有一个属性value需要进行赋值，所以可以省略，直接写@Target({ElementType.TYPE})
// 另外在本例中，因为value属性的值数组中仅设置了一个值，所以还可以省略，直接写@Target(ElementType.TYPE)也行
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface MyAnno5 {
}