使用过滤器自定义扫描

默认情况下，用 @Component、@Repository、@Service、@Controller、@Configuration注解的类，或者本身用 @Component注解的自定义注解是唯一被检测到的候选组件。然而，你可以通过应用自定义过滤器来修改和扩展这种行为。将它们作为 @ComponentScan注解的 includeFilters或 excludeFilters属性（或作为 XML配置中 <context:component-scan>元素的 <context:include-filter />或 <context:exclud-filter />子元素）。每个过滤器元素都需要类型和表达式属性。下表描述了过滤选项。

下面的示例显示了忽略所有 @Repository 注解而使用指定的正则表达扫描到的

@Configuration
@ComponentScan(basePackages = "org.example",
        includeFilters = @Filter(type = FilterType.REGEX, pattern = ".*Stub.*Repository"),
        excludeFilters = @Filter(Repository.class))
public class AppConfig {
    // ...
}

下面的清单显示了等效的 XML：

<beans>
    <context:component-scan base-package="org.example">
        <context:include-filter type="regex"
                expression=".*Stub.*Repository"/>
        <context:exclude-filter type="annotation"
                expression="org.springframework.stereotype.Repository"/>
    </context:component-scan>
</beans>

:::info 你也可以通过在注解上设置 useDefaultFilters=false 或者提供 use-default-filters=”false” 作为元素的属性来禁用默认过滤器。这将有效地禁止对用 @Component、@Repository、@Service、@Controller、@RestController 或 @Configuration 注解或元注解的类进行自动检测。 :::