Spring系列之BeanDefinition

什么是BeanDefinition

官网解释

直接看Spring的官网,在 Bean Overview处有关于BeanDefinition的介绍,具体如下图:
在这里插入图片描述
翻译下大体意思为:springioc容器管理一个或多个bean。这些bean是使用提供给容器的配置元数据创建的。
在容器本身中,这些bean定义表示为BeanDefinition对象,其中包含以下元数据:
1、包限定类名:通常是所定义bean的实际实现类。
2、Bean行为配置元素,它说明Bean在容器中的行为(范围、生命周期回调等)。
3、对bean执行其工作所需的其他bean的引用。这些引用也称为协作者或依赖项。
4、要在新创建的对象 - 中设置的其他配置设置,例如池的大小限制或要在管理连接池的bean中使用的连接数。

总结下:BeanDefinition的就是对Bean的信息进行描述,然后Spring会根据这个来创建对应的Bean。

思考

为何不直接用Class对象创建bean,而是用BeanDefinition来创建?
因为创建bean的过程中不止用到Class对象,还有其他很多属性,如bean的作用域、是否延迟加载、依赖其他Bean的名称等等。

BeanDefinition源码解读

直接上BeanDefinition 类源码

public interface BeanDefinition extends AttributeAccessor, BeanMetadataElement {
	//设置父BeanDefinition名称,创建bean之前存在父BeanDefinition会合并BeanDefinition
	void setParentName(@Nullable String parentName);
	@Nullable
	String getParentName();
	
	//设置bean的class名称
	void setBeanClassName(@Nullable String beanClassName);
	@Nullable
	String getBeanClassName();
	
	//设置bean的作用域,常见的singleton/prototype
	void setScope(@Nullable String scope);
	@Nullable
	String getScope();
	
	//设置是否延迟加载--延迟加载true时容器初始化时不会加载此bean,使用bean时才会加载
	void setLazyInit(boolean lazyInit);
	boolean isLazyInit();
	
	//设置依赖bean,bean加载时会判断时候有依赖别的bean,会先创建依赖的bean
	void setDependsOn(@Nullable String... dependsOn);
	@Nullable
	String[] getDependsOn();
	
	//自动装配的候选的对象
	void setAutowireCandidate(boolean autowireCandidate);
	//是否是自动装配的候选对象
	boolean isAutowireCandidate();
	
	//设置主要的注入的对象
	void setPrimary(boolean primary);
	//获取是否主要的注入对象
	boolean isPrimary();
	
	//设置工厂Bean的名称
	void setFactoryBeanName(@Nullable String factoryBeanName);
	@Nullable
	String getFactoryBeanName();
	
	//设置工厂方法的名称
	void setFactoryMethodName(@Nullable String factoryMethodName);
	@Nullable
	String getFactoryMethodName();
	
	//获取构造器的参数的值
	ConstructorArgumentValues getConstructorArgumentValues();
	//是否构造器参数有值
	default boolean hasConstructorArgumentValues() {
		return !getConstructorArgumentValues().isEmpty();
	}
	//获取属性
	MutablePropertyValues getPropertyValues();
	default boolean hasPropertyValues() {
		return !getPropertyValues().isEmpty();
	}
	
	//设置初始化方法
	void setInitMethodName(@Nullable String initMethodName);
	@Nullable
	String getInitMethodName();
	
	//设置销毁方法
	void setDestroyMethodName(@Nullable String destroyMethodName);
	@Nullable
	String getDestroyMethodName();
	
	//设置bean描述
	void setDescription(@Nullable String description);
	@Nullable
	String getDescription();
	
  	//判断是否是单例
	boolean isSingleton();
  	//判断是否是原型
	boolean isPrototype();
  	//判断是否是抽象
	boolean isAbstract();
	
	//返回原始的BeanDefinition
	@Nullable
	BeanDefinition getOriginatingBeanDefinition();
}

BeanClassName、Scope、isLazyInit、Description演示

@Component
@Scope("singleton")
@Description("这是一个bean的描述注解")
public class MyBean{
}
@Component
public class MyBeanFactoryPostProcessor implements BeanFactoryPostProcessor {
    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException {
        BeanDefinition beanDefinition = beanFactory.getBeanDefinition("myBean");
        System.out.println("BeanClassName:" + beanDefinition.getBeanClassName());
        System.out.println("Scope:" + beanDefinition.getScope());
        System.out.println("isSingleton:" + beanDefinition.isSingleton());
        System.out.println("isLazyInit:" + beanDefinition.isLazyInit());
        System.out.println("Description:" + beanDefinition.getDescription());
    }
}
@Component
@ComponentScan
public class SpringApplicationContext {
    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(SpringApplicationContext.class);
        context.close();
    }
}

接口实现BeanFactoryPostProcessor接口可获取BeanDefinition
运行结果如下:
在这里插入图片描述
表示我们可以获取BeanDefinition的基本信息(BeanFactoryPostProcessor的实现类可以获取修改BeanDefinition,但不可新增删除BeanDefinition)

parentName演示

parentName表示基础ParentBean和ChildBean,属性相同

public class ChildBean {
    private String name;
    private String age;
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getAge() {
        return age;
    }
    public void setAge(String age) {
        this.age = age;
    }
}
public class ParentBean{
    private String name;
    private String age;
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getAge() {
        return age;
    }
    public void setAge(String age) {
        this.age = age;
    }
}

通过BeanDefinitionRegistryPostProcessor的实现类新增BeanDefinition

@Component
public class MyBeanDefinitionRegistryPostProcessor implements BeanDefinitionRegistryPostProcessor {

    @Override
    public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry registry) throws BeansException {
        GenericBeanDefinition parentBeanDefinition = new GenericBeanDefinition();
       parentBeanDefinition.setBeanClass(ParentBean.class);
        //设置ParentBean类的name为parent、age为100属性
        Map<String, String> map = new HashMap<>();
        map.put("name", "parent");
        map.put("age", "100");
        parentBeanDefinition.setPropertyValues(new MutablePropertyValues(map));
        //parentBean注册到BeanDefinitionRegistry中
        registry.registerBeanDefinition("parentBean",parentBeanDefinition);

        GenericBeanDefinition childBeanDefinition = new GenericBeanDefinition();
        //设置父BeanDefinition的名称为parentBean
        //注意此处ChildBean没有设置任何属性
        childBeanDefinition.setParentName("parentBean");
        childBeanDefinition.setBeanClass(ChildBean.class);
        //childBean注册到BeanDefinitionRegistry中
        registry.registerBeanDefinition("childBean",childBeanDefinition);
    }

    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException {

    }
}

最后看启动类和执行结果

@Component
@ComponentScan
public class SpringApplicationContext {
    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(SpringApplicationContext.class);
        ChildBean childBean = context.getBean(ChildBean.class);
        System.out.println(childBean.getName());
        System.out.println(childBean.getAge());
        context.close();
    }
}

在这里插入图片描述
输出结果为name:parent,age:100,可知setParentName见效,创建bean之前合并了父BeanDefinition。
源码见AbstractBeanFactory.doGetBean()
–>getMergedLocalBeanDefinition()

DependsOn演示

A类注解@DependsOn(B类)表示A的依赖于B类,故在创建A类的bean对象前会先创建B类的bean对象。
上代码演示,举例发布和订阅对象,发布对象依赖于订阅对象,如果发布对象先创建会导致信息丢失。

@Component
@DependsOn("subscribeBean")
@Description("这是一个发布消息的bean")
public class PublishBean {
    public PublishBean() {
        System.out.println("PublishBean实例化");
    }
}
@Component
@Description("这是一个订阅消息的bean")
public class SubscribeBean {
    public SubscribeBean() {
        System.out.println("SubscribeBean实例化");
    }
}

最后看启动类

@Component
@ComponentScan
public class SpringApplicationContext {
    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(SpringApplicationContext.class);
        context.close();
    }
}

运行结果:在这里插入图片描述
从运行结果可知,先SubscribeBean先创建,PublishBean后,且运行多次结果相同。可能较真的同学觉得运气好,就是按照这个顺序创建的,我们看下DependsOn最核心的源码。

//获取BeanDefinition的DependsOn依赖
String[] dependsOn = mbd.getDependsOn();
if (dependsOn != null) {
	for (String dep : dependsOn) {
		//校验已注册
		if (isDependent(beanName, dep)) {
			throw new BeanCreationException(mbd.getResourceDescription(), beanName,
					"Circular depends-on relationship between '" + beanName + "' and '" + dep + "'");
		}
		//将依赖的bean写入内存中,表示已注册,用于上面isDependent判断
		registerDependentBean(dep, beanName);
		try {
			//获取bean,获取不到就会去创建bean
			getBean(dep);
		}
		catch (NoSuchBeanDefinitionException ex) {
			throw new BeanCreationException(mbd.getResourceDescription(), beanName,
					"'" + beanName + "' depends on missing bean '" + dep + "'", ex);
		}
	}
}

源码可知,创建bean之前会循环创建所有依赖的bean。

Primary演示

setPrimary:设置主要的注入的对象,意思当从容器中byType取bean对象时,容器中有两个或多个类型的bean,这时容器就不知道取哪个bean出来,便会报错。解决这个问题,可在某个bean上加@Primary注解,表示为主要的注入对象,此时会便会返回此对象。

错误演示:

public class PrimaryBean {
}
@Configuration
@Component
public class Config {
    @Bean
    public PrimaryBean primaryBeanA(){
        return new PrimaryBean();
    }
    @Bean
    public PrimaryBean primaryBeanB(){
        return new PrimaryBean();
    }
}
@Component
@ComponentScan
public class SpringApplicationContext {
    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(SpringApplicationContext.class);
        System.out.println(context.getBean(PrimaryBean.class));
        context.close();
    }
}

我们在Config类中声明两个PrimaryBean类型的bean,在启动类中取类型为PrimaryBean的bean,看运行结果:
在这里插入图片描述
看出此时抛NoUniqueBeanDefinitionException,大概意思发现了2个符合的bean,不知道返回哪个。

我们在Config类中的primaryBeanA方法上加@Primary注解

@Configuration
@Component
public class Config {
    @Bean
    @Primary
    public PrimaryBean primaryBeanA(){
        return new PrimaryBean();
    }
    @Bean
    public PrimaryBean primaryBeanB(){
        return new PrimaryBean();
    }
}

再次运行启动类,看运行结果:
在这里插入图片描述
可以看出,加上@Primary注解解决此问题,可以拿到bean对象。

BeanDefinition分类

搞清楚BeanDefinition的分类,需要看结构图,直接上图。
在这里插入图片描述
图上可以看出,相关的BeanDefinition实现类挺多的,我们挑重要的几个说明下。
首先看GenericBeanDefinition、RootBeanDefinition和ChildBeanDefinition。
从Spring 2.5开始,以编程方式注册Bean定义的首选方式是GenericBeanDefinition类,该类允许通过GenericBeanDefinition的setParentName方法动态定义父依赖项,示例见ParentName方法说明处。对于大多数用例,这有效地代替了RootBeanDefinition和ChildBeanDefinition类。也就是这个两个类是Spring早期的产物,现在完全可以用GenericBeanDefinition类替换。

继续看AnnotatedGenericBeanDefinition、ScannedGenericBeanDefinition、ConfigurationClassBeanDefinition类。

代码演示类型区别:

public class AService {
}
@Component
public class BService {
}
@Configuration
@ComponentScan
public class Config {
    @Bean
    public AService aService(){
        return new AService();
    }
}
public class SpringApplicationContext {
    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(Config.class);
        System.out.println("aService :" + context.getBeanDefinition("aService").getClass().getSimpleName());
        System.out.println("BService :" + context.getBeanDefinition("BService").getClass().getSimpleName());
        System.out.println("config :" + context.getBeanDefinition("config").getClass().getSimpleName());
        context.close();
    }
}

AService类通过@Configuration类下的@Bean方法创建
BService类直接注解@Component,启动扫描时创建
Config 类为@Configuration
执行结果入下:
在这里插入图片描述
总结:
@Configuration注解的被解析成AnnotatedGenericBeanDefinition
@Bean的注解被解析成ConfigurationClassBeanDefinition
@ComponentScan扫描的Bean被解析成ScannedGenericBeanDefinition

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值