Spring(三)核心容器 - ApplicationContext 上下文啟動准備


前言

前面介紹了 Spring 容器的概念,其核心可歸納為兩個類: BeanFactory 和 ApplicationContext,ApplicationContext 繼承自 BeanFactory ,其不僅包含 BeanFactory 所有功能,還擴展了容器功能。之后介紹了在 SSM 時期和 SpringBoot 時期如何啟動 ApplicationContext 。在結尾處,我們指出,ApplicationContext 核心其實是 refresh 方法,容器一系列功能都在該方法中實現,如:注冊 Bean、注入 Bean 等。

在 refresh 方法中,實現容器核心功能前,先進行了一系列環境准備工作,我們以 SpringBoot 為當前運行環境,深入討論這部分內容。

注:本篇文章使用的 SpringBoot 版本為 2.0.3.RELEASE,其 Spring 版本為 5.0.7.RELEASE

正文

refresh 方法定義在 ConfigurableApplicationContext 接口中,被 AbstractApplicationContext 抽象類實現,該方法由十幾個子方法組成,這些子方法各司其職,但部分子方法被 AbstractApplicationContext 的子類進行擴展,來增強功能。其中,前四個子方法主要進行上下文准備工作。

第一步:prepareRefresh

我們先從 refresh 中的 prepareRefresh 方法開始討論:

public void refresh() throws BeansException, IllegalStateException {
	synchronized (this.startupShutdownMonitor) {
		// 初始化上下文環境,就是記錄下容器的啟動時間、活動狀態等
		prepareRefresh();

		...
    }
}

該方法被繼承 AbstractApplicationContext 抽象類的子類進行擴展,擴展該方法的子類有:

image

因本次演示的環境是 SpringBoot ,前面我們講過,SpringBoot 會根據當前 Web 應用類型創建不同的上下文對象 ,如 Servlet Web、Reactive Web 等。這里演示的是 Servlet Web 應用,所以創建的上下文對象是 AnnotationConfigServletWebServerApplicationContext 。該類的 prepareRefresh 方法會被執行:

public class AnnotationConfigServletWebServerApplicationContext
		extends ServletWebServerApplicationContext implements AnnotationConfigRegistry {

    ...
	
	@Override
	protected void prepareRefresh() {
	
	    // 清除 Class 的元數據緩存。底層用 Map 保存元數據,執行 Map 的 clear 方法
		this.scanner.clearCache();
		
		// 調用父類,也就是 AbstractApplicationContext 的 prepareRefresh 方法
		super.prepareRefresh();
	}
	...	    
}
public abstract class AbstractApplicationContext {
    
    ...
    
    private long startupDate;
    
    private final AtomicBoolean active = new AtomicBoolean();

	private final AtomicBoolean closed = new AtomicBoolean();

    private Set<ApplicationEvent> earlyApplicationEvents;

    ...

    protected void prepareRefresh() {
        
        // 記錄此上下文開始時的系統時間(以毫秒為單位)
    	this.startupDate = System.currentTimeMillis();
    	
    	// 記錄此上下文是否已關閉,這里設置為未關閉
    	this.closed.set(false);
    	
    	// 記錄此上下文是否處於活動狀態,這里設置為活動狀態
    	this.active.set(true);
    
    	if (logger.isInfoEnabled()) {
    		logger.info("Refreshing " + this);
    	}
    
    	// 這也是交由子類擴展的方法。具體子類為 GenericWebApplicationContext,主要是初始化屬性源,
    	// 將 ServletContext 和 ServletConfig 屬性配置添加到 Environment 環境上下文中
    	initPropertySources();
    
    	// 校驗 Environment 中那些必備的屬性配置是否存在,不存在則拋異常。
    	getEnvironment().validateRequiredProperties();
    
    	// 創建 ApplicationEvent 事件集合
    	this.earlyApplicationEvents = new LinkedHashSet<>();
    }

}

refresh 中的 prepareRefresh 方法執行結束,主要是記錄容器的啟動時間、活動狀態、檢查必備屬性是否存在。其中,關於 Environment 環境配置,在前面 SpringBoot 系列文章《SpringBoot(五)外部化配置之Environment》中有詳細討論,感興趣的同學可自行翻閱。

第二步:obtainFreshBeanFactory

接着進入 refresh 中的 obtainFreshBeanFactory 方法

public abstract class AbstractApplicationContext {
    
    ...
    
    public void refresh() throws BeansException, IllegalStateException {
    	synchronized (this.startupShutdownMonitor) {
    		
    		...
            
    		ConfigurableListableBeanFactory beanFactory = obtainFreshBeanFactory();
    
    		...
    	}
    }
    ...
    
    protected ConfigurableListableBeanFactory obtainFreshBeanFactory() {
        // 該方法也是由子類擴展,其子類有 AbstractRefreshableApplicationContext 和 GenericApplicationContext,
        // 因當前是 Servlet Web 應用,所以執行的是 GenericApplicationContext 中的 refreshBeanFactory 方法。
        // 該方法主要設置 BeanFactory 的 serializationId 屬性值,也就是序列化id
    	refreshBeanFactory();
    	
    	// 通過 getBeanFactory 返回 BeanFactory 對象。同樣也是由子類擴展,調用的是 GenericApplicationContext 類中的 getBeanFactory 方法。
    	// 返回的是 DefaultListableBeanFactory 。
    	ConfigurableListableBeanFactory beanFactory = getBeanFactory();
    	if (logger.isDebugEnabled()) {
    		logger.debug("Bean factory for " + getDisplayName() + ": " + beanFactory);
    	}
    	return beanFactory;
    }
    
    ...
}

obtainFreshBeanFactory 方法很簡單,但如果當前是非 Servlet Web 應用,執行的就是 AbstractRefreshableApplicationContext 中的 refreshBeanFactory 方法,那可就復雜多了,這里就不展開討論。之后,該方法還返回了 BeanFactory 對象,從這也可以看出 ApplicationContext 底層是以 BeanFactory 為基礎,逐步擴展 Spring 容器功能。

第三步:prepareBeanFactory

接着進入 refresh 中的 prepareBeanFactory 方法。prepareBeanFactory 方法主要是對 BeanFactory 做一些配置,包含各種類加載器、需要忽略的依賴以及后置處理器、解析器等,

public void refresh() throws BeansException, IllegalStateException {
    synchronized (this.startupShutdownMonitor) {
			
        ...
        
		prepareBeanFactory(beanFactory);
		...	
    }
    ...
}

protected void prepareBeanFactory(ConfigurableListableBeanFactory beanFactory) {
	// 設置類加載器
	beanFactory.setBeanClassLoader(getClassLoader());
	// 設置表達式解析器,主要用來解析 EL 表達式; Bean 初始化完成后填充屬性時會用到
	beanFactory.setBeanExpressionResolver(new StandardBeanExpressionResolver(beanFactory.getBeanClassLoader()));
	// 設置屬性注冊解析器,主要用來解析 Bean 中的各種屬性類型,如 String、int 等
	beanFactory.addPropertyEditorRegistrar(new ResourceEditorRegistrar(this, getEnvironment()));
	// 添加一個后置處理器:ApplicationContextAwareProcessor。
	// 該后置處理器用於向實現了 Aware 系列接口的 bean 設置相應屬性。
	// (后置處理器和 Aware 接口也是比較核心的概念,后面會有文章詳細討論)
	beanFactory.addBeanPostProcessor(new ApplicationContextAwareProcessor(this));
	
	// 以下接口,在自動注入時會被忽略,其都是 Aware 系列接口
	beanFactory.ignoreDependencyInterface(EnvironmentAware.class);
	beanFactory.ignoreDependencyInterface(EmbeddedValueResolverAware.class);
	beanFactory.ignoreDependencyInterface(ResourceLoaderAware.class);
	beanFactory.ignoreDependencyInterface(ApplicationEventPublisherAware.class);
	beanFactory.ignoreDependencyInterface(MessageSourceAware.class);
	beanFactory.ignoreDependencyInterface(ApplicationContextAware.class);

	// 當以下特殊的 Bean 需自動注入時,指定其注入的類型 。
	// 如:注入 BeanFactory 時,注入的類型對象為 ConfigurableListableBeanFactory 。
	beanFactory.registerResolvableDependency(BeanFactory.class, beanFactory);
	beanFactory.registerResolvableDependency(ResourceLoader.class, this);
	beanFactory.registerResolvableDependency(ApplicationEventPublisher.class, this);
	beanFactory.registerResolvableDependency(ApplicationContext.class, this);

	// 添加 ApplicationListenerDetector 后置處理器。
	// 該后置處理器用來檢測那些實現了 ApplicationListener 接口的 bean,並將其添加到應用上下文的事件廣播器上。
	beanFactory.addBeanPostProcessor(new ApplicationListenerDetector(this));

	// 判斷容器中是否存在 loadTimeWeaver Bean,如果存在則上下文使用臨時的 ClassLoader 進行類型匹配。
	// 集成 AspectJ 時會用到 loadTimeWeaver 對象。
	if (beanFactory.containsBean(LOAD_TIME_WEAVER_BEAN_NAME)) {
		beanFactory.addBeanPostProcessor(new LoadTimeWeaverAwareProcessor(beanFactory));
		beanFactory.setTempClassLoader(new ContextTypeMatchClassLoader(beanFactory.getBeanClassLoader()));
	}

	// 注冊和環境相關的 Bean,如 environment、systemProperties、systemEnvironment
	if (!beanFactory.containsLocalBean(ENVIRONMENT_BEAN_NAME)) {
		beanFactory.registerSingleton(ENVIRONMENT_BEAN_NAME, getEnvironment());
	}
	if (!beanFactory.containsLocalBean(SYSTEM_PROPERTIES_BEAN_NAME)) {
		beanFactory.registerSingleton(SYSTEM_PROPERTIES_BEAN_NAME, getEnvironment().getSystemProperties());
	}
	if (!beanFactory.containsLocalBean(SYSTEM_ENVIRONMENT_BEAN_NAME)) {
		beanFactory.registerSingleton(SYSTEM_ENVIRONMENT_BEAN_NAME, getEnvironment().getSystemEnvironment());
	}
}

在 prepareBeanFactory 方法中,主要對 BeanFactory 添加了一系列屬性項,如添加忽略自動注入的接口、添加 BeanPostProcessor 后置處理器、手動注冊部分特殊的 Bean及環境相關的 Bean 。

第四步:postProcessBeanFactory

postProcessBeanFactory 方法是上下文准備的最后一步,主要用來注冊 Web 請求相關的處理器、Bean及配置。

public void refresh() throws BeansException, IllegalStateException {
    synchronized (this.startupShutdownMonitor) {
        
        ...
        
        postProcessBeanFactory(beanFactory);
        ...   
    }
}

該方法也是由子類進行擴展,實現該方法的子類有:

image
前面也說過,當前是 Servlet Web 應用,所以創建的 ApplicationContext 上下文是 AnnotationConfigServletWebServerApplicationContext,執行該類的 postProcessBeanFactory 方法。

public class AnnotationConfigServletWebServerApplicationContext
		extends ServletWebServerApplicationContext implements AnnotationConfigRegistry {

    private final AnnotatedBeanDefinitionReader reader;

	private final ClassPathBeanDefinitionScanner scanner;

	private final Set<Class<?>> annotatedClasses = new LinkedHashSet<>();

	private String[] basePackages;
    
    ...
    
	@Override
	protected void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) {
		// 先執行父類 ServletWebServerApplicationContext 的 postProcessBeanFactory 方法。
		// 跳轉到 1 查看父類實現
		super.postProcessBeanFactory(beanFactory);
		
		// basePackages 存儲的是類路徑。先判斷是否為 null,不為 null 則通過 ClassPathBeanDefinitionScanner 的 scan 方法
		// 掃描該路徑下符合條件的 Class,並將 Class 信息包裝成 BeanDefinition 注冊到容器中,
		// 當然,這里沒有指定掃描路徑,所以不會進入這個 if。
		// (BeanDefinition 概念會在后面章節詳細討論)
		if (this.basePackages != null && this.basePackages.length > 0) {
			this.scanner.scan(this.basePackages);
		}
		
		// annotatedClasses 存儲的 Class 集合。先判斷該集合是否為空,不為空則通過
		// AnnotatedBeanDefinitionReader 的 register 方法將 Class 信息包裝成 BeanDefinition 注冊到容器中,
		// 這里同樣沒有設置 Class 集合內容,所以不會進入這個 if。
		if (!this.annotatedClasses.isEmpty()) {
			this.reader.register(ClassUtils.toClassArray(this.annotatedClasses));
		}
	}	    
}

1、
public class ServletWebServerApplicationContext extends GenericWebApplicationContext
		implements ConfigurableWebServerApplicationContext {
    ...

    @Override
	protected void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) {
		// 添加 BeanPostProcessor 后置處理器:WebApplicationContextServletContextAwareProcessor,
		// 該后置處理器主要是從 ConfigurableWebApplicationContext 上下文中獲取 ServletContext 和 ServletConfig 對象
		beanFactory.addBeanPostProcessor(new WebApplicationContextServletContextAwareProcessor(this));
		
		// 添加一個 忽略自動注入的接口
		beanFactory.ignoreDependencyInterface(ServletContextAware.class);
	}
    ...		    
}

postProcessBeanFactory 方法執行的操作和前面類似,也是添加了后置處理器和忽略自動注入的接口。

總結

ApplicationContext 上下文准備工作基本結束,主要還是在 BeanFactory 中添加一系列后置處理器、注冊特殊的 Bean 及設置忽略自動注入的接口。其中還提到了 Spring 容器的三個核心部分:Aware 系列接口、BeanPostProcessor 后置處理器、BeanDefinition ,這部分在后面的文章會逐步討論。接下來將對 Spring 容器的核心功能展開討論。




以上就是本章內容,如果文章中有錯誤或者需要補充的請及時提出,本人感激不盡。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM