Spring中的@ComponentScan注解使用詳解
基本使用
@ComponentScan 注解的作用就是根據(jù)指定的掃描路徑,把路徑中符合掃描規(guī)則的類裝配到 Spring 容器中。
加入依賴
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.1.8.RELEASE</version>
</dependency>
配置啟動類,使用ComponentScan掃描指定包路徑
@ComponentScan(basePackages = "com.cxyxj.componentscan.app")
public class AppMain {
public static void main(String[] args) {
AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(AppMain.class);
// 打印 bean 名稱
String[] beanDefinitionNames = context.getBeanDefinitionNames();
for (String name : beanDefinitionNames){
System.out.println(name);
}
}
}
運行結(jié)果:
org.springframework.context.annotation.internalConfigurationAnnotationProcessor
org.springframework.context.annotation.internalAutowiredAnnotationProcessor
org.springframework.context.annotation.internalCommonAnnotationProcessor
org.springframework.context.event.internalEventListenerProcessor
org.springframework.context.event.internalEventListenerFactory
appMain
除了 Spring 本身注冊的一些 bean 之外, AppMain這個類也注冊進了容器中。
上述的使用方式,在沒什么特殊的要求下,在實際工作當(dāng)中完全滿足項目的開發(fā)。@ComponentScan注解還有其他好用的功能,我們有必要了解并會使用。
@ComponentScan注解與XML文件中的context:component-scan標(biāo)簽等效。
<beans>
<context:component-scan base-package="com.cxyxj"/>
</beans>
注解定義
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@Documented
@Repeatable(ComponentScans.class)
public @interface ComponentScan {
// basePackages 的別名
// 在沒有其他屬性的情況下可以如此寫:@ComponentScan("com.cxyxj.componentscan")
// 而不需要:@ComponentScan(basePackages = "com.cxyxj.componentscan")
@AliasFor("basePackages")
String[] value() default {};
// 掃描帶注解的包路徑,默認是@Component
@AliasFor("value")
String[] basePackages() default {};
// 掃描指定帶注解的類,同時會掃描該類所在的包,默認是@Component
//示例: @ComponentScan(basePackageClasses = {UserServiceImpl.class})
Class<?>[] basePackageClasses() default {};
// beanName 的生成器
Class<? extends BeanNameGenerator> nameGenerator() default BeanNameGenerator.class;
// 解析@Scope注解
Class<? extends ScopeMetadataResolver> scopeResolver() default AnnotationScopeMetadataResolver.class;
// 是否為掃描到的Bean生成代理
/**
* ScopedProxyMode有四個取值
* 1.DEFAULT:默認值,默認情況下取no
* 2.NO:不開啟代理
* 3.INTERFACES:使用jdk動態(tài)代理
* 4.TARGET_CLASS:使用cglib代理
* 假如有一個單例beanA,其中有一個屬性B,B的Scope是session,此時,容器在啟動時創(chuàng)建A的過程中需要注入B屬性,
* 但是B的scope是session,這種情況下是注入不了的(只有用戶訪問時才會創(chuàng)建),是會報錯的
* 但是如果將B的Scope的ProxyMode屬性配置為INTERFACES或者TARGET_CLASS時,那么B就會生成一個ScopedProxyFactoryBean類型的BeanDefinitionHolder
* 在A注入B時,就會注入一個ScopedProxyFactoryBean類型的Bean
*/
ScopedProxyMode scopedProxy() default ScopedProxyMode.DEFAULT;
// 控制符合組件檢測條件的類文件,默認是包路徑下的 **/*.class
String resourcePattern() default ClassPathScanningCandidateComponentProvider.DEFAULT_RESOURCE_PATTERN;
// 是否自動檢測帶有 @Component 注解的類,默認為 true
// 像 @Repository、 @Controller、@Service、@Configuration 內(nèi)部都包含了 @Component
boolean useDefaultFilters() default true;
/**
* 如果掃描到的類符合 includeFilters 中的過濾條件
* 這個類會被注冊到容器中
* 過濾類型與如下5種
* 1、ANNOTATION:注解類型(默認)
* 2、ASSIGNABLE_TYPE:指定類
* 3、ASPECTJ:指定表達式
* 4、REGEX:正則表達式
* 5、CUSTOM:自定義類型
*/
Filter[] includeFilters() default {};
// 如果掃描到的類符合 excludeFilters 中的過濾條件
// 這個類不會被注冊
Filter[] excludeFilters() default {};
// 掃描到的類是否應(yīng)延遲初始化,默認為 false
boolean lazyInit() default false;
// 聲明要用作包含過濾器或排除過濾器的類型過濾器
@Retention(RetentionPolicy.RUNTIME)
@Target({})
@interface Filter {
// 要使用的過濾器類型,默認為 ANNOTATION
FilterType type() default FilterType.ANNOTATION;
// classes 的別名
@AliasFor("classes")
Class<?>[] value() default {};
/**
* 作用同上面的 value 相同
* 過濾器的參數(shù),參數(shù)必須為class數(shù)組
* 只能用于 ANNOTATION 、ASSIGNABLE_TYPE 、CUSTOM 這三個類型
* ANNOTATION:參數(shù)為注解類,比如:Controller.class
* ASSIGNABLE_TYPE:參數(shù)為類,如 UserServiceImpl.class
* CUSTOM:參數(shù)為實現(xiàn) TypeFilter 接口的類 ,如 MyTypeFilter.class
* 實現(xiàn)了TypeFilter 接口的類,還能實現(xiàn) EnvironmentAware,BeanFactoryAware, BeanClassLoaderAware,ResourceLoaderAware 這四個回調(diào)接口
* 它們各自的方法將在 TypeFilter#match 之前被調(diào)用
*/
@AliasFor("value")
Class<?>[] classes() default {};
//這個屬性主要用于 ASPECTJ 類型和 REGEX 類型
String[] pattern() default {};
}
}
接下來使用一下幾個重要屬性。
實踐
basePackageClasses
創(chuàng)建 ProductServiceImpl、UserServiceImpl兩個類,并放在 impl包下。整體包結(jié)構(gòu)如下:

類中內(nèi)容如下:
ProductServiceImpl類中包含 @Configuration注解
@Configuration
public class ProductServiceImpl {
}
UserServiceImpl則是普通類
public class UserServiceImpl {
}
在ComponentScan注解增加 basePackageClasses的屬性,指定 UserServiceImpl。上面講過basePackageClasses會掃描指定帶注解的類,同時會掃描該類所在的包。
@ComponentScan(basePackages = "com.cxyxj.componentscan.app",basePackageClasses = {UserServiceImpl.class})
啟動結(jié)果

由于指定的 UserServiceImpl上面沒有注解,所以沒被加入容器中。
useDefaultFilters
useDefaultFilters 的值默認為 true,也就是默認會往 includeFilters中添加一個為 @Component注解類型的過濾器。這時我們將 useDefaultFilters的值修改為 false ,這會掃描出來幾個類呢?
@ComponentScan(basePackages = "com.cxyxj.componentscan.app",basePackageClasses = {UserServiceImpl.class},useDefaultFilters = false)
啟動結(jié)果

答案是一個都沒有,請忽略 AppMain ,這相當(dāng)于是我們手動調(diào)用 context.register(AppMain.class)進行注冊的。
includeFilters
我們想把 ProductServiceImpl掃描出來,需要怎么做呢?
ANNOTATION
修改 @ComponentScan的值,增加 includeFilters = @ComponentScan.Filter(type = FilterType.ANNOTATION,value = {Configuration.class},指定 value 的值為 @Configuration。
這代表著只要掃描到的類中包含 @Configuration注解,就會被注冊到容器中。一般我們自定義的注解就可以結(jié)合該方式。
@ComponentScan(basePackages = "com.cxyxj.componentscan.app",
basePackageClasses = {UserServiceImpl.class},
useDefaultFilters = false,
includeFilters = @ComponentScan.Filter(type = FilterType.ANNOTATION,value = {Configuration.class})
)
啟動結(jié)果

ASSIGNABLE_TYPE
將 UserServiceImpl加入到容器中,但是它是一個普普通通的類,這時可以使用 ASSIGNABLE_TYPE。
includeFilters 值修改如下:
includeFilters = @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE,value = {UserServiceImpl.class})
啟動結(jié)果

ASPECTJ
如果覺得一個一個的加入比較麻煩,可以使用 ASPECTJ表達式的方式。
includeFilters 值修改如下:
includeFilters = @ComponentScan.Filter(type = FilterType.ASPECTJ,pattern = {"com.cxyxj.componentscan.impl.*"})
啟動結(jié)果

如果啟動報錯需要加入 aspectj的依賴。
<!--aspectj 支持-->
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjrt</artifactId>
<version>1.9.6</version>
</dependency>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjweaver</artifactId>
<version>1.9.6</version>
</dependency>
REGEX
跟 ASPECTJ能達到效果的是 REGEX,使用正則表達式進行匹配。需要注意的是進行匹配的值是類的全限定名,比如:com.cxyxj.componentscan.impl.UserServiceImpl。
includeFilters 值修改如下:
includeFilters = @ComponentScan.Filter(type = FilterType.REGEX,pattern = {"[A-Za-z.]+Impl$"})
啟動結(jié)果

CUSTOM
如果覺得上述幾種方式都不滿足需求,我們可以進行自定義過濾規(guī)則。
創(chuàng)建 CustomTypeFilter 類,并實現(xiàn) TypeFilter接口,重寫其 match方法。
public class CustomTypeFilter implements TypeFilter {
/**
*
* @param metadataReader:可以獲得當(dāng)前正在掃描的類的信息
* @param metadataReaderFactory:可以獲得 MetadataReader。metadataReaderFactory.getMetadataReader(UserServiceImpl.class.getName());
* @return match方法返回false 則表示不通過過濾規(guī)則,true 表示通過過濾規(guī)則
* @throws IOException
*/
@Override
public boolean match(MetadataReader metadataReader, MetadataReaderFactory metadataReaderFactory) throws IOException {
//Class元數(shù)據(jù)
ClassMetadata classMetadata = metadataReader.getClassMetadata();
//全限定名稱
String className = classMetadata.getClassName();
//如果名稱包含 User 則通過過濾
if(className.contains("User")){
return true;
}
return false;
}
}
includeFilters 值修改如下:
includeFilters = @ComponentScan.Filter(type = FilterType.CUSTOM,value = {CustomTypeFilter.class})
啟動結(jié)果

通過自定義過濾規(guī)則的掃描,只有 UserServiceImpl符合。
excludeFilters 的使用方式與 includeFilters一致。只不過 excludeFilters是排除而已。
到此這篇關(guān)于Java中的@ComponentScan注解使用詳解的文章就介紹到這了,更多相關(guān)@ComponentScan注解使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
idea springboot 修改css,jsp不重啟實現(xiàn)頁面更新的問題
這篇文章主要介紹了idea springboot 修改css,jsp不重啟實現(xiàn)頁面更新的問題,本文給大家介紹的非常詳細,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2020-10-10
Java中Comparator與Comparable排序的區(qū)別詳解
這篇文章主要介紹了Java中Comparator與Comparable排序的區(qū)別詳解,如果你有一個類,希望支持同類型的自定義比較策略,可以實現(xiàn)接口Comparable,如果某個類,沒有實現(xiàn)Comparable,但是又希望對它進行比較,則可以自定義一個Comparator,需要的朋友可以參考下2024-01-01
springboot+camunda實現(xiàn)工作流的流程分析
Camunda是基于Java語言,支持BPMN標(biāo)準(zhǔn)的工作流和流程自動化框架,并且還支持CMMN規(guī)范,DMN規(guī)范,本文給大家介紹springboot+camunda實現(xiàn)工作流的流程分析,感興趣的朋友一起看看吧2021-12-12
Springboot的ThreadPoolTaskScheduler線程池輕松搞定15分鐘不操作自動取消訂單
這篇文章主要介紹了Springboot的ThreadPoolTaskScheduler線程池輕松搞定15分鐘不操作自動取消訂單,本文給大家介紹的非常詳細,需要的朋友可以參考下2025-01-01
springboot+jsonp解決前端跨域問題小結(jié)
這篇文章主要介紹了springboot+jsonp解決前端跨域問題小結(jié),小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2018-06-06
SpringBoot中集成企業(yè)微信機器人實現(xiàn)運維報警的示例
本文主要介紹了SpringBoot中集成企業(yè)微信機器人實現(xiàn)運維報警,文中通過示例代碼介紹的非常詳細,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2022-05-05
springboot+mybatis配置控制臺打印sql日志的方法
這篇文章主要介紹了springboot+mybatis配置控制臺打印sql日志的方法,文中通過示例代碼介紹的非常詳細,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-08-08

