@ComponentScan 详解 / 憋错料

@ComponentScan

  1 @Retention(RetentionPolicy.RUNTIME)
  2 @Target(ElementType.TYPE)
  3 @Documented
  4 @Repeatable(ComponentScans.class)
  5 public @interface ComponentScan {
  6
  7    /**
  8     * 扫描路径
  9     * @ComponentScan(value = "spring.annotation.componentscan")
 10     */
 11    @AliasFor("basePackages")
 12    String[] value() default {};
 13
 14    /**
 15     * 扫描路径
 16     */
 17    @AliasFor("value")
 18    String[] basePackages() default {};
 19
 20    /**
 21     * 指定扫描类
 22     * @ComponentScan(basePackageClasses = {BookDao.class, BookService.class})
 23     */
 24    Class<?>[] basePackageClasses() default {};
 25
 26    /**
 27     * 命名注册的Bean，可以自定义实现命名Bean，
 28     * 1、@ComponentScan(value = "spring.annotation.componentscan",nameGenerator = MyBeanNameGenerator.class)
 29     * MyBeanNameGenerator.class 需要实现 BeanNameGenerator 接口，所有实现BeanNameGenerator 接口的实现类都会被调用
 30     * 2、使用 AnnotationConfigApplicationContext 的 setBeanNameGenerator方法注入一个BeanNameGenerator
 31     * BeanNameGenerator beanNameGenerator = (definition,registry)-> String.valueOf(new Random().nextInt(1000));
 32     * AnnotationConfigApplicationContext annotationConfigApplicationContext = new AnnotationConfigApplicationContext();
 33     * annotationConfigApplicationContext.setBeanNameGenerator(beanNameGenerator);
 34     * annotationConfigApplicationContext.register(MainConfig2.class);
 35     * annotationConfigApplicationContext.refresh();
 36     * 第一种方式只会重命名@ComponentScan扫描到的注解类
 37     * 第二种只有是初始化的注解类就会被重命名
 38     * 列如第一种方式不会重命名 @Configuration 注解的bean名称，而第二种就会重命名 @Configuration 注解的Bean名称
 39     */
 40    Class<? extends BeanNameGenerator> nameGenerator() default BeanNameGenerator.class;
 41
 42    /**
 43     * 用于解析@Scope注解，可通过 AnnotationConfigApplicationContext 的 setScopeMetadataResolver 方法重新设定处理类
 44     * ScopeMetadataResolver scopeMetadataResolver = definition -> new ScopeMetadata();  这里只是new了一个对象作为演示，没有做实际的逻辑操作
 45     * AnnotationConfigApplicationContext annotationConfigApplicationContext = new AnnotationConfigApplicationContext();
 46     * annotationConfigApplicationContext.setScopeMetadataResolver(scopeMetadataResolver);
 47
 48     * annotationConfigApplicationContext.register(MainConfig2.class);
 49     * annotationConfigApplicationContext.refresh();
 50     * 也可以通过@ComponentScan 的 scopeResolver 属性设置
 51     *@ComponentScan(value = "spring.annotation.componentscan",scopeResolver = MyAnnotationScopeMetadataResolver.class)
 52     */
 53    Class<? extends ScopeMetadataResolver> scopeResolver() default AnnotationScopeMetadataResolver.class;
 54
 55    /**
 56     * 用来设置类的代理模式
 57     */
 58    ScopedProxyMode scopedProxy() default ScopedProxyMode.DEFAULT;
 59
 60    /**
 61     * 扫描路径 如 resourcePattern = "**/*.class"
 62     * 使用  includeFilters 和 excludeFilters 会更灵活
 63     */
 64    String resourcePattern() default ClassPathScanningCandidateComponentProvider.DEFAULT_RESOURCE_PATTERN;
 65
 66    /**
 67     * 指示是否应启用对带有{@code @Component}，{@ code @Repository}，
 68     * {@ code @Service}或{@code @Controller}注释的类的自动检测。
 69     */
 70    boolean useDefaultFilters() default true;
 71
 72    /**
 73     * 对被扫描的包或类进行过滤，若符合条件，不论组件上是否有注解，Bean对象都将被创建
 74     * @ComponentScan(value = "spring.annotation.componentscan",includeFilters = {
 75     *     @ComponentScan.Filter(type = FilterType.ANNOTATION, classes = {Controller.class, Service.class}),
 76     *     @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, classes = {SchoolDao.class}),
 77     *     @ComponentScan.Filter(type = FilterType.CUSTOM, classes = {MyTypeFilter.class}),
 78     *     @ComponentScan.Filter(type = FilterType.ASPECTJ, pattern = "spring.annotation..*"),
 79     *     @ComponentScan.Filter(type = FilterType.REGEX, pattern = "^[A-Za-z.]+Dao$")
 80     * },useDefaultFilters = false)
 81     * useDefaultFilters 必须设为 false
 82     */
 83    Filter[] includeFilters() default {};
 84
 85    /**
 86     * 指定哪些类型不适合进行组件扫描。
 87     * 用法同 includeFilters 一样
 88     */
 89    Filter[] excludeFilters() default {};
 90
 91    /**
 92     * 指定是否应注册扫描的Bean以进行延迟初始化。
 93     * @ComponentScan(value = "spring.annotation.componentscan",lazyInit = true)
 94     */
 95    boolean lazyInit() default false;
 96
 97
 98    /**
 99     * 用于 includeFilters 或 excludeFilters 的类型筛选器
100     */
101    @Retention(RetentionPolicy.RUNTIME)
102    @Target({})
103    @interface Filter {
104
105       /**
106        * 要使用的过滤器类型，默认为 ANNOTATION 注解类型
107        * @ComponentScan.Filter(type = FilterType.ANNOTATION, classes = {Controller.class, Service.class})
108        */
109       FilterType type() default FilterType.ANNOTATION;
110
111       /**
112        * 过滤器的参数，参数必须为class数组，单个参数可以不加大括号
113        * 只能用于 ANNOTATION 、ASSIGNABLE_TYPE 、CUSTOM 这三个类型
114        * @ComponentScan.Filter(type = FilterType.ANNOTATION, value = {Controller.class, Service.class})
115        * @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, classes = {SchoolDao.class})
116        * @ComponentScan.Filter(type = FilterType.CUSTOM, classes = {MyTypeFilter.class})
117        */
118       @AliasFor("classes")
119       Class<?>[] value() default {};
120
121       /**
122        * 作用同上面的 value 相同
123        * ANNOTATION 参数为注解类，如  Controller.class, Service.class, Repository.class
124        * ASSIGNABLE_TYPE 参数为类，如 SchoolDao.class
125        * CUSTOM  参数为实现 TypeFilter 接口的类 ，如 MyTypeFilter.class
126        * MyTypeFilter 同时还能实现 EnvironmentAware，BeanFactoryAware，BeanClassLoaderAware，ResourceLoaderAware 这四个接口
127        * EnvironmentAware
128        * 此方法用来接收 Environment 数据 ，主要为程序的运行环境，Environment 接口继承自 PropertyResolver 接口，详细内容在下方
129        * @Override
130        * public void setEnvironment(Environment environment) {
131        *    String property = environment.getProperty("os.name");
132        * }
133        *
134        * BeanFactoryAware
135        * BeanFactory Bean容器的根接口，用于操作容器，如获取bean的别名、类型、实例、是否单例的数据
136        * @Override
137        * public void setBeanFactory(BeanFactory beanFactory) throws BeansException {
138        *     Object bean = beanFactory.getBean("BeanName")
139        * }
140        *
141        * BeanClassLoaderAware
142        * ClassLoader 是类加载器，在此方法里只能获取资源和设置加载器状态
143        * @Override
144        * public void setBeanClassLoader(ClassLoader classLoader) {
145        *     ClassLoader parent = classLoader.getParent();
146        * }
147        *
148        * ResourceLoaderAware
149        * ResourceLoader 用于获取类加载器和根据路径获取资源
150        * public void setResourceLoader(ResourceLoader resourceLoader) {
151        *     ClassLoader classLoader = resourceLoader.getClassLoader();
152        * }
153        */
154       @AliasFor("value")
155       Class<?>[] classes() default {};
156
157       /**
158        * 这个参数是 classes 或 value 的替代参数，主要用于 ASPECTJ 类型和  REGEX 类型
159        * ASPECTJ  为 ASPECTJ 表达式
160        * @ComponentScan.Filter(type = FilterType.ASPECTJ, pattern = "spring.annotation..*")
161        * REGEX  参数为 正则表达式
162        * @ComponentScan.Filter(type = FilterType.REGEX, pattern = "^[A-Za-z.]+Dao$")
163        */
164       String[] pattern() default {};
165
166    }
167
168 }

Environment

 1 public interface Environment extends PropertyResolver {
 2
 3    /**
 4     * 这个方法用来取到 ConfigurableEnvironment.setActiveProfiles(String...) 设置的值，这个方法搭配 @Profile 注解使用
 5     * 如 ：
 6     * @Bean()
 7     * @Profile("dev")
 8     * public Student student() {
 9     *  System.out.println("createStudent");
10     *    return new Student("王五", 18);
11     * }
12     *
13     * @Test
14     * public void testImport(){
15     * AnnotationConfigApplicationContext annotationConfigApplicationContext = new AnnotationConfigApplicationContext();
16     * ConfigurableEnvironment environment = annotationConfigApplicationContext.getEnvironment();
17     * environment.setActiveProfiles("dev");
18     * annotationConfigApplicationContext.register(MainConfig2.class);
19     * annotationConfigApplicationContext.refresh();
20     *  String[] beanDefinitionNames = annotationConfigApplicationContext.getBeanDefinitionNames();
21     * for (String s : beanDefinitionNames) {
22     *       System.out.println(s);
23     *    }
24     *  }
25     *
26     * @Profile("dev")
27     * environment.setActiveProfiles("dev");
28     * 当 setActiveProfiles 里的值在 @Profile 中存在，此时就会注册这个Bean
29     * 而 getActiveProfiles 取到的也是 setActiveProfiles 中的值
30     */
31    String[] getActiveProfiles();
32
33    /**
34     * 未明确设置有效配置文件时，返回默认有效的配置文件集
35     */
36    String[] getDefaultProfiles();
37
38    /**
39     * 返回一个或多个给定的配置文件是否处于活动状态，或者在没有显式活动
40     * 配置文件的情况下，返回一个或多个给定的配置文件是否包含在默认配置
41     * 文件集中。 如果个人资料以“！”开头 逻辑取反，即如果给定的配置文件未
42     * 激活，则该方法将返回true。 例如，如果配置文件“ p1”处于活动状态或“
43     * p2”处于非活动状态，则env.acceptsProfiles（“ p1”，“！p2”）将返回true。
44     * 不推荐使用
45     */
46    @Deprecated
47    boolean acceptsProfiles(String... profiles);
48
49    /**
50     * Return whether the {@linkplain #getActiveProfiles() active profiles}
51     * 返回活动概要文件是否 与给定Profiles谓词匹配。，不推荐使用
52     */
53    boolean acceptsProfiles(Profiles profiles);
54
55 }

PropertyResolver

 1 public interface PropertyResolver {
 2
 3    /**
 4     * 判断给定键的值是否为 null
 5     */
 6    boolean containsProperty(String key);
 7
 8    /**
 9     * 返回给定键的值，如果不存在就返回 null
10     * @param key 键
11     */
12    @Nullable
13    String getProperty(String key);
14
15    /**
16     * 返回给定键的值，值若为 null 则返回默认值
17     * @param key 键
18     * @param defaultValue 指定返回的默认值
19     */
20    String getProperty(String key, String defaultValue);
21
22    /**
23     * 返回给定键的值，如果不存在就返回 null，需要指定返回的类型
24     * @param key 键
25     * @param targetType 指定返回的类型，不要用基础类型，用包装类
26     */
27    @Nullable
28    <T> T getProperty(String key, Class<T> targetType);
29
30    /**
31     * 返回给定键的值，如果不存在就返回默认值，需要指定返回的类型
32     * @param key 键
33     * @param targetType 指定的返回类型
34     * @param defaultValue 指定的返回默认值
35     *36     */
37    <T> T getProperty(String key, Class<T> targetType, T defaultValue);
38
39    /**
40     * 返回给定键的值，如果不存在则抛出 IllegalStateException 异常
41     */
42    String getRequiredProperty(String key) throws IllegalStateException;
43
44    /**
45     * 返回给定键的值，如果不存在则抛出 IllegalStateException 异常，需要指定返回类型
46     * targetType 指定返回的类型
47     */
48    <T> T getRequiredProperty(String key, Class<T> targetType) throws IllegalStateException;
49
50    /**
51     * 在给定的文本中解析$ {...}占位符，将其替换为由 getProperty 解析的相应属性值。 没有默认值的无法解析的占位符将被忽略，并按原样传递。
52     * 比如 String str = environment.resolvePlaceholders("这是${os.name}系统");
53     * 返回值为 这是Windows 10系统
54     * @param text 需要被被解析的文本，若文本为 null 则会抛出IllegalStateException 异常
55     */
56    String resolvePlaceholders(String text);
57
58    /**
59     * 在给定的文本中解析$ {...}占位符，将其替换为 getProperty 解析的相应属性值。 没有默认值的无法解析的占位符将导致引发IllegalArgumentException。
60     * 比如 String s = environment.resolveRequiredPlaceholders("${}");
61     * 就会抛出 IllegalArgumentException异常
62     */
63    String resolveRequiredPlaceholders(String text) throws IllegalArgumentException;
64
65 }

ProPertyResolver.getProperty() 能获取的数据（->左边是键，右边是值）

PropertyResolver.getProperty 获取的数据有两类
systemProperties 和 systemEnvironment
systemProperties 数据有（环境会有不同，数据会有区别）

java.runtime.name -> Java(TM) SE Runtime Environment
sun.boot.library.path -> D:\Program Files\Java\jdk1.8.0_171\jre\bin
java.vm.version -> 25.171-b11
java.vm.vendor -> Oracle Corporation
java.vendor.url -> http://java.oracle.com/
path.separator -> ;
java.vm.name -> Java HotSpot(TM) 64-Bit Server VM
file.encoding.pkg -> sun.io
user.country -> CN
user.script ->
sun.java.launcher -> SUN_STANDARD
sun.os.patch.level ->
java.vm.specification.name -> Java Virtual Machine Specification
user.dir -> D:\IDEAworkspaces\learn
intellij.debug.agent -> true
java.runtime.version -> 1.8.0_171-b11
java.awt.graphicsenv -> sun.awt.Win32GraphicsEnvironment
java.endorsed.dirs -> D:\Program Files\Java\jdk1.8.0_171\jre\lib\endorsed
os.arch -> amd64
java.io.tmpdir -> C:\Users\ADMINI~1\AppData\Local\Templine.separator -> "\r\n"
java.vm.specification.vendor -> Oracle Corporation
user.variant ->
os.name -> Windows 10
sun.jnu.encoding -> GBK
java.library.path -> D:\Program Files\Java\jdk1.8.0_171\bin;C:\WINDOWS\Sun\Java\bin;C:\WINDOWS\system32;C:\WINDOWS;D:\Program Files (x86)\NetSarang\Xshell 6\;C:\Program Files (x86)\Intel\Intel(R) Management Engine Components\iCLS\;C:\Program Files\Intel\Intel(R) Management Engine Components\iCLS\;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Windows\System32\OpenSSH\;C:\Program Files (x86)\Intel\Intel(R) Management Engine Components\DAL;C:\Program Files\Intel\Intel(R) Management Engine Components\DAL;C:\Program Files (x86)\Intel\Intel(R) Management Engine Components\IPT;C:\Program Files\Intel\Intel(R) Management Engine Components\IPT;C:\Program Files (x86)\NVIDIA Corporation\PhysX\Common;D:\Program Files\MySQL\MySQL Server 5.5\bin;D:\Program Files\Java\jdk1.8.0_171\bin;D:\Program Files\apache-tomcat-8.5.33\bin;D:\Program Files\apache-maven-3.5.4\bin;D:\Program Files\TortoiseSVN\bin;C:\Program Files\Intel\WiFi\bin\;C:\Program Files\Common Files\Intel\Wirel
jboss.modules.system.pkgs -> com.intellij.rt
java.specification.name -> Java Platform API Specification
java.class.version -> 52.0
sun.management.compiler -> HotSpot 64-Bit Tiered Compilers
os.version -> 10.0
user.home -> C:\Users\Administrator
user.timezone ->
java.awt.printerjob -> sun.awt.windows.WPrinterJob
file.encoding -> UTF-8
java.specification.version -> 1.8
java.class.path -> D:\Program Files\JetBrains\IntelliJ IDEA 2019.2.4\lib\idea_rt.jar;D:\Program Files\JetBrains\IntelliJ IDEA 2019.2.4\plugins\junit\lib\junit-rt.jar;D:\Program Files\JetBrains\IntelliJ IDEA 2019.2.4\plugins\junit\lib\junit5-rt.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\charsets.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\deploy.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext\access-bridge-64.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext\cldrdata.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext\dnsns.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext\jaccess.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext\jfxrt.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext\localedata.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext\nashorn.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext\sunec.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext\sunjce_provider.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext\sunmscapi.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext\sunpkcs11.ja
user.name -> Administrator
java.vm.specification.version -> 1.8
sun.java.command -> com.intellij.rt.execution.junit.JUnitStarter -ideVersion5 -junit4 IocTest,testImport
java.home -> D:\Program Files\Java\jdk1.8.0_171\jre
sun.arch.data.model -> 64
user.language -> zh
java.specification.vendor -> Oracle Corporation
awt.toolkit -> sun.awt.windows.WToolkit
java.vm.info -> mixed mode
java.version -> 1.8.0_171
java.ext.dirs -> D:\Program Files\Java\jdk1.8.0_171\jre\lib\ext;C:\WINDOWS\Sun\Java\lib\ext
sun.boot.class.path -> D:\Program Files\Java\jdk1.8.0_171\jre\lib\resources.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\rt.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\sunrsasign.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\jsse.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\jce.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\charsets.jar;D:\Program Files\Java\jdk1.8.0_171\jre\lib\jfr.jar;D:\Program Files\Java\jdk1.8.0_171\jre\classes
java.vendor -> Oracle Corporation
file.separator -> java.vendor.url.bug -> http://bugreport.sun.com/bugreport/
idea.test.cyclic.buffer.size -> 1048576
sun.io.unicode.encoding -> UnicodeLittle
sun.cpu.endian -> little
sun.desktop -> windows
sun.cpu.isalist -> amd64

systemEnvironment数据有
USERDOMAIN_ROAMINGPROFILE -> LAPTOP-FLP30M67
LOCALAPPDATA -> C:\Users\Administrator\AppData\Local
PROCESSOR_LEVEL -> 6
IntelliJ IDEA -> D:\Program Files\JetBrains\IntelliJ IDEA 2019.2.4\bin;
USERDOMAIN -> LAPTOP-FLP30M67
FPS_BROWSER_APP_PROFILE_STRING -> Internet Explorer
LOGONSERVER -> \\LAPTOP-FLP30M67
JAVA_HOME -> D:\Program Files\Java\jdk1.8.0_171
SESSIONNAME -> Console
ALLUSERSPROFILE -> C:\ProgramData
PROCESSOR_ARCHITECTURE -> AMD64
TNS_ADMIN -> D:\Program Files\instantclient_18_3\network\admin
PSModulePath -> C:\Program Files\WindowsPowerShell\Modules;C:\WINDOWS\system32\WindowsPowerShell\v1.0\Modules
SystemDrive -> C:
MAVEN_HOME -> D:\Program Files\apache-maven-3.5.4
OneDrive -> C:\Users\Administrator\OneDrive
APPDATA -> C:\Users\Administrator\AppData\Roaming
USERNAME -> Administrator
ORACLE_HOME -> D:\Program Files\instantclient_18_3
ProgramFiles(x86) -> C:\Program Files (x86)
CommonProgramFiles -> C:\Program Files\Common Files
Path -> D:\Program Files (x86)\NetSarang\Xshell 6\;C:\Program Files (x86)\Intel\Intel(R) Management Engine Components\iCLS\;C:\Program Files\Intel\Intel(R) Management Engine Components\iCLS\;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Windows\System32\OpenSSH\;C:\Program Files (x86)\Intel\Intel(R) Management Engine Components\DAL;C:\Program Files\Intel\Intel(R) Management Engine Components\DAL;C:\Program Files (x86)\Intel\Intel(R) Management Engine Components\IPT;C:\Program Files\Intel\Intel(R) Management Engine Components\IPT;C:\Program Files (x86)\NVIDIA Corporation\PhysX\Common;D:\Program Files\MySQL\MySQL Server 5.5\bin;D:\Program Files\Java\jdk1.8.0_171\bin;D:\Program Files\apache-tomcat-8.5.33\bin;D:\Program Files\apache-maven-3.5.4\bin;D:\Program Files\TortoiseSVN\bin;C:\Program Files\Intel\WiFi\bin\;C:\Program Files\Common Files\Intel\WirelessCommon\;D:\Program Files\nodejs\;C:\Program Files\NVIDIA Corporation\NVIDIA NvDLISR;d:\Prog
FPS_BROWSER_USER_PROFILE_STRING -> Default
PATHEXT -> .COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.MSC
DriverData -> C:\Windows\System32\Drivers\DriverData
OS -> Windows_NT
COMPUTERNAME -> LAPTOP-FLP30M67
PROCESSOR_REVISION -> 8e0a
CommonProgramW6432 -> C:\Program Files\Common Files
NLS_LANG -> AMERICAN_AMERICA.UTF8
ComSpec -> C:\WINDOWS\system32\cmd.exe
ProgramData -> C:\ProgramData
ProgramW6432 -> C:\Program Files
HOMEPATH -> \Users\Administrator
SystemRoot -> C:\WINDOWS
TEMP -> C:\Users\ADMINI~1\AppData\Local\Temp
HOMEDRIVE -> C:
PROCESSOR_IDENTIFIER -> Intel64 Family 6 Model 142 Stepping 10, GenuineIntel
USERPROFILE -> C:\Users\Administrator
TMP -> C:\Users\ADMINI~1\AppData\Local\Temp
CommonProgramFiles(x86) -> C:\Program Files (x86)\Common Files
ProgramFiles -> C:\Program Files
PUBLIC -> C:\Users\Public
NUMBER_OF_PROCESSORS -> 8
windir -> C:\WINDOWS
=:: -> ::IDEA_INITIAL_DIRECTORY -> C:\Users\Administrator\Desktop

原文地址：https://www.cnblogs.com/chengmi/p/12073945.html

时间： 2024-11-03 21:16:40

@ComponentScan 详解

@ComponentScan

Environment

PropertyResolver

@ComponentScan 详解的相关文章

Spring组件扫描<context:component-scan/>详解

spring注解注入:<context:component-scan>详解（转）

spring组件<context:component-scan>详解

<context:component-scan>详解

spring注解注入:<context:component-scan>详解

Spring事务管理（详解+实例）

一份spring配置文件及其详解

springmvc常用注解标签详解(转载)

Spring JDBC详解