一、 @Import引入普通類別

透過使用 @Import註解，我們可以將普通的類別定義為Bean。 @Import可以加入在@SpringBootApplication(啟動類別)、@Configuration(配置類別)、@Component(組件類別)對應的類別上。

注意：@RestController、@Service、@Repository都屬於@Component

@SpringBootApplication
@Import(ImportBean.class) // 通過@Import注解把ImportBean添加到IOC容器里面去
public class MyBatisApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyBatisApplication.class, args);
    }
}

二、 @Import引入配置類別(@Configuration修飾的類別)

@Import除了可以把普通的類別定義為Bean，@Import還可以引入一個@Configuration修飾的類別(引入配置類別)，從而把讓配置類別生效(配置類別下的所有Bean加到IOC容器裡面去)。在自訂starter的時候常常會用到。

如果配置類別在標準的SpringBoot套件結構下(SpringBootApplication啟動類別包的根目錄下)。 Spring Boot會自動處理設定類別的導入，不需要手動使用@Import註解。通常，這種情況適用於@Configuration配置類別不在標準的Spring Boot包結構之內。所以一般在自訂starter的時候用到。

@Configuration(proxyBeanMethods = false)
@Import({  // import了兩個哈
        XXXDataConfiguration.XXXPartOneConfiguration.class,
        XXXDataConfiguration.XXXPartTwoConfiguration.class
})
public class XXXDataAutoConfiguration {
}
public class XXXDataConfiguration {
    @Configuration(proxyBeanMethods = false)
    static class XXXPartOneConfiguration {
        @Bean
        @ConditionalOnMissingBean
        public BeanForIoc beanForIoc() {
            return new BeanForIoc();
        }
    }
    @Configuration(proxyBeanMethods = false)
    static class XXXPartTwoConfiguration {

        /**
         * 省略了@Bean的使用
         */
    }
}

三、@Import引入ImportSelector的實作類別

@Import也可以引入ImportSelector的實作類，把ImportSelector介面selectImports()方法傳回的Class名稱都定義為bean 。注意selectImports()方法的參數(shù)AnnotationMetadata，透過這個參數(shù)我們可以取得@Import標註的Class的各種資訊。這一點特別有用，用來做一些參數(shù)的傳遞。 SpringBoot的自動配置和@EnableXXX註解都各自存在。

public interface ImportSelector {
    /**
     * 用于指定需要注冊為bean的Class名稱
     * 當在@Configuration標注的Class上使用@Import引入了一個ImportSelector實現(xiàn)類后，會把實現(xiàn)類中返回的Class名稱都定義為bean。
     *
     * 通過其參數(shù)AnnotationMetadata importingClassMetadata可以獲取到@Import標注的Class的各種信息，
     * 包括其Class名稱，實現(xiàn)的接口名稱、父類名稱、添加的其它注解等信息，通過這些額外的信息可以輔助我們選擇需要定義為Spring bean的Class名稱
     */
    String[] selectImports(AnnotationMetadata importingClassMetadata);
}

關於@Import引入ImportSelector的實現(xiàn)類別的使用，我們舉幾個簡單的使用場景(實際開發(fā)肯定比這複雜的多的)。

3.1 靜態(tài)import場景(注入已知的類別)

靜態(tài)場景(注入已知的類別)，很簡單透過實作ImportSelector類別把我們需要定義為bean的類別直接回傳就好， 比如下面的例子。我們來一個EnableXXX的註解，透過XXXConfigurationSelector注入一個已知的類別XXX。

/**
 * XXXConfigurationSelector一定要配合@Import使用
 */
public class XXXConfigurationSelector implements ImportSelector {
    @Override
    @NonNull
    public String[] selectImports(@NonNull AnnotationMetadata importingClassMetadata) {
        // 把XXX對應的類，定義為Bean
        return new String[]{XXX.class.getName()};
    }
}
/**
 * 注意 @Import(XXXConfigurationSelector.class)
 */
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Import(XXXConfigurationSelector.class)
public @interface EnableXXX {
}
@SpringBootApplication
@EnableXXX // 使之生效
public class MyBatisApplication {

    public static void main(String[] args) {
        SpringApplication.run(MyBatisApplication.class, args);
    }

}

3.2 動態(tài)import場景(注入指定條件的類別)

我們做一個這樣的功能，我們需要把指定包路徑下所有實作了HelloService介面的類別做為bean加入到IOC容器裡面去。 @ComponentScan註解用來幫我們指定路徑。具體實作如下：

public interface HelloService {
    void function();

}
public class DynamicSelectImport implements ImportSelector {
    /**
     * DynamicSelectImport需要配合@Import()注解使用
     * <p>
     * 通過其參數(shù)AnnotationMetadata importingClassMetadata可以獲取到@Import標注的Class的各種信息，
     * 包括其Class名稱，實現(xiàn)的接口名稱、父類名稱、添加的其它注解等信息，通過這些額外的信息可以輔助我們選擇需要定義為Spring bean的Class名稱
     */
    @Override
    public String[] selectImports(AnnotationMetadata importingClassMetadata) {
        // 第一步：獲取到通過ComponentScan指定的包路徑
        String[] basePackages = null;
        // @Import注解對應的類上的ComponentScan注解
        if (importingClassMetadata.hasAnnotation(ComponentScan.class.getName())) {
            Map<String, Object> annotationAttributes = importingClassMetadata.getAnnotationAttributes(ComponentScan.class.getName());
            basePackages = (String[]) annotationAttributes.get("basePackages");
        }
        if (basePackages == null || basePackages.length == 0) {
            //ComponentScan的basePackages默認為空數(shù)組
            String basePackage = null;
            try {
                // @Import注解對應的類的包名
                basePackage = Class.forName(importingClassMetadata.getClassName()).getPackage().getName();
            } catch (ClassNotFoundException e) {
                e.printStackTrace();
            }
            basePackages = new String[]{basePackage};
        }
        // 第er步，知道指定包路徑下所有實現(xiàn)了HelloService接口的類（ClassPathScanningCandidateComponentProvider的使用）
        ClassPathScanningCandidateComponentProvider scanner = new ClassPathScanningCandidateComponentProvider(false);
        TypeFilter helloServiceFilter = new AssignableTypeFilter(HelloService.class);
        scanner.addIncludeFilter(helloServiceFilter);
        Set<String> classes = new HashSet<>();
        for (String basePackage : basePackages) {
            scanner.findCandidateComponents(basePackage).forEach(beanDefinition -> classes.add(beanDefinition.getBeanClassName()));
        }
        // 第三步，返回添加到IOC容器里面去
        return classes.toArray(new String[0]);
    }
}
@Configuration
@ComponentScan("com.tuacy.collect.mybatis") // 指定路徑
@Import(DynamicSelectImport.class)
public class DynamicSelectConfig {
}

四、 @Import引入ImportBeanDefinitionRegistrar的實作類別

@Import引入ImportBeanDefinitionRegistrar的實作類別。一般用來動態(tài)註冊bean。最重要的一點是還可以對這些BeanDefinition進行額外的修改或增強。咱們常用的mybatis @MapperScan就是用這種方式實現(xiàn)的。

/**
 * ImportBeanDefinitionRegistrar，我們一般會實現(xiàn)ImportBeanDefinitionRegistrar類，然后配合一個自定義的注解一起使用。而且在注解類上@Import我們的這個實現(xiàn)類。
 * 通過自定義注解的配置，拿到注解的一些元數(shù)據(jù)。然后在ImportBeanDefinitionRegistrar的實現(xiàn)類里面做相應的邏輯處理，比如把自定義注解標記的類添加到Spring IOC容器里面去。
 */
public interface ImportBeanDefinitionRegistrar {

    /**
     * 根據(jù)注解的給定注釋元數(shù)據(jù)，根據(jù)需要注冊bean定義
     * @param importingClassMetadata 可以拿到@Import的這個class的Annotation Metadata
     * @param registry BeanDefinitionRegistry 就可以拿到目前所有注冊的BeanDefinition，然后可以對這些BeanDefinition進行額外的修改或增強。
     */
    void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry);

}

關於@Import引入ImportBeanDefinitionRegistrar的使用強烈建議大家去看看mybatis關於@MapperScan的處理原始碼。特別有意思。我們也舉一個非常簡單的實例，來讓大家直觀的看到ImportBeanDefinitionRegistrar的使用，例如我們想把指定包路徑下所有添加了BeanIoc註解的類別註冊為bean。

具體實作如下：

/**
 * 我們會把添加了該注解的類作為bean
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@Documented
public @interface BeanIoc {

}

/**
 * 定義包路徑。(指定包下所有添加了BeanIoc注解的類作為bean)
 * 注意這里 @Import(BeanIocScannerRegister.class) 的使用
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@Documented
@Import(BeanIocScannerRegister.class)
public @interface BeanIocScan {
    String[] basePackages() default "";
}


/**
 * 搜索指定包下所有添加了BeanIoc注解的類，并且把這些類添加到ioc容器里面去
 */
public class BeanIocScannerRegister implements ImportBeanDefinitionRegistrar, ResourceLoaderAware {

    private final static String PACKAGE_NAME_KEY = "basePackages";

    private ResourceLoader resourceLoader;

    @Override
    public void registerBeanDefinitions(AnnotationMetadata annotationMetadata, BeanDefinitionRegistry beanDefinitionRegistry) {
        //1. 從BeanIocScan注解獲取到我們要搜索的包路徑
        AnnotationAttributes annoAttrs = AnnotationAttributes.fromMap(annotationMetadata.getAnnotationAttributes(BeanIocScan.class.getName()));
        if (annoAttrs == null || annoAttrs.isEmpty()) {
            return;
        }
        String[] basePackages = (String[]) annoAttrs.get(PACKAGE_NAME_KEY);
        // 2. 找到指定包路徑下所有添加了BeanIoc注解的類，并且把這些類添加到IOC容器里面去
        ClassPathBeanDefinitionScanner scanner = new ClassPathBeanDefinitionScanner(beanDefinitionRegistry, false);
        scanner.setResourceLoader(resourceLoader);
        scanner.addIncludeFilter(new AnnotationTypeFilter(BeanIoc.class));
        scanner.scan(basePackages);
    }

    @Override
    public void setResourceLoader(ResourceLoader resourceLoader) {
        this.resourceLoader = resourceLoader;
    }
}


/**
 * 使用，使BeanIocScan生效
 */
@Configuration
@BeanIocScan(basePackages = "com.tuacy.collect.mybatis")
public class BeanIocScanConfig {
}

以上是SpringBoot中的@Import註解怎麼使用的詳細內容。更多資訊請關注PHP中文網其他相關文章！