Spring中@AliasFor注解的作用及原理

本文基于Springboot 2.1.6.RELEASE 版本分析.

关于@AliasFor注解,曾提过的一个issue Explicit attribute overrides configured via @AliasFor not supported for components picked up via component scanning, 不过从spring 5.2 版本开始已经被修复了

Spring中@AliasFor注解的作用主要是将一个注解上的属性值传递给另一个注解或者将同一个注解类的属性设置互为别名.
但这并不是java原生支持的,需要通过Spring中提供的工具类
org.springframework.core.annotation.AnnotationUtils或者org.springframework.core.annotation.AnnotatedElementUtils来解析。AnnotatedElementUtils内部还是调用的AnnotationUtils

同一个注解类的属性设置互为别名

示例: 如下是一个自定义注解,两个属性互为别名

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface EnableCVS {

    @AliasFor(value = "address")
    String value() default "";

    @AliasFor(value = "value")
    String address() default "";
}


@Configuration
@EnableCVS(address = "hhh")
public class AppConfig {

}

在这里插入图片描述
在这里插入图片描述
因为两个属性互为别名,所以在value没有赋值的情况下,通过AnnotationUtils仍然可以获取到值,而通过java原生的方式则无法获取。
通过上图也可以发现Spring其实是自己实现了jdk动态的拦截器来实现别名功能.

但是有个小小的细节: 如果同时设置address和value的值通过AnnotationUtils#findAnnotation(Class<?>, annotationType)获取属性值,则会抛出如下异常

org.springframework.core.annotation.AnnotationConfigurationException: 
In annotation [com.example.demo.config.EnableCVS] declared on class com.example.demo.config.AppConfig 
and synthesized from [@com.example.demo.config.EnableCVS(value=haha, address=hhh)], 
attribute 'address' and its alias 'value' are present with values of [hhh] and [haha], 
but only one is permitted.

	at org.springframework.core.annotation.AbstractAliasAwareAnnotationAttributeExtractor.getAttributeValue(AbstractAliasAwareAnnotationAttributeExtractor.java:103)
	at org.springframework.core.annotation.SynthesizedAnnotationInvocationHandler.getAttributeValue(SynthesizedAnnotationInvocationHandler.java:91)
	at org.springframework.core.annotation.SynthesizedAnnotationInvocationHandler.invoke(SynthesizedAnnotationInvocationHandler.java:80)
	at com.sun.proxy.$Proxy8.address(Unknown Source)

将一个注解上的属性值传递给另一个注解

例如可以自定义一个注解@MyComponentScan,自定义注解的属性可以传递给Spring中的@ComponentScan的属性。让自定义注解拥有和@ComponentScan一样的功能。

除此之外我们还可以通过@Import注解来实现自己的逻辑,注册自定义bean,让@MyComponentScan拥有比@ComponentScan更多的功能。

SpringBoot的启动注解@SpringBootApplication就是利用了该原理:

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = {
		@Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
		@Filter(type = FilterType.CUSTOM,
				classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {

	@AliasFor(annotation = EnableAutoConfiguration.class)
	Class<?>[] exclude() default {};

	@AliasFor(annotation = EnableAutoConfiguration.class)
	String[] excludeName() default {};

	@AliasFor(annotation = ComponentScan.class, attribute = "basePackages")
	String[] scanBasePackages() default {};

	@AliasFor(annotation = ComponentScan.class, attribute = "basePackageClasses")
	Class<?>[] scanBasePackageClasses() default {};

}

源码及调用栈如下:
在这里插入图片描述
在这里插入图片描述

@AliasFor官方文档解释如下:

@AliasFor是一个用于给其它注解属性声明别名的注解。

使用场景
  • 给注解中的属性显式指明别名:在单个注释中,可以在一对属性上声明@AliasFor,以表示它们是彼此可以互换的别名。 (个人注释:等价的关系,给a赋值,则b也有相同的值,反之亦然,但在使用时不能同时赋值)。

  • 给元注释中属性的显式别名:如果@AliasFor的注释属性设置为与声明它的注释不同的注释,则该属性将被解释为元注释中属性的别名(即显式元注释属性重写)。这样就可以精确地控制在注解层次结构中覆盖哪些属性。实际上,使用@AliasFor甚至可以为元注释的value属性声明别名。

  • 注释中的隐式别名:如果注解中的一个或多个属性被声明和同另一注解中的属性相同(直接或传递),则这些属性将被视为彼此的一组隐式别名,作用类似于注释中显式别名的行为。

使用要求

与Java中的任何注释一样,仅仅存在@AliasFor本身并不能强制实现别名语义。要强制执行别名语义,必须通过AnnotationUtils中的实用工具方法加载注解。在幕后,Spring会将注解封装在动态代理中来合成注解,动态代理透明地强制使用标记@AliasFor的注解属性别名语义。类似地,在注释层次结构中使用@AliasFor时,AnnotatedElementUtils支持显式元注释属性重写。通常您不需要自己手动合成注释,因为在Spring管理的组件上查找注释时,Spring将透明地为您这样做。

实施要求

注释中的显式别名:

  • 构成别名对的每个属性都必须用@AliasFor注释,并且属性或值必须引用别名对中的另一个属性。
  • 别名属性必须声明相同的返回类型。
  • 别名属性必须声明默认值。
  • 别名属性必须声明相同的默认值。
  • 不应声明批注。

元批注中属性的显式别名:

  • 作为元注释中属性的别名的属性必须使用@AliasFor进行注释,并且属性必须引用元注释中的属性。
  • 别名属性必须声明相同的返回类型。
  • 注释必须引用元注释。
  • 引用的元注释必须在声明@AliasFor的注释类上存在。

批注中的隐式别名:

  • 属于一组隐式别名的每个属性都必须使用@AliasFor进行注释,并且属性必须引用同一元注释中的同一属性(直接或通过注释层次结构中的其他显式元注释属性重写进行传递)。
  • 别名属性必须声明相同的返回类型。
  • 别名属性必须声明默认值。
  • 别名属性必须声明相同的默认值。
  • 注释必须引用适当的元注释。
  • 引用的元注释必须在声明@AliasFor的注释类上存在。

示例:注释中的显式别名
@ContextConfiguration中,valuelocations是彼此的显式别名。

public @interface ContextConfiguration {

   @AliasFor("locations")
   String[] value() default {};

   @AliasFor("value")
   String[] locations() default {};

   // ...
}

示例:元注释中属性的显式别名
@XmlTestConfig中,xmlFiles@ContextConfigurationlocations的显式别名。换句话说,xmlFiles覆盖@ContextConfiguration中的locations属性。

@ContextConfiguration
public @interface XmlTestConfig {

   @AliasFor(annotation = ContextConfiguration.class, attribute = "locations")
   String[] xmlFiles();
}

示例:注释中的隐式别名
@MyTestConfig中,valuegroovyscriptxmlFiles都是@ContextConfigurationlocations属性的显式元注解属性重写。因此,这三个属性也是彼此的隐式别名。

@ContextConfiguration
public @interface MyTestConfig {

   @AliasFor(annotation = ContextConfiguration.class, attribute = "locations")
   String[] value() default {};

   @AliasFor(annotation = ContextConfiguration.class, attribute = "locations")
   String[] groovyScripts() default {};

   @AliasFor(annotation = ContextConfiguration.class, attribute = "locations")
   String[] xmlFiles() default {};
}

示例:注释中的传递隐式别名
@GroovyOrXmlTestConfig中,groovy是对@MyTestConfiggroovyscript属性的显式重写;然而,xml是@ContextConfiguration中locations属性的显式重写。此外,groovyxml是相互传递的隐式别名,因为它们都有效地重写了@ContextConfiguration中的locations属性

@MyTestConfig
   public @interface GroovyOrXmlTestConfig {
  
      @AliasFor(annotation = MyTestConfig.class, attribute = "groovyScripts")
      String[] groovy() default {};
  
      @AliasFor(annotation = ContextConfiguration.class, attribute = "locations")
      String[] xml() default {};
   }
  • 7
    点赞
  • 30
    收藏
    觉得还不错? 一键收藏
  • 4
    评论
### 回答1: @Import注解Spring框架的一种注解,可以用来快速导入多个组件,包括类、包或者配置类。 使用@Import注解可以在一个配置类快速导入其他组件,而不必通过@Bean或@ComponentScan注解来导入。这样可以方便地将功能模块化,并且使用起来也更加方便。 使用方法如下: 1. 在配置类上使用@Import注解,并指定要导入的组件的类型数组。 例如: ``` @Import({MyConfiguration.class, MyBean.class}) public class AppConfig { // ... } ``` 2. 也可以使用ImportSelector接口和ImportBeanDefinitionRegistrar接口来动态选择和注册组件。 例如: ``` @Import(MyImportSelector.class) public class AppConfig { // ... } public class MyImportSelector implements ImportSelector { @Override public String[] selectImports(AnnotationMetadata importingClassMetadata) { // 在这里可以动态的返回需要导入的组件 return new String[] {MyBean.class.getName()}; } } ``` 使用@Import注解导入组件的好处是可以方便地将组件模块化,可以将一个功能模块分成若干个配置类,然后使用@Import注解导入。这样可以让代码更加清晰,更加方便维护。 ### 回答2: @Import注解Spring框架的一种注解,在使用该注解时,可以将其他配置类或者Bean定义类导入到当前配置类。通过@Import注解,可以在一个配置类同时引入多个不同的配置类或者Bean定义类,实现了配置的模块化和复用。 @Import注解可以实现多种功能,具体包括以下几点: 1. 导入配置类:通过@Import注解可以将其他的配置类导入到当前的配置类,这样可以将多个配置类组合在一起,实现配置的分离和复用,提高代码的可维护性和可读性。 2. 导入Bean定义类:除了配置类之外,@Import注解也可以将其他的Bean定义类引入到当前配置类,这样可以将多个不同的Bean定义类组合在一起,实现Bean的组装和扩展。 3. 导入自动配置类:Spring Boot框架的自动配置就是通过@Import注解来实现的,通过将相应的自动配置类导入到配置类,可以实现对应功能的自动配置和初始化,减少了开发人员的工作量。 4. 导入条件配置:通过@Import注解可以根据不同的条件来选择性地导入不同的配置类或者Bean定义类,根据具体的条件来进行动态的选择和配置,实现更加灵活和可配置化的开发。 总结来说,@Import注解Spring框架起到了组合和扩展配置的作用,可以将多个配置类或者Bean定义类导入到当前配置类,实现了配置的模块化和复用,同时也提供了条件导入的功能,使得配置的选择更加灵活和可配置化。 ### 回答3: @Import注解Spring框架的一个注解作用是用于导入其他的配置类或者Bean。通过@Import注解,我们可以将其他的配置类或者Bean引入到当前的配置类,从而实现配置类之间的解耦。 @Import注解可以用于导入其他的@Configuration配置类,这样可以方便地将多个配置类合并到一个总的配置类。通过@Import注解,我们可以将不同的配置类按照逻辑进行划分,分别编写配置类,然后使用@Import注解将它们引入到一个总的配置类。这样做的好处是,能够更好地组织和管理配置类,提高代码的可读性和可维护性。 除了导入其他的配置类,@Import注解还可以用于导入其他的普通的Bean。这对于一些无法通过@Configuration注解进行配置的Bean来说非常有用。通过@Import注解,我们可以将这些Bean引入到当前的配置类,然后使用@Autowired注解进行注入。 总之,@Import注解作用是使得配置类之间可以进行解耦,并且可以方便地引入其他的配置类或者Bean。它在Spring框架的应用非常广泛,能够有效地提高代码的可读性、可维护性和复用性。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值