框架的底层知识--注解

众所周知，注解和反射是框架的底层知识，本人就是因为在 Spring动态代理时学习时觉得很懵逼，特意回来重新学习了一下反射和注解，并整理了相关笔记，希望对你们会有所帮助！

1、注解(Annotation)

1、什么的注解

• Annotation 是从 JDK5.0 开始引入的新技术

• Annotation的作用：

  • 可以对程序作出解释
  • 可以被其他程序（比如编辑器等）读取

• Annotation 的格式：

  • 注解是以“@注释名”在代码中存在，还可以增加一些参数值：例如

    @SuppressWarnings(value=“unchecked”)

• Annotation 在哪里使用？

  • 可以附加在 package，class，method，filed 等上面，相当于给他们添加了额外的辅助信息，我们可以通过反射机制编程实现对这些元数据的访问

2、内置注解

@Override：定义在java.lang.Override 中，此注释只适用于修辞方法，表示一个方法声明打算重写超类中的另一个方法声明。

@Deprecated：定义在java.lang.Deprecated 中，此注释只适用于修辞方法、属性、类，表示不鼓励程序员使用这样的元素，通常是因为它很危险或者存在更好的选择。

@SuppressWarnings：定义在java.lang.SuppressWarnings 中，用来抑制编译时的警告信息。

• 和前两个注解有所不同，你需要添加一个参数才能正常使用，这些参数都是已经定义好的，我们进行选择性使用即可。
• 例如：all，unchecked，deprecation 等。

测试代码如下：

import java.util.ArrayList;

public class Test {
    @Override
    public String toString() {
        return super.toString();
    }
    
    @Deprecated
    public static void test(){
        System.out.println("测试 Deprecated");
    }

    @SuppressWarnings("all")
    public static void test01(){
        // 正常此处的 arraylist 颜色会是灰色的,把鼠标定在此处会出现该变量并没有使用,但是现在添加了
        // @SuppressWarnings("all")后,颜色变成已经被调用了一样,相当于抑制了所有的警告信息
        ArrayList arrayList = new ArrayList();
    }
    
    public static void main(String[] args) {
        test();
    }
}

3、元注解

• 元注解的作用就是负责注解其他注解，Java 定义了 4个标准的 meta-annotation 类型，他们被用来提供给其他的 annotation 类做说明。

• 这些类型和它们所支持的类在 java.lang.annotation 包可以找到，
  (@Target 、 @Retention、@Documented、@Inherited)

  • @Target：用来描述注解的使用范围（即：被描述的注解可以使用在什么地方）。

  • @Retention：表示需要在什么级别保存该注解信息，用来描述注解的生命周期。

    • Source < Class < Runtime
  • @Documented：说明该注解将被包含到 javadoc 中。
  • @Inherited：说明子类可以继承父类中的该注解。

测试代码如下：

import java.lang.annotation.*;

@MyAnnotation
public class Test01 {

    public void test(){

    }
    public static void main(String[] args) {
    }
}

// @Target 表示我们的注解可以作用在哪一个地方
@Target(value = ElementType.TYPE)

// @Retention 表示我们的注解在什么地方还有效 runtime > class > source
@Retention(value = RetentionPolicy.RUNTIME)

// @Documented 表示我们的注解是否生成到我们的 javadoc 中
@Documented

// @Inherited 表示我们的注解是否能被继承
@Inherited
@interface MyAnnotation{
}

4、自定义注解

• 使用@interface自定义注解时，自动继承了 java.lang.annotation.Annotation 接口

• 分析

  • @interface 用来声明一个注解，格式： public @interface 注解名{定义内容}
  • 其中的每一个方法实际上都是声明了一个配置参数
  • 方法的名称就是参数的名称
  • 返回值类型就是参数的类型（返回值只能是基本类型，Class，String，enum）
  • 可以通过 default 来声明参数的默认值
  • 如果只有一个参数成员，一般参数名为value
  • 注解元素必须要有值，我们定义注解元素时，经常使用空字符串，0 作为默认值

测试代码如下：

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

/**
 * 自定义注解
 */
public class Test02 {
    
    @MyAnnotation2(age = 18,name = "白衣")
    public void test1(){
        
    }
    
    @MyAnnotation3("白衣")
    public void test2(){
        
    }
}

@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation2{
    // 定义变量的格式 变量类型 变量名();
    String name() default "";
    int age() ;
    String[] schools() default {"清华","北大"};
}

// 参数为一个时,默认为为 value
@interface MyAnnotation3{
    String value();
}