2021-06-24--注解

注解

注解的分类：

1、JVM自带注解
2、元注解：用来定义其他注解的注解
3、自定义注解

常用的JVM自带注解：

@Override—重写

常用的元注解：

1、@Target
注解用在哪里：类上、方法上、属性上等

ElementType.TYPE 应用于类的元素
ElementType.METHOD 应用于方法级
ElementType.FIELD 应用于字段或属性(成员变量)
ElementType.ANNOTATION_TYPE 应用于注释类型
ElementType.CONSTRUCTOR 应用于构造函数
ElementType.LOCAL_VARIABLE 应用于局部变量
ElementType.PACKAGE 应用于包声明
ElementType.PARAMETER 应用于方法的参数

2、@Retention
注解的生命周期：源文件中、字节码文件中、运行中（可自定义）

SOURCE在源文件中有效（即源文件保留.java）
CLASS在class文件中有效（即class保留–字节码文件.class）
RUNTIME在运行时有效（即运行时保留）

注解测试：

package cn.tedu.annotation;

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

/*
测试自定义注解，熟悉注解相关规则
 */
public class TestAnnotation {
}

/*1、首先注意：自定义注解语法与java不同，不要套用java的格式*/
 /*
    1、注解定义要使用  @interface 注解名 的方式来定义
    需要通过Target注解来描述当前自定义注解使用的位置
    注意：@Target注解使用需要导包，它的值通过“ElementType静态常量”来指定，如果需要多个值，可以用{ }中间用，隔开
    2、通过@Retention注解表明此自定义注解的生命周期
    注意：@Retention注解使用也需要导包，它的值通过RetentionPolicy静态常量来指定，
    也就是自定义注解可以存活多久：源文件中，字节码文件中，运行时，这三个只能有一个
     */
@Retention(RetentionPolicy.SOURCE)
@Target({ElementType.METHOD,ElementType.FIELD})
@interface Test{
    /*
    自定义注解可以添加功能：给自定义注解添加属性
    注意：int age();不是方法的定义，而是自定义注解中定义age属性的语法
    如果为了使用时方便，还可以给属性指定默认值，这样注解就可以不赋值直接使用
    int age() default 0;

     */
 //   int age();
    int age() default 0;//定义普通的属性，给属性默认值为0
    /*
    注解中可以添加特殊属性value()
    定义方式和普通的属性相同，但是使用的方式不同
     */
    //特殊属性value
    /*
    使用次注解时，属性赋值不需要写属性名，直接赋值就可以--> @Test("apple")
    但是自定义注解中的特殊属性赋予默认值时格式不能简写
    如果给特殊属性赋予默认值，使用时可以不赋值，使用默认值即可---> String value() default "lemon";
     */
    String value() default "lemon";

}

/*
2、使用注解时，只要在自定义注解名字前加@符号即可使用此注解
*/

//测试自定义注解

class TestAnno{
    /*
    测试1:分别给TestAnno类/name属性/eat方法都添加了@Test注解，只有方法上不报错
    结论：自定义注解能加在什么位置，取决于@Target的值

    测试2:修改@Target的值，
    结论：注解@Test可以存在多个位置，如果有多个值，格式为{ ，}
    能存在多个值的原因：Target注解的源码：ElementType[] value();

    测试3:当我们添加了注解的age属性后，@Test注解报错
    结论：当没有给自定义注解定义属性时，可以直接使用但是如果有属性了，必须给属性赋值

    测试4:给@Test注解的属性赋值之后，就不报错了
    结论:给属性值赋值的格式@Test(age = 10)，注意不能直接写值，@Test(10)<---这个是错误的格式

    测试5:给age属性赋值之后，可以不加属性值，直接使用注解，此时使用的属性值是age的默认值

    测试6:给特殊属性value赋值时可以简写，相当于value = “apple”

    测试7:因为两个属性均被设置默认值，所以无需赋值，可以直接使用@Test注解
     */
    String name;
//    @Test(age = 10)
//   @Test(value = "apple")
//    @Test("apple")
    @Test
    public void eat(){
        System.out.println("点个奶茶，加冰淇淋和脆啵啵");
    }
}