Java注解和反射

Posted 2022-01-15 想成为大师啊

参考B站狂神说，整理笔记

1、什么是注解

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

Annotation的作用：

• 不是程序本身，可以对程序做出解释。（这一点和注释(comment)没什么区别）
• 可以被其他程序（比如：编译器等）读取 可以实现动态型

Annotation的格式：

• 注解是以 “@注释名” 在代码中存在的，还可以添加一些参数值，例如： @SuppressWarnings(value=“unchecked”).
• 注解还有检查规范名

Annotation在哪里使用：

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

---

2、内置注解

• @Override：定义在java.lang.Override中，此注释只适用于修辞方法，表示一个方法声明打算重写超类中的另一个方法声明
• @Deprecated：定义在java.lang.Deprecated中，此注释可以用来修辞方法，属性，类，表示 不鼓励程序员使用这样的元素，通常是因为它很危险或者存在更好的选择
• @SuppressWarnings：定义在java.lang.SuppressWarnings中，用来抑制编译时的警告信息。
  • 与前两个注释有所不同，你需要添加一个参数才能正确使用，这些参数都是已经定义好了的。我们选择性的使用就好了
  • @SuppressWarnings(“all”)
  • @SuppressWarnings(“unchecked”);
  • @SuppressWarnings(value=“unchecked”,“deprecation”);
  • 等等…

package com.blb.annotation;

import java.util.ArrayList;
import java.util.List;

public class Test01 extends Object 

    // @Override 重写的注解
    @Override
    public String toString() 
        return super.toString();
    

    // @Deprecated 不推荐程序员使用，但是可以使用，或者存在更好的方式
    @Deprecated
    public static void test()
        System.out.println("Deprecated");
    

    // @SuppressWarnings: 镇压警告
    @SuppressWarnings("all")
    public void test02()
        List list = 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）
• @Document：说明该注解将被包含在javadoc中
• @Inherited：说明子类可以继承父类中的该注解

package com.blb.annotation;

import java.lang.annotation.*;

@MyAnnotation_Target()
// 测试元注解
public class Test02 

    @MyAnnotation_Target()
    public void test()

    


// 定义一个注解
// Target 表示我们的注解可以用在哪些地方
@Target(value = ElementType.METHOD, ElementType.TYPE)
@interface MyAnnotation_Target

定义一个注解
Target 表示我们的注解可以用在哪些地方

@Target(value = ElementType.METHOD, ElementType.TYPE)
@interface MyAnnotation_Target

Retention 表示我们的注解在什么地方还有效
runtime > class > sources

@Retention(value = RetentionPolicy.RUNTIME)
@interface MyAnnotaion_Retention

@Documented 表示是否将我们的注解生成在JAVAdoc中

@Documented
@interface MyAnnotation_Documented

@Inherited 子类可以继承父类的注解

@Inherited
@interface MyAnnotation_Inherited

---

4、自定义注解

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

分析：

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

package com.blb.annotation;

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

// 自定义注解
public class Test03 

    // 注解可以显示赋值，如果没有默认值，我们就必须给注解赋值
    @MyAnnotation(age = 18)
    public void test() 

    @MyAnnotation3("华科")
    public void test2()


@Target(ElementType.TYPE, ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation
    // 注解的参数 : 参数类型 + 参数名();
    String name() default "";
    int age() default 0;
    int id() default -1;    // 如果默认值为-1，代表不存在，indexof，如果找不到就返回-1
    String[] schools() default "华中科技大学", "清华大学";


@Target(ElementType.TYPE, ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation3
    String value();