不是银趴~是@Import!

发布时间 2024-01-10 15:07:16作者: JavaCode9

首先我们要明确:@Import 注解是 Spring 提供的。

然后我们看一下该注解的官方注释:

Indicates one or more component classes to import — typically @Configuration classes.

Provides functionality equivalent to the <import/> element in Spring XML. Allows for importing @Configuration classes, ImportSelector and ImportBeanDefinitionRegistrar implementations, as well as regular component classes (as of 4.2; analogous to AnnotationConfigApplicationContext.register).

@Bean definitions declared in imported @Configuration classes should be accessed by using @Autowired injection. Either the bean itself can be autowired, or the configuration class instance declaring the bean can be autowired. The latter approach allows for explicit, IDE-friendly navigation between @Configuration class methods.

May be declared at the class level or as a meta-annotation.

If XML or other non-@Configuration bean definition resources need to be imported, use the @ImportResource annotation instead.

我们将其中我们关心的重要部分提取出来翻译整理如下:

  • 该注解可导入一个或多个组件类——通常是Configuration类。

  • 允许导入@Configuration类、ImportSelector接口和ImportBeanDefinitionRegistrar接口的实现,以及普通类(从4.2版本开始)。

  • @Import注解可以在类上声明,也可以作为元注解声明在其他注解上。

那么 @Import 注解到底有什么作用和优势呢?

记住下面几句话:

导入配置。

从各个地方、通过各种方式导入配置。

在你需要的时候,从各个地方、通过各种方式导入配置。

在你需要的时候,从各个地方、通过各种方式导入并改造成你喜欢的配置。


下面我们通过示例讲 4 种官方注释给出的导入类型,分别是:

  • 普通类

  • @Configuration类

  • ImportSelector接口实现

  • ImportBeanDefinitionRegistrar接口实现

普通类

普通类不必啰嗦,有手就行。

public class Circle {
}
@Configuration
@Import({Circle.class})
public class MainConfig {
}

导入@Configuration类

我们建立三个不同的模块,MainModule, Module1, Module2。

让 MainModule 引入 Module1、Module2依赖。

在 MainModule 中创建 MainConfig 类如下:

@Configuration
@Import({Config1.class, Config2.class})
public class MainConfig {
}

很明显,Config1,Config2 分别属于2个模块,如下:

@Configuration
public class Config1 {
    @Bean
    public String config1() {
        return "我是config1配置类!";
    }
}
@Configuration
public class Config2 {
    @Bean
    public String config2() {
        return "我是config2配置类!";
    }
}

在 MainModule 中创建测试类看是否生效:

@Test
void contextLoads() {
    AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(MainConfig.class);
    for (String name : context.getBeanDefinitionNames()) {
        System.out.println(String.format("%s->%s", name, context.getBean(name)));
    }
}

测试结果如下:

mainConfig->com.example.annotation.config.MainConfig$$EnhancerBySpringCGLIB$$a98d5b6a@55a609dd
com.example.module1.config1->com.example.module1.config.Config1$$EnhancerBySpringCGLIB$$72aca5d0@4afd21c6
config1->我是config1配置类!
com.example.module2.config2->com.example.module2.config.Config2$$EnhancerBySpringCGLIB$$72aca5d0@4afd21c6
config2->我是config2配置类!

ImportSelector接口实现

首先我们需要认识一下 ImportSelector 接口:

public interface ImportSelector {

    String[] selectImports(AnnotationMetadata importingClassMetadata);

    @Nullable
    default Predicate<String> getExclusionFilter() {
        return null;
    }
}

只有一个需要实现的方法:

selectImports

参数 AnnotationMetadata 是什么?

翻译为注解元数据。

有什么用?

用来获取被@Import标注的类上面所有的注解信息。

String[] 是什么?

返回需要导入的类名的数组,可以是任何普通类,配置类。

上示例:

创建一个配置类

@Configuration
public class Config {
    @Bean
    public String name() {
        return "公众号:JavaCode";
    }
}

定义一个ImportSelectors实现类

public class MyImportSelector implements ImportSelector {
    @Override
    public String[] selectImports(AnnotationMetadata importingClassMetadata) {
        return new String[]{
                Config.class.getName()
        };
    }
}

上述代码中需要说明一下,Config.class.getName() 得到的是类的全类名,也就是[包名.类名],也就是com.example.annotation.pojo.Config。

导入MyImportSelector

@Import({MyImportSelector.class})
public class MainConfig {
}

这时候有人问了:

这里怎么没有 @Configuration 注解?

没关系哈,虽然 @Import 注解通常是与 @Configuration 注解一起使用的,但不是绝对必要的。

ImportBeanDefinitionRegistrar接口实现

首先我们还是先认识一下 ImportBeanDefinitionRegistrar 接口:

public interface ImportBeanDefinitionRegistrar {

    default void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry, BeanNameGenerator importBeanNameGenerator) {
        registerBeanDefinitions(importingClassMetadata, registry);
    }
    default void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) {
    }
}

可以看到只有2个方法,第一个方法调用第二个方法,所以我们就只看第二个方法就好了。

AnnotationMetadata 我们前边说过了:

用来获取被@Import标注的类上面所有的注解信息。

BeanDefinitionRegistry 呢?

它是一个接口,内部提供了注册bean的各种方法,用于我们手动注册bean。

上示例:

创建一个 Java 类

public class Rectangle {
    public void sayHi() {
        System.out.println("Rectangle sayHi()");
    }
}

创建 ImportBeanDefinitionRegistrar 实现类

public class MyImportBeanDefinitionRegistrar implements ImportBeanDefinitionRegistrar {

    @Override
    public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) {
        RootBeanDefinition rootBeanDefinition = new RootBeanDefinition(Rectangle.class);
        // 注册一个名字叫做 rectangle 的 bean
        registry.registerBeanDefinition("rectangle", rootBeanDefinition);
    }
}

总结

第一种:

我们有什么就可以导什么。

第二种:

我们可以把分散的配置集中起来,更加清晰和有组织。

第三种:

除了我们模块现有的配置,你只要能拿到类的全类名,就能注册进来。

第四种:

我们不光能到处拿,我们还能拿来以后随便改!

以上四种方式就实现了我们当初的豪言:

导入配置。

从各个地方、通过各种方式导入配置。

在你需要的时候,从各个地方、通过各种方式导入配置。

在你需要的时候,从各个地方、通过各种方式导入并改造成你喜欢的配置。


● 终于搞懂动态代理了!

● 学会@ConfigurationProperties月薪过三千

● 学一点关于JVM类加载的知识

● Java注解,看完就会用

● Java反射,看完就会用

● @Value是个什么东西