注解元数据指什么呢?

注解元数据简介

注解元数据(Annotation Metadata)是
  指在Java注解中
     包含的所有信息
     包括注解的类型、属性名称及其对应的值

===================================================================================
这些元数据在运行时可以通过反射机制访问和处理

1.注解元数据定义

注解元数据是注解本身及其属性的集合。具体来说，它包括：
	-注解类型:注解的全限定名
	     (例`org.springframework.stereotype.Component`)
	-属性名称:注解中定义的各个属性的名称 
	-属性值：注解中各个属性对应的值 

2.注解元数据作用

注解元数据在Java和Spring框架中扮演着重要的角色，主要用于以下方面：
	-配置管理:通过注解配置应用程序的行为，减少 XML 配置的使用
	-依赖注入:Spring 使用注解(如 `@Autowired`、`@Inject`)来管理依赖关系
	-AOP(面向切面编程):通过注解(如 `@Aspect`、`@Before`、`@After`)定义切面和通知
	-组件扫描:通过注解(如 `@Component`、`@Service`、`@Repository`)标识可被Spring 容器管理的组件
	-事件处理:通过注解(如 `@Eventlistener`)定义事件监听器 

3.访问注解元数据

在Java中
  可通过反射机制访问注解元数据
  Spring框架提供了多种工具类和接口来简化这一过程
  其中`StandardAnnotationMetadata`是一个重要的实现

使用反射访问注解元数据
import java.lang.annotation.Annotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.lang.reflect.Method;

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.Runtime)
@interface MyAnnotation {
    String value();
    int count() default 1;
}

class MyClass {
    @MyAnnotation(value = "example", count = 2)
    public void myMethod() {
        // 方法内容
    }
}

public class AnnotationMetadataExample {
    public static void main(String[] args) throws NoSuchMethodException {
        Method method = MyClass.class.getMethod("myMethod");
        Annotation annotation = method.getAnnotation(MyAnnotation.class);

        if (annotation instanceof MyAnnotation) {
            MyAnnotation myAnnotation = (MyAnnotation) annotation;
            System.out.println("Value: " + myAnnotation.value());
            System.out.println("Count: " + myAnnotation.count());
        }
    }
}

输出： 
Value: example
Count: 2

使用Spring的 `StandardAnnotationMetadata`

Spring提供`StandardAnnotationMetadata`类来简化注解元数据的访问

import org.springframework.core.type.StandardAnnotationMetadata;
import org.springframework.stereotype.Component;

import java.util.Map;

@Component
public class MyComponent {
    // 类内容
}

public class StandardAnnotationMetadataExample {
    public static void main(String[] args) {
        // 从类创建 StandardAnnotationMetadata 实例
        StandardAnnotationMetadata metadata =
     		StandardAnnotationMetadata.from(MyComponent.class);

        // 检查是否存在 @Component 注解
        if (metadata.hasAnnotation(Component.class.getName())) {
            System.out.println("MyComponent 类上有 @Component 注解");
        }

        // 获取 @Component 注解的属性值
        Map<String, Object> attributes =
   	    	metadata.getAnnotationAttributes(Component.class.getName());
        String value = (String) attributes.get("value");
        System.out.println("Component 注解的 value 属性值: " + value);
    }
}

输出：
MyComponent 类上有 @Component 注解
Component 注解的 value 属性值: 

4.核心接口和类

Spring 框架中与注解元数据相关的几个核心接口和类包括:
-`AnnotationMetadata`
  -接口，定义了访问注解元数据的基本方法。
  -主要方法：
    -`hasAnnotation(String annotationName)`:检查是否存在指定的注解
    -`getAnnotationAttributes(String annotationName)`:获取指定注解的所有属性值
    -`getAnnotationTypes()`:获取所有注解的全限定名
    -`getClassName()`:获取被注解的类的全限定名

-`StandardAnnotationMetadata`
  - 实现`AnnotationMetadata` 接口
       提供了从类或注解创建注解元数据的功能。
  - 主要方法：
    -`from(Class<?> introspectedClass)`:从类创建`StandardAnnotationMetadata`实例
    -`from(Annotation annotation)`:从注解创建`StandardAnnotationMetadata`实例

-`AnnotationAttributes`
  -表示注解的所有属性及其值。
  -主要方法：
    -`get(String attributeName)`:获取指定属性的值
    -`getString(String attributeName)`:获取指定属性的字符串值
    -`getNumber(String attributeName)`:获取指定属性的数值

5.使用场景

 
(1)组件扫描
  Spring在扫描类路径时
   使用`StandardAnnotationMetadata`来检查类上是否存在`@Component`
    及其派生注解(如`@Service`、`@Repository`)
	 从而注册这些类为Spring Bean 
	 
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@ComponentScan(basePackages = "com.example")
public class AppConfig {
    // 配置内容
}
 
(2)配置类处理
`ConfigurationClassPostProcessor`
  使用 `StandardAnnotationMetadata`来
   处理`@Configuration`类及其方法上的注解
    例
	 `@Bean` 和 `@Import` 
	 
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class AppConfig {

    @Bean
    public MyService myService() {
        return new MyService();
    }
}

(3)AOP 配置
Spring AOP
  使用`StandardAnnotationMetadata`来处理切面类和通知方法上的注解
   例
    `@Aspect` 和 `@Before`

import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class MyAspect {

    @Before("execution(* com.example.*.*(..))")
    public void beforeAdvice() {
        System.out.println("Before advice executed");
    }
}

(4)事件监听
Spring使用`StandardAnnotationMetadata`
 处理`@EventListener`注解
 注册事件监听器

import org.springframework.context.event.EventListener;
import org.springframework.stereotype.Component;

@Component
public class MyEventListener {

    @EventListener
    public void handleEvent(MyEvent event) {
        System.out.println("Event received: " + event);
    }
}

使用`StandardAnnotationMetadata`
从类和注解创建注解元数据实例
并访问注解信息

自定义注解
 
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyCustomAnnotation {
    String value() default "";
    int count() default 1;
}
 
使用自定义注解的类
@MyCustomAnnotation(value = "MyValue", count = 3)
public class MyAnnotatedClass {
    // 类内容
}

访问注解元数据

import org.springframework.core.type.StandardAnnotationMetadata;
import java.util.Map;

public class AnnotationMetadataExample {
    public static void main(String[] args) {
        // 从类创建 StandardAnnotationMetadata 实例
        StandardAnnotationMetadata metadata = 
		  StandardAnnotationMetadata.from(MyAnnotatedClass.class);

        // 检查是否存在 MyCustomAnnotation 注解
        if (metadata.hasAnnotation(MyCustomAnnotation.class.getName())) {
            System.out.println("MyAnnotatedClass 类上有 MyCustomAnnotation 注解");
        }

        // 获取 MyCustomAnnotation 注解的所有属性值
        Map<String, Object> attributes =
     		metadata.getAnnotationAttributes(MyCustomAnnotation.class.getName());
        String value = (String) attributes.get("value");
        int count = (Integer) attributes.get("count");

        System.out.println("MyCustomAnnotation 注解的 value 属性值: " + value);
        System.out.println("MyCustomAnnotation 注解的 count 属性值: " + count);
    }
}
  
=======输出==================
 
MyAnnotatedClass 类上有 MyCustomAnnotation 注解
MyCustomAnnotation 注解的 value 属性值: MyValue
MyCustomAnnotation 注解的 count 属性值: 3