spring源码分析,聊聊PropertyPlaceholderConfigurer
2019獨角獸企業重金招聘Python工程師標準>>>
簡介
最近工作中需要使用zookeeper配置中心管理各系統的配置,也就是需要在項目啟動時,加載zookeeper中節點的子節點的數據(例如數據庫的地址,/config/db.properties/db.addr),并替代spring xml里的占位符。既然需要替代占位符,那么自然會想到PropertyPlaceholderConfigurer這個類,該類實現了在容器的bean初始化前,替代spring容器的BeanDefinition中的值。
本文將對PropertyPlaceholderConfigurer源碼進行解析。
為了簡化整個分析流程,假設定義了一個bean ZookeeperUtil,需要PropertyPlaceholderConfigurer類修改beanDefinition定義,替換${zookeeper.addr}。
<?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/beanshttp://www.springframework.org/schema/beans/spring-beans.xsd"><bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"><property name="ignoreUnresolvablePlaceholders" value="true"/><property name="locations"><array><!--不同容器之間的屬性不能相互訪問--><value>classpath:config.properties</value></array></property></bean><bean class="com.github.thinwonton.spring.source.analysis.ZookeeperUtil"><property name="addr" value="${zookeeper.addr}"/></bean> </beans>什么是BeanFactoryPostProcessor
org.springframework.beans.factory.config.BeanFactoryPostProcessor接口是spring的一個擴展點。它提供了在容器創建bean之前,對bean的定義(配置元數據)進行處理的方法。
BeanFactoryPostProcessor接口定義了一個抽象方法:
void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException;其中,beanFactory是bean工廠,里面封裝了beanDefinition,也就是bean在xml的定義。
postProcessBeanFactory 什么時候調用呢?
在spring容器初始化時,AbstractApplicationContext.class的refresh()方法會被調用,該refresh()方法如下
public void refresh() throws BeansException, IllegalStateException {synchronized (this.startupShutdownMonitor) {// Prepare this context for refreshing.// 記錄啟動時間,設置啟動標識prepareRefresh();// 創建beanFactory;解析spring配置文件;獲取bean的定義,注冊BeanDefinitionConfigurableListableBeanFactory beanFactory = obtainFreshBeanFactory();//為BeanFactory配置容器特性,例如類加載器、事件處理器等 prepareBeanFactory(beanFactory);try // 內容為空的方法,留給子類按需覆寫postProcessBeanFactory(beanFactory);//在這里調用每個BeanFactoryPostProcessor實現類的postProcessBeanFactoryinvokeBeanFactoryPostProcessors(beanFactory);//為BeanFactory注冊BeanPost事件處理器. registerBeanPostProcessors(beanFactory);//初始化信息源,和國際化相關. initMessageSource();//初始化容器事件傳播器. initApplicationEventMulticaster();//調用子類的某些特殊Bean初始化方法 onRefresh();//為事件傳播器注冊事件監聽器. registerListeners();//初始化所有剩余的單例Bean. finishBeanFactoryInitialization(beanFactory);//初始化容器的生命周期事件處理器,并發布容器的生命周期事件 finishRefresh();}catch (BeansException ex) {//銷毀以創建的單態Bean destroyBeans(); //取消refresh操作,重置容器的同步標識. cancelRefresh(ex); throw ex; }}}上面的流程中,在invokeBeanFactoryPostProcessors()被調用之前,spring容器創建了beanFactory,并在beanFactory中保存了spring配置文件中bean的定義。該定義包括了前面xml中定義的兩個bean,一個是PropertyPlaceholderConfigurer,另一個是ZookeeperUtil。注意:是定義不是初始化后的實例。
invokeBeanFactoryPostProcessors()方法,將會對所有實現BeanFactoryPostProcessor接口的bean初始化,并調用postProcessBeanFactory方法。下面一起看下 invokeBeanFactoryPostProcessors 方法。
protected void invokeBeanFactoryPostProcessors(ConfigurableListableBeanFactory beanFactory) {// Invoke BeanDefinitionRegistryPostProcessors first, if any.Set<String> processedBeans = new HashSet<String>();// 忽略代碼,不影響下面分析// 根據類型,從bean factory中獲取bean名稱的列表。bean names在創建bean factory這個容器的時候,已經從xml中讀取并緩存了。// 在這里是需要獲取BeanFactoryPostProcessor.class類型的bean nameString[] postProcessorNames =beanFactory.getBeanNamesForType(BeanFactoryPostProcessor.class, true, false);// 篩選出哪些BeanFactoryPostProcessor的實現類實現了PriorityOrdered、Ordered接口,并把它們的bean name放到相應的列表中// PriorityOrdered、Ordered以及在xml中聲明的順序,影響BeanFactoryPostProcessor的實現類被調用的順序// PropertyPlaceholderConfigurer的父類PropertyResourceConfigurer實現了PriorityOrdered接口,所以它會被加入到priorityOrderedPostProcessors列表中List<BeanFactoryPostProcessor> priorityOrderedPostProcessors = new ArrayList<BeanFactoryPostProcessor>();List<String> orderedPostProcessorNames = new ArrayList<String>();List<String> nonOrderedPostProcessorNames = new ArrayList<String>();for (String ppName : postProcessorNames) {if (processedBeans.contains(ppName)) {// skip - already processed in first phase above}else if (isTypeMatch(ppName, PriorityOrdered.class)) { //這個分支非常奇怪,居然在這里就實例化,然后把實例化的實現類放到集合中,并與下面的分支處理方式不同,肯定不是同一個程序員寫的priorityOrderedPostProcessors.add(beanFactory.getBean(ppName, BeanFactoryPostProcessor.class));}else if (isTypeMatch(ppName, Ordered.class)) {orderedPostProcessorNames.add(ppName);}else {nonOrderedPostProcessorNames.add(ppName);}}// 首先,調用實現了優先級接口的BeanFactoryPostProcessor實現類,同樣實現優先級接口的類通過getOrder()的返回值進行排序,決定調用順序OrderComparator.sort(priorityOrderedPostProcessors);invokeBeanFactoryPostProcessors(priorityOrderedPostProcessors, beanFactory);// 然后,調用實現了Ordered接口的BeanFactoryPostProcessor實現類,同樣實現Ordered接口的類通過getOrder()的返回值進行排序,決定調用順序List<BeanFactoryPostProcessor> orderedPostProcessors = new ArrayList<BeanFactoryPostProcessor>();for (String postProcessorName : orderedPostProcessorNames) {orderedPostProcessors.add(getBean(postProcessorName, BeanFactoryPostProcessor.class));}OrderComparator.sort(orderedPostProcessors);invokeBeanFactoryPostProcessors(orderedPostProcessors, beanFactory);// 最后,調用普通的的BeanFactoryPostProcessor實現類,它的順序由配置文件XML的聲明順序決定List<BeanFactoryPostProcessor> nonOrderedPostProcessors = new ArrayList<BeanFactoryPostProcessor>();for (String postProcessorName : nonOrderedPostProcessorNames) {nonOrderedPostProcessors.add(getBean(postProcessorName, BeanFactoryPostProcessor.class));}invokeBeanFactoryPostProcessors(nonOrderedPostProcessors, beanFactory); }上面的注釋詳細解析了 invokeBeanFactoryPostProcessors 方法的流程,該方法將從bean factory中獲取所有實現BeanFactoryPostProcessor接口的bean名稱,并對bean name列表進行了排序,最后根據bean name實例化它們,并調用BeanFactoryPostProcessor接口的postProcessBeanFactory方法。
在這里,實例化BeanFactoryPostProcessor是通過 beanFactory的getBean() 方法實現的,該方法非常復雜,不是本文的討論范疇。
PropertyPlaceholderConfigurer源碼解析
PropertyPlaceholderConfigurer,用于將properties文件中定義的屬性替換到bean定義的property占位符。
看下它的類圖:
-
PropertiesLoaderSupport:屬性加載幫助類,提供從properties文件中讀取配置信息的能力,該類的屬性locations指定需要加載的文件所在的路徑。
-
PropertyResourceConfigurer:屬性資源的配置類,實現了BeanFactoryPostProcessor接口,因此,在容器初始化的時候,調用的就是該類的實現方法 postProcessBeanFactory() 。在 postProcessBeanFactory()方法中,從配置文件中讀取了配置項,最后調用了它的抽象方法 processProperties(),由子類決定怎么處理這些配置屬性。除此之外,提供了convertProperty()方法,該方法是個擴展點,其實里面什么都沒做,它可以用來子類在處理這些配置信息前,對配置信息進行一些轉換,例如配置屬性的解密。
-
PropertyPlaceholderConfigurer:該類實現了父類PropertyResourceConfigurer的抽象方法processProperties()。processProperties()方法會創建PlaceholderResolvingStringValueResolver類,該類提供解析字符串的方法resolveStringValue。創建了StringValueResolver實現類后,交由它的父類PlaceholderConfigurerSupport的doProcessProperties()處理。另外,占位符的值替換為properties中的值的實際處理類。
-
PlaceholderConfigurerSupport:該類持有占位符符號的前綴、后綴,并在doProcessProperties()模板方法中,對BeanDefinition實例中的占位符進行替換。
-
BeanDefinition:在spring容器初始化時,掃描并獲取每個bean的聲明(例如在xml中聲明、通過注解聲明等),然后組裝成BeanDefinition,它描述了一個bean實例,擁有屬性值,構造參數值和具體實現提供的其他信息。
-
BeanDefinitionVisitor:負責訪問BeanDefinition,包括(1)從beanDefinition實例中,獲取spring約定的可以替換的參數;(2)使用占位符解析器解析占位符,并從properties中獲取它對應的值,最后把值設置到BeanDefinition中。
-
PropertyPlaceholderHelper:持有占位符的前綴、后綴、多值的分隔符,負責把占位符的字符串去除前綴、后綴,對于字符串的替換,委托給PropertyPlaceholderConfigurerResolver類處理。
-
PropertyPlaceholderConfigurerResolver:該類委托給PropertyPlaceholderConfigurer類處理。
接下來我們看一下時序圖,幫助理解上述的類圖和整個解析占位符的過程。
時序圖,配合上面的類圖看,效果更佳!
轉載于:https://my.oschina.net/thinwonton/blog/1104546
總結
以上是生活随笔為你收集整理的spring源码分析,聊聊PropertyPlaceholderConfigurer的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 房贷最迟可以逾期几天
- 下一篇: cmdc是什么币