一、背景
咱们本人开发了一个第三方的jar包,想和Spring整合起来,并注入到Spring容器中。本人的jar包中,须要退出到Spring容器的类上都退出了一个自定义注解@CustomImport(beanName="")
,beanName
属性的值示意须要注入到Spring容器中的名字。
二、实现计划
1、基于@ComponentScan注解实现
应用此种计划比较简单,间接应用@ComponentScan(includeFilters = {@ComponentScan.Filter(value = CustomImport.class)})
即可将咱们自定义的注解退出到Spring容器中。 此种计划略。
2、基于ImportBeanDefinitionRegistrar和FactoryBean实现
1、实现此接口(ImportBeanDefinitionRegistrar
),能够将咱们本人的BeanDefinition
对象加到BeanDefinitionRegistry
中,期待后续Spring初始化对象。
注:
1. 咱们能够从自定义的注解中获取到一些属性,而后来个性化咱们要初始化的Bean是什么样的。
2. 实现ImportBeanDefinitionRegistrar
的类配合上@Configuration
和@Import
注解,能够在程序启动的时候加载这个类。
2、实现此接口(FactoryBean
),能够让咱们自定义实例化出咱们要构建的Bean。
3、留神
可能有些人会说,我用@ComponentScan就能够搞定的事件,为何还要抉择基于第二种办法实现,这个不是多此一举吗?这个其实我次要是记录这样的一个思路。比方:Mybatis和Spring整合后,只须要申明一个@Mapper
就能够自定退出到Spring治理中(MapperScannerRegistrar
),那么这是怎么实现的呢?应该是和上方的计划2相似。
三、实现步骤
1、自定义一个注解 CustomImport
,被此注解标注的类,示意须要退出到Spring容器中。
- CustomImport 注解能够减少一些额定的属性,比方beanName示意注入到Spring容器时,bean的名字。
2、写一个类实现CustomImportFactoryBean
,示意如何实例化出CustomImport
注解标注的类。
- 结构化对象。
- 结构出的对象须要本人实现初始化操作,如果须要用到Spring的里的对象,能够获取到ApplicationContext而后获取注入。
3、写一个类实现ImportBeanDefinitionRegistrar
,扫描出所有的CustomImport
的类,而后结构出BeanDefinition
,退出到Spring容器中。
- 结构BeanDefinition时的BeanClass属性须要指定上一个的CustomImportFactoryBean的class。
- ClassPathBeanDefinitionScanner能够扫描包。
4、自定义一个注解EnableCustomImport
,启动类上退出此注解后,实现ImportBeanDefinitionRegistrar
的调用。
- 此注解上须要应用
@Import
标注
1、自定义注解CustomImport
/** * 此注解标注的类也会主动退出到 Spring 治理中。 * * @author huan.fu 2021/4/14 - 上午9:23 */@Target({ElementType.TYPE})@Retention(RetentionPolicy.RUNTIME)@Documentedpublic @interface CustomImport { /** * 这个bean注入到Spring容器中的名字 */ String beanName();}
2、实现CustomImportFactoryBean
构建对象
package com.huan.study.framewrok;import org.springframework.beans.BeansException;import org.springframework.beans.factory.FactoryBean;import org.springframework.context.ApplicationContext;import org.springframework.context.ApplicationContextAware;/** * 工厂Bean,用于构建 CustomImport 注解标注的类,如何进行实例化 * * @author huan.fu 2021/4/14 - 上午9:44 */public class CustomImportFactoryBean implements FactoryBean<Object>, ApplicationContextAware { private Class<?> type; private String beanName; private ApplicationContext applicationContext; /** * 此处构建的对象,如果须要依赖Spring Bean的话,须要本人构建进去,默认不会主动注入,即默认状况下@Autowired注解不失效 */ @Override public Object getObject() throws Exception { Object instance = this.type.getDeclaredConstructor().newInstance(); applicationContext.getAutowireCapableBeanFactory().autowireBean(instance); return instance; } @Override public Class<?> getObjectType() { return type; } public Class<?> getType() { return type; } public void setType(Class<?> type) { this.type = type; } public String getBeanName() { return beanName; } public void setBeanName(String beanName) { this.beanName = beanName; } @Override public void setApplicationContext(ApplicationContext applicationContext) throws BeansException { this.applicationContext = applicationContext; }}
3、编写ImportBeanDefinitionRegistrar
package com.huan.study.framewrok;import org.slf4j.Logger;import org.slf4j.LoggerFactory;import org.springframework.beans.factory.annotation.AnnotatedBeanDefinition;import org.springframework.beans.factory.config.BeanDefinition;import org.springframework.beans.factory.support.AbstractBeanDefinition;import org.springframework.beans.factory.support.BeanDefinitionBuilder;import org.springframework.beans.factory.support.BeanDefinitionRegistry;import org.springframework.context.EnvironmentAware;import org.springframework.context.ResourceLoaderAware;import org.springframework.context.annotation.ClassPathBeanDefinitionScanner;import org.springframework.context.annotation.ImportBeanDefinitionRegistrar;import org.springframework.core.annotation.AnnotationAttributes;import org.springframework.core.env.Environment;import org.springframework.core.io.ResourceLoader;import org.springframework.core.type.AnnotationMetadata;import org.springframework.core.type.filter.AnnotationTypeFilter;import java.util.Map;import java.util.Optional;import java.util.Set;/** * @author huan.fu 2021/4/14 - 上午9:25 */public class CustomImportBeanDefinitionRegistrar implements ImportBeanDefinitionRegistrar, ResourceLoaderAware, EnvironmentAware { private static final Logger log = LoggerFactory.getLogger(CustomImportBeanDefinitionRegistrar.class); private Environment environment; private ResourceLoader resourceLoader; @Override public void registerBeanDefinitions(AnnotationMetadata annotationMetadata, BeanDefinitionRegistry registry) { if (!annotationMetadata.hasAnnotation(EnableCustomImport.class.getName())) { return; } Map<String, Object> annotationAttributesMap = annotationMetadata.getAnnotationAttributes(EnableCustomImport.class.getName()); AnnotationAttributes annotationAttributes = Optional.ofNullable(AnnotationAttributes.fromMap(annotationAttributesMap)).orElseGet(AnnotationAttributes::new); // 获取须要扫描的包 String[] packages = retrievePackagesName(annotationMetadata, annotationAttributes); // useDefaultFilters = false,即第二个参数 示意不扫描 @Component、@ManagedBean、@Named 注解标注的类 ClassPathBeanDefinitionScanner scanner = new ClassPathBeanDefinitionScanner(registry, false, environment, resourceLoader); // 增加咱们自定义注解的扫描 scanner.addIncludeFilter(new AnnotationTypeFilter(CustomImport.class)); // 扫描包 for (String needScanPackage : packages) { Set<BeanDefinition> candidateComponents = scanner.findCandidateComponents(needScanPackage); try { registerCandidateComponents(registry, candidateComponents); } catch (ClassNotFoundException e) { log.error(e.getMessage(), e); } } } /** * 获取须要扫描的包 */ private String[] retrievePackagesName(AnnotationMetadata annotationMetadata, AnnotationAttributes annotationAttributes) { String[] packages = annotationAttributes.getStringArray("packages"); if (packages.length > 0) { return packages; } String className = annotationMetadata.getClassName(); int lastDot = className.lastIndexOf('.'); return new String[]{className.substring(0, lastDot)}; } /** * 注册 BeanDefinition */ private void registerCandidateComponents(BeanDefinitionRegistry registry, Set<BeanDefinition> candidateComponents) throws ClassNotFoundException { for (BeanDefinition candidateComponent : candidateComponents) { if (candidateComponent instanceof AnnotatedBeanDefinition) { AnnotatedBeanDefinition annotatedBeanDefinition = (AnnotatedBeanDefinition) candidateComponent; AnnotationMetadata annotationMetadata = annotatedBeanDefinition.getMetadata(); Map<String, Object> customImportAnnotationAttributesMap = annotationMetadata.getAnnotationAttributes(CustomImport.class.getName()); AnnotationAttributes customImportAnnotationAttributes = Optional.ofNullable(AnnotationAttributes.fromMap(customImportAnnotationAttributesMap)).orElseGet(AnnotationAttributes::new); String beanName = customImportAnnotationAttributes.getString("beanName"); String className = annotationMetadata.getClassName(); Class<?> clazzName = Class.forName(className); AbstractBeanDefinition beanDefinition = BeanDefinitionBuilder.genericBeanDefinition(CustomImportFactoryBean.class) .addPropertyValue("type", clazzName) .addPropertyValue("beanName", beanName) .setAutowireMode(AbstractBeanDefinition.AUTOWIRE_BY_TYPE) .setRole(BeanDefinition.ROLE_INFRASTRUCTURE) .getBeanDefinition(); registry.registerBeanDefinition(beanName, beanDefinition); } } } @Override public void setEnvironment(Environment environment) { this.environment = environment; } @Override public void setResourceLoader(ResourceLoader resourceLoader) { this.resourceLoader = resourceLoader; }}
4、编写@EnableCustomImport
/** * 启用主动导入 * * @author huan.fu 2021/4/14 - 上午9:29 */@Target({ElementType.TYPE})@Retention(RetentionPolicy.RUNTIME)@Documented@Import(CustomImportBeanDefinitionRegistrar.class)public @interface EnableCustomImport { String[] packages() default {};}
5、运行一个小的案例,获取测试后果
四、实现代码
1、https://gitee.com/huan1993/spring-cloud-parent/tree/master/springboot/bean-definition-registrar
五、参考链接
1、https://stackoverflow.com/questions/4970297/how-to-get-beans-created-by-factorybean-spring-managed