Spring Bean生命周期之Bean元信息的配置与解析阶段详解

 更新时间:2022年03月04日 15:16:05   作者:码农的进阶之路  
这篇文章主要为大家详细介绍了Spring Bean生命周期之Bean元信息的配置与解析阶段,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助

写在前面

注:本文章使用的 SpringBoot 版本为 2.2.4.RELEASE,其 Spring 版本为 5.2.3.RELEASE

虽然Bean的创建可以采用BeanDefinition API 也可以直接采用注解方式,但从学习角度出发这里主要以API形式创建Bean。下面以一段Bean创建的示例来引出讨论的议题。

public class XmlBeanMetaDataConfigDemo {
    public static void main(String[] args) {
        DefaultListableBeanFactory beanFactory = new DefaultListableBeanFactory();
        XmlBeanDefinitionReader beanDefinitionReader = new XmlBeanDefinitionReader(beanFactory);
        int beanDefinitions = beanDefinitionReader.loadBeanDefinitions("META-INF/spring.xml");
        System.out.println("加载的BeanDefinition个数为:" + beanDefinitions);
		//User就是普通的POJO类 这里不再给出User定义
        User user = beanFactory.getBean("user", User.class);
        System.out.println(user);
    }
}
<?xml version="1.0" encoding="UTF-8"?>
<beans
        xmlns="http://www.springframework.org/schema/beans"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd">
    <bean id="user" class="com.wojiushiwo.dto.User">
        <property name="name" value="wojiushiwo"/>
        <property name="age" value="18"/>
    </bean>
</beans>

上面代码 是使用BeanDefinitionReader去加载XML文件中的Bean定义

BeanDefinitionReader体系

先来看一下BeanDefinitionReader的接口定义以及继承关系

在这里插入图片描述

通过上面的类图我们发现BeanDefinitionReader有三个实现类,可以看出针对BeanDefiniiton的不同载体 均提供了解析手段,有XML形式的、有Properties形式的等等。

BeanDefinitionReader接口定义

public interface BeanDefinitionReader {
  //返回注册了当前BeanDefinition的 BeanFactory
	BeanDefinitionRegistry getRegistry();
	@Nullable
	ResourceLoader getResourceLoader();
	@Nullable
	ClassLoader getBeanClassLoader();
	//BeanName 生成器,默认是DefaultBeanNameGenerator
	BeanNameGenerator getBeanNameGenerator();

  //从指定资源中加载BeanDefinition,并返回加载到的BeanDefinition的个数
	int loadBeanDefinitions(Resource resource) throws BeanDefinitionStoreException;
	int loadBeanDefinitions(Resource... resources) throws BeanDefinitionStoreException;
	//从指定资源路径中中加载BeanDefinition,并返回加载到的BeanDefinition的个数
	int loadBeanDefinitions(String location) throws BeanDefinitionStoreException;
	int loadBeanDefinitions(String... locations) throws BeanDefinitionStoreException;
}

由于Bean元信息的配置与解析是息息相关的,下面的一些例子也是将它们揉在一起讨论的。

元信息配置与解析方式

1、API方式

这种方式直接采用BeanDefinitionAPI 来构成Bean元信息,并将其注入到IoC容器中,这里主要使用到BeanDefinitionBuilderGenericBeanDefinition两种方式来创建Bean元信息

关于BeanDefinition这个议题的讨论会放在其他篇章中,这里不再赘述了。

public class ApiBeanMetaDataConfigDemo {
    public static void main(String[] args) {
        //创建注解相关的上下文
        AnnotationConfigApplicationContext context=new AnnotationConfigApplicationContext();
	    //创建GenericBeanDefinition			
        GenericBeanDefinition beanDefinition=new GenericBeanDefinition();
        //设置BeanClass
        beanDefinition.setBeanClass(User.class);
        //设置属性
        MutablePropertyValues propertyValues=new MutablePropertyValues();
        propertyValues.addPropertyValue("name","我就是我");
        propertyValues.addPropertyValue("age",18);
        beanDefinition.setPropertyValues(propertyValues);
		//注册BeanDefinition
        context.registerBeanDefinition("user",beanDefinition);
		//刷新IoC容器
        context.refresh();
		//获取Bean
        User user = context.getBean("user", User.class);
        System.out.println(user);
		//关闭上下文
        context.close();
    }
}

2、面向XML配置

从XML配置资源处 加载BeanDefinition

<?xml version="1.0" encoding="UTF-8"?>
<beans
        xmlns="http://www.springframework.org/schema/beans"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd">

    <bean id="user" class="com.wojiushiwo.dto.User">
        <property name="name" value="wojiushiwo"/>
        <property name="age" value="18"/>
    </bean>
</beans>
public class XmlBeanMetaDataConfigDemo {
    public static void main(String[] args) {
        DefaultListableBeanFactory beanFactory = new DefaultListableBeanFactory();
        XmlBeanDefinitionReader beanDefinitionReader = new XmlBeanDefinitionReader(beanFactory);
        //加载指定文件的BeanDefinition,并获取加载地BeanDefinition个数
        int beanDefinitions = beanDefinitionReader.loadBeanDefinitions("META-INF/spring.xml");
        System.out.println("加载的BeanDefinition个数为:" + beanDefinitions);
        User user = beanFactory.getBean("user", User.class);
        System.out.println(user);
    }
}

3、面向Properties配置

这种配置方式不太常用,配置资源时需要遵守规则,配置规则可参考PropertiesBeanDefinitionReader注释文档,其规则如下

Properties 属性名使用场景
(class) Bean类全称限定名
(abstract)是否为抽象的 BeanDefinition
(parent)指定 parent BeanDefinition 名称
(lazy-init)是否为延迟初始化
(ref)引用其他 Bean 的名称
(scope)设置 Bean 的 scope 属性
${n}n 表示第 n+1 个构造器参数
## 指定BeanClass
user.(class)=com.wojiushiwo.dto.User
## 属性
user.name=我就是我
user.age=19
public class PropertiesBeanMetaDataConfigDemo {
    public static void main(String[] args) {
        DefaultListableBeanFactory beanFactory = new DefaultListableBeanFactory();
        PropertiesBeanDefinitionReader beanDefinitionReader = new PropertiesBeanDefinitionReader(beanFactory);
        ClassPathResource classPathResource=new ClassPathResource("META-INF/user.properties");
        EncodedResource resource=new EncodedResource(classPathResource,"UTF-8");
        int beanDefinitions = beanDefinitionReader.loadBeanDefinitions(resource);
        System.out.println("加载的BeanDefinition个数为:" + beanDefinitions);
        User user = beanFactory.getBean("user", User.class);
        System.out.println(user);
    }
}

上面 Properties文件默认读写编码为ISO-8859-1 因此这种直接加载方式会出现中文乱码,可通过加载在加载资源时指定编码方式来解决

4、面向注解

比如@Autowired@Bean@Component@Configuration等,这些在当下都比较常用不再赘述

XmlBeanDefinitionReader元信息解析 源码分析

在这里插入图片描述

下面就XmlBeanDefinitionReader调用链中比较重要的地方进行分析

protected int doLoadBeanDefinitions(InputSource inputSource, Resource resource)
			throws BeanDefinitionStoreException {
		try {
		    //解析Xml文件生成Document,这里不再展开
			Document doc = doLoadDocument(inputSource, resource);
			// 解析Document 注册BeanDefinition
			int count = registerBeanDefinitions(doc, resource);
			//省略日志打印
			return count;
		}
		catch (BeanDefinitionStoreException ex) {
			//... 异常及日志
			}
	}
public int registerBeanDefinitions(Document doc, Resource resource) throws BeanDefinitionStoreException {
        //获取DefaultBeanDefinitionReader
		BeanDefinitionDocumentReader documentReader = createBeanDefinitionDocumentReader();
		//获取IoC容器中 已经存在的BeanDefinition的个数
		int countBefore = getRegistry().getBeanDefinitionCount();
		//这里实际上执行解析Document文档树 注册BeanDefinition
		documentReader.registerBeanDefinitions(doc, createReaderContext(resource));
		//返回此次加载的BeanDefinition个数
		return getRegistry().getBeanDefinitionCount() - countBefore;
	}
protected void doRegisterBeanDefinitions(Element root) {
		BeanDefinitionParserDelegate parent = this.delegate;
		this.delegate = createDelegate(getReaderContext(), root, parent);
		// namespace=http://www.springframework.org/schema/beans 表示为默认命名空间 则使用默认的解析方式去解析元素,否则将采用NamespaceHandler去解析
		if (this.delegate.isDefaultNamespace(root)) {
		    //获取profile属性,profile与Spring配置环境有关系
			String profileSpec = root.getAttribute(PROFILE_ATTRIBUTE);
			//如果配置了profile
			if (StringUtils.hasText(profileSpec)) {
				String[] specifiedProfiles = StringUtils.tokenizeToStringArray(
						profileSpec, BeanDefinitionParserDelegate.MULTI_VALUE_ATTRIBUTE_DELIMITERS);
      //如果当前Environment环境与profile不匹配 则流程结束
				if (!getReaderContext().getEnvironment().acceptsProfiles(specifiedProfiles)) {
					//省略日志
					return;
				}
			}
		}
	    //解析xml前置操作		
		preProcessXml(root);
		//解析xml
		parseBeanDefinitions(root, this.delegate);
		//解析xml后置操作
		postProcessXml(root);
		this.delegate = parent;
	}

关于上面源码分析中profile以及NameSpace的理解 请看这里的XML

<beans
        xmlns="http://www.springframework.org/schema/beans" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:context="http://www.springframework.org/schema/context"
        xsi:schemaLocation="http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        https://www.springframework.org/schema/context/spring-context.xsd" profile="dev">
        <!-- 一些配置-->
</beans>

可以看出 xmlns所指代的就是namespace,而profile也可以配置在beans标签上,其中

http://www.springframework.org/schema/beans 

表示默认命名空间。因为Spring允许自定义标签,所以通过是否为默认命名空间作为判断依据来选择使用不同的解析方式去解析标签

protected void parseBeanDefinitions(Element root, BeanDefinitionParserDelegate delegate) {
		//如果是默认命名空间
		if (delegate.isDefaultNamespace(root)) {
			NodeList nl = root.getChildNodes();
			for (int i = 0; i < nl.getLength(); i++) {
				Node node = nl.item(i);
				if (node instanceof Element) {
					Element ele = (Element) node;
					if (delegate.isDefaultNamespace(ele)) {
						parseDefaultElement(ele, delegate);
					}
					else {
					    // 使用NamespaceHandler去解析标签,比如ContextNamespaceHandler去解析<context:xx>的标签等
						delegate.parseCustomElement(ele);
					}
				}
			}
		}
		else {
		  // 使用NamespaceHandler去解析标签,比如ContextNamespaceHandler去解析<context:xx>的标签等
			delegate.parseCustomElement(root);
		}
	}

上面的代码逻辑,根据是否为默认命名空间从而选择不同的解析方式,自定义标签或非默认命名空间指令 需要继承NamespaceHandler去实现自己的标签解析方式

非默认命名空间指令举例

<context:component-scan base-package="com.wojiushiwo"/><aop:xx></aop><context:component-scan base-package="com.wojiushiwo"/>
<aop:xx></aop>

这里直接看针对默认命名空间的解析代码

private void parseDefaultElement(Element ele, BeanDefinitionParserDelegate delegate) {
        //如果是import指令
		if (delegate.nodeNameEquals(ele, IMPORT_ELEMENT)) {
			importBeanDefinitionResource(ele);
		}
		//如果是alias指令
		else if (delegate.nodeNameEquals(ele, ALIAS_ELEMENT)) {
			processAliasRegistration(ele);
		}
		//如果是bean指令
		else if (delegate.nodeNameEquals(ele, BEAN_ELEMENT)) {
			processBeanDefinition(ele, delegate);
		}
		else if (delegate.nodeNameEquals(ele, NESTED_BEANS_ELEMENT)) {
			// recurse
			doRegisterBeanDefinitions(ele);
		}
	}

针对bean指令

protected void processBeanDefinition(Element ele, BeanDefinitionParserDelegate delegate) {
		BeanDefinitionHolder bdHolder = delegate.parseBeanDefinitionElement(ele);
		if (bdHolder != null) {
			bdHolder = delegate.decorateBeanDefinitionIfRequired(ele, bdHolder);
			try {
//使用BeanRegistry对BeanDefinition进行注册		BeanDefinitionReaderUtils.registerBeanDefinition(bdHolder, getReaderContext().getRegistry());
			}
			catch (BeanDefinitionStoreException ex) {
				getReaderContext().error("Failed to register bean definition with name '" +
						bdHolder.getBeanName() + "'", ele, ex);
			}
			// Send registration event.
			getReaderContext().fireComponentRegistered(new BeanComponentDefinition(bdHolder));
		}
	}

我们再来梳理下主要流程:

1、解析Xml文件 生成Document

2、针对Document命名空间进行标签解析

  • 默认命名空间 标签解析
  • 非默认命名空间或自定义标签 自行实现NamespaceHandler去解析(Spring 内置了一些NamespaceHandler解析自定义标签)

3、使用BeanRegistry对BeanDefinition进行注册

AnnotatedBeanDefinitionReader元信息解析 源码分析

AnnotatedBeanDefinitionReader从名称上看它似乎与BeanDefinitionReader有千丝万缕的关系,实质上二者没有关系。
AnnotatedBeanDefinitionReader主要是 对注解Bean进行解析的。

先举例说明下

@Configuration
public class BeanInitializationDemo {
    public static void main(String[] args) {
        AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext();
        // 注册 Configuration Class(配置类)
      applicationContext.register(BeanInitializationDemo.class);
        // 启动 Spring 应用上下文
        applicationContext.refresh();
        applicationContext.close();
    }
}

借助上面的例子我们看一下其调用流程

在这里插入图片描述

以上面的例子来看,AnnotationBeanDefinitionReader的创建是在AnnotationConfigApplicationContext构造函数中进行的。

public class AnnotationConfigApplicationContext extends GenericApplicationContext implements AnnotationConfigRegistry {
	private final AnnotatedBeanDefinitionReader reader;
	private final ClassPathBeanDefinitionScanner scanner;
	public AnnotationConfigApplicationContext() {
	  //创建AnnotatedBeanDefinitionReader
		this.reader = new AnnotatedBeanDefinitionReader(this);
		this.scanner = new ClassPathBeanDefinitionScanner(this);
	}
}	
public static void registerBeanDefinition(
			BeanDefinitionHolder definitionHolder, BeanDefinitionRegistry registry)
			throws BeanDefinitionStoreException {
		// 获取BeanName
		String beanName = definitionHolder.getBeanName();
		//注册bd到IoC容器
		registry.registerBeanDefinition(beanName, definitionHolder.getBeanDefinition());
		// 如果bean存在别名,则将beanName与alias的关系也存起来
		String[] aliases = definitionHolder.getAliases();
		if (aliases != null) {
			for (String alias : aliases) {
				registry.registerAlias(beanName, alias);
			}
		}
	}

透过上面XmlBeanDefinitionReaderAnnotationBeanDefinitionReader对BeanDefinition的解析来看,最终BeanDefinition的注册都指向了BeanDefinitionReaderUtils.registerBeanDefinition。我们先来大概看一下代码实现

public static void registerBeanDefinition(
			BeanDefinitionHolder definitionHolder, BeanDefinitionRegistry registry)
			throws BeanDefinitionStoreException {
		// 获取BeanName
		String beanName = definitionHolder.getBeanName();
		//注册bd到IoC容器
		registry.registerBeanDefinition(beanName, definitionHolder.getBeanDefinition());
		// 如果bean存在别名,则将beanName与alias的关系也存起来
		String[] aliases = definitionHolder.getAliases();
		if (aliases != null) {
			for (String alias : aliases) {
				registry.registerAlias(beanName, alias);
			}
		}
	}

总结

本篇文章就到这里了,希望能够给你带来帮助,也希望您能够多多关注脚本之家的更多内容!  

相关文章

  • Java设计模式之共享模式/享元模式(Flyweight模式)介绍

    Java设计模式之共享模式/享元模式(Flyweight模式)介绍

    这篇文章主要介绍了Java设计模式之共享模式/享元模式(Flyweight模式)介绍,本文讲解了为什么使用共享模式/享元模式、如何使用共享模式/享元模式、Flyweight模式在XML等数据源中应用等内容,需要的朋友可以参考下
    2015-03-03
  • 详解Java线程堆栈

    详解Java线程堆栈

    本篇文章主要给大家讲了Java线程堆栈的详细原理以及用法,需要的朋友跟着学习下吧。
    2017-12-12
  • Java实现的汉语拼音工具类完整实例

    Java实现的汉语拼音工具类完整实例

    这篇文章主要介绍了Java实现的汉语拼音工具类,结合完整实例形式分析了java基于pinyin4j包实现编码转换的相关操作技巧,需要的朋友可以参考下
    2017-11-11
  • java8新特性之stream流中reduce()求和知识总结

    java8新特性之stream流中reduce()求和知识总结

    今天带大家回顾Java8的新特性,文中对stream流中reduce()求和的相关知识作了详细的介绍,对正在学习java的小伙伴们有很好地帮助,需要的朋友可以参考下
    2021-05-05
  • 浅谈java异常处理之空指针异常

    浅谈java异常处理之空指针异常

    下面小编就为大家带来一篇浅谈java异常处理之空指针异常。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-10-10
  • Java实现入参数据批量数据校验详解

    Java实现入参数据批量数据校验详解

    在业务处理中一般入参是单条数据,这样数据校验比较容易,但是这种方法对于集合数据的校验不适用,下面我们就来看看如何对入参数据进行批量数据校验吧
    2024-02-02
  • Java深入讲解static操作符

    Java深入讲解static操作符

    static关键字基本概念我们可以一句话来概括:方便在没有创建对象的情况下来进行调用。也就是说:被static关键字修饰的不需要创建对象去调用,直接根据类名就可以去访问,让我们来了解一下你可能还不知道情况
    2022-07-07
  • 使用Java将字符串在ISO-8859-1和UTF-8之间相互转换

    使用Java将字符串在ISO-8859-1和UTF-8之间相互转换

    大家都知道在一些情况下,我们需要特殊的编码格式,如:UTF-8,但是系统默认的编码为ISO-8859-1,遇到这个问题,该如何对字符串进行两个编码的转换呢,下面小编给大家分享下java中如何在ISO-8859-1和UTF-8之间相互转换,感兴趣的朋友一起看看吧
    2021-12-12
  • Idea打War包流程图文教程

    Idea打War包流程图文教程

    这篇文章主要给大家介绍了关于Idea打War包流程的相关资料,IDEA导出war包的方式与MyEclipse有一点不同,文中通过图文介绍的非常详细,需要的朋友可以参考下
    2023-08-08
  • Mybatis-Plus支持GBase8s分页查询的实现示例

    Mybatis-Plus支持GBase8s分页查询的实现示例

    本文主要介绍了使 Mybatis-Plus 支持 GBase8s 的分页查询,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-01-01

最新评论