组件注册——@ComponentScan注解

@ComponentScan注解用于自动扫描指定包下的所有组件，也可以通过添加属性值来指定扫描规则。

1、@ComponentScan(basePackages="包名")，最简单的使用方法，扫描包名下的所有组件。

项目结构

MainConfig类内容，该类是一个配置类，相当于一个xml配置文件。@ComponentScan(basePackages = "com.wyx.controller")表示会扫描com.wyx.controller包下的所有组件，并将这些组件添加到IOC容器中。

package com.wyx.config;import com.wyx.domain.Person;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;@Configuration
@ComponentScan(basePackages = "com.wyx.controller" )
public class MainConfig {@Beanpublic Person person(){return new Person("李思",20);}
}

MainTest类的内容，这是一个测试类，输出容器中所有的bean,运行程序会发现，容器中有controller包下的bean。
package com.wyx;import com.wyx.config.MainConfig;
import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;public class MainTest {public static void main(String[] args){ApplicationContext atcApplicationContext = new AnnotationConfigApplicationContext(MainConfig.class);String[] beanDefinitionNames = atcApplicationContext.getBeanDefinitionNames();for(String name:beanDefinitionNames){System.out.println(name);}}
}

运行结果

2、excludeFilters = {@ComponentScan.Filter(type= FilterType.***,classes = ***.class),...}，指定扫描规则，去除指定注解的组件。

如源码所示，excludeFilters属性是一个@ComponentScan.Filter注解数组，每个@ComponentScan.Filter之间用逗号分隔。

@ComponentScan.Filter的源码如下图所示，有type、classes、value三个属性

如下图所示，先来看type属性，它是FilterType类型的，而FilterType是一个枚举类型，一种有五个值。分别是FitlerType.ANNOTATION：指定注解

FilterType.ASSIGNABLE_TYPE：指定类型

FilterType.ASPECTJ：Aspectj语法指定，很少使用

FilterType.REGEX：使用正则表达式指定

FilterType.CUSTOM：自定义规则

classes属性则是一个运行时类型Class对象。

实例：项目结构同上
MainConfig类代码如下：@ComponentScan.Filter(type= FilterType.ANNOTATION,value = Repository.class) 去除@Repository注解组件@ComponentScan.Filter(type=FilterType.ASSIGNABLE_TYPE,value=Person.class) }) 去除Person类Bean

package com.wyx.config;import com.wyx.domain.Book;
import com.wyx.domain.Person;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.FilterType;
import org.springframework.stereotype.Repository;@Configuration
@ComponentScan(basePackages = "com.wyx" ,excludeFilters = {@ComponentScan.Filter(type= FilterType.ANNOTATION,value = Repository.class),@ComponentScan.Filter(type=FilterType.ASSIGNABLE_TYPE,value=Person.class)
})
public class MainConfig {@Beanpublic Person person(){return new Person("李思",20);}@Beanpublic Book book(){return new Book("十万个为什么",160);}
}测试类同上面MainTest类

程序运行结果：

这里有一个注意点，FilterType.ASSIGNABLE_TYPE只能识别到由Component注解的普通bean，无法去除通过java配置类注入的bean。

3、includeFilters = {@ComponentScan.Filter(type= FilterType.***,classes = ***.class),...}，指定扫描规则,只注入符合注解条件的组件。

这个与excludeFilters用法相似，但是有一个注意点，用这个属性时，需要添加一个属性。因为spring默认是注入所有扫描到的组件，所以要将useDefaultFilters 的属性值设置为false，includeFilters才能生效。

MainConfig类做如下修改

@Configuration
@ComponentScan(basePackages = "com.wyx" ,includeFilters = {@ComponentScan.Filter(type= FilterType.ANNOTATION,value = Repository.class),@ComponentScan.Filter(type=FilterType.ASSIGNABLE_TYPE,value=Person.class)
},useDefaultFilters = false)

只扫描Reposity注解和Person类

运行结果：

4、自定义规则，需要编写一个类，该类实现了TypeFilter接口的类，下面是我自己定义的MyTypeFilter类，当该类返回true时，会选中该组件。TypeFilter接口中有一个抽象方法：match(MetadataReader metadataReader, MetadataReaderFactory metadataReaderFactory)，当中有两个形参：

MetadataReader metadataReader 读取到当前正在扫描的类信息

MetadataReaderFactory metadataReaderFactory 可以获取到其他任何类的信息MyTypeFilter类代码如下：package com.wyx.config;import org.springframework.core.io.Resource;
import org.springframework.core.type.AnnotationMetadata;
import org.springframework.core.type.ClassMetadata;
import org.springframework.core.type.classreading.MetadataReader;
import org.springframework.core.type.classreading.MetadataReaderFactory;
import org.springframework.core.type.filter.TypeFilter;import java.io.IOException;public class MyTypeFilter implements TypeFilter {public boolean match(MetadataReader metadataReader, MetadataReaderFactory metadataReaderFactory) throws IOException {//当前类的注解信息AnnotationMetadata annotationMetadata = metadataReader.getAnnotationMetadata();//当前正在扫描的类的信息ClassMetadata classMetadata = metadataReader.getClassMetadata();//当前类的资源，比如类的路径Resource resource = metadataReader.getResource();if(classMetadata.getClassName().contains("Book")) {return true;}return false;}

配置类如下所示

package com.wyx.config;import com.wyx.domain.Book;
import com.wyx.domain.Person;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.FilterType;@Configuration
@ComponentScan(basePackages = "com.wyx" ,includeFilters = {@ComponentScan.Filter(type=FilterType.CUSTOM,classes = MyTypeFilter.class)},useDefaultFilters = false
)
public class MainConfig {@Beanpublic Book book(){return new Book("yes",120);}@Beanpublic Person person(){return new Person("张三",12);}
}
运行结果：（只会通过类名中含有Book的bean）