再看Spring源码——关于ApplicationContext，更新部分中文注释以及思维导图

Author: MrSorrow

mindPics/SpringIOC—ApplicationContext.emmx

@@ -44,14 +44,14 @@ public interface ConfigurableListableBeanFactory
 		extends ListableBeanFactory, AutowireCapableBeanFactory, ConfigurableBeanFactory {
 
 	/**
-	 * Ignore the given dependency type for autowiring:
+	 * 自动装配时忽略指定的类型:
 	 * for example, String. Default is none.
 	 * @param type the dependency type to ignore
 	 */
 	void ignoreDependencyType(Class<?> type);
 
 	/**
-	 * Ignore the given dependency interface for autowiring.
+	 * 自动装配时忽略指定的接口（http://yangbolin.cn/2016/11/12/spring-work-01/ https://www.jianshu.com/p/3c7e0608ff1f）
 	 * <p>This will typically be used by application contexts to register
 	 * dependencies that are resolved in other ways, like BeanFactory through
 	 * BeanFactoryAware or ApplicationContext through ApplicationContextAware.

mindPics/SpringIOC—ApplicationContext.svg

@@ -1622,6 +1622,7 @@ protected PropertyDescriptor[] filterPropertyDescriptorsForDependencyCheck(BeanW
 	}
 
 	/**
+	 * 确定是否从依赖性检查中排除给定的bean属性。
 	 * Determine whether the given bean property is excluded from dependency checks.
 	 * <p>This implementation excludes properties defined by CGLIB and
 	 * properties whose type matches an ignored dependency type or which

mindPics/SpringIOC—XmlBeanFactory.emmx

@@ -111,19 +111,21 @@ public static boolean isExcludedFromDependencyCheck(PropertyDescriptor pd) {
 	}
 
 	/**
-	 * Return whether the setter method of the given bean property is defined
-	 * in any of the given interfaces.
+	 * 返回是否在给定的接口之一中定义给定了bean属性的setter方法
+	 * Return whether the setter method of the given bean property is defined in any of the given interfaces.
 	 * @param pd the PropertyDescriptor of the bean property
 	 * @param interfaces the Set of interfaces (Class objects)
 	 * @return whether the setter method is defined by an interface
 	 */
 	public static boolean isSetterDefinedInInterface(PropertyDescriptor pd, Set<Class<?>> interfaces) {
+		// 获取bean中某个属性对象在bean类中的setter方法
 		Method setter = pd.getWriteMethod();
 		if (setter != null) {
+			// 获取bean的类型
 			Class<?> targetClass = setter.getDeclaringClass();
 			for (Class<?> ifc : interfaces) {
-				if (ifc.isAssignableFrom(targetClass) &&
-						ClassUtils.hasMethod(ifc, setter.getName(), setter.getParameterTypes())) {
+				if (ifc.isAssignableFrom(targetClass) &&  // bean类型是否是接口的实现类
+						ClassUtils.hasMethod(ifc, setter.getName(), setter.getParameterTypes())) {  // 接口是否有入参和bean类型完全相同的setter方法
 					return true;
 				}
 			}

mindPics/SpringIOC—XmlBeanFactory.svg

@@ -781,6 +781,7 @@ public void preInstantiateSingletons() throws BeansException {
 		// Trigger post-initialization callback for all applicable beans...
 		for (String beanName : beanNames) {
 			Object singletonInstance = getSingleton(beanName);
+			// 如果实例化的bean是SmartInitializingSingleton类型的，在getBean结束后还需要执行bean的afterSingletonsInstantiated方法
 			if (singletonInstance instanceof SmartInitializingSingleton) {
 				final SmartInitializingSingleton smartSingleton = (SmartInitializingSingleton) singletonInstance;
 				if (System.getSecurityManager() != null) {

mindPics/解析自定义标签.emmx

@@ -128,13 +128,14 @@ public void multicastEvent(ApplicationEvent event) {
 	}
 
 	/**
-	 * 当Spring产生事件时，会默认使用该方法来广播事件，调用监听器的onApplicationEvent方法
+	 * 当Spring产生事件时，会默认使用该方法向所有的监听器进行广播事件（调用监听器的onApplicationEvent方法）
 	 * @param event the event to multicast
 	 * @param eventType the type of event (can be null)
 	 */
 	@Override
 	public void multicastEvent(final ApplicationEvent event, @Nullable ResolvableType eventType) {
 		ResolvableType type = (eventType != null ? eventType : resolveDefaultEventType(event));
+		// 遍历通知所有的监听器
 		for (final ApplicationListener<?> listener : getApplicationListeners(event, type)) {
 			Executor executor = getTaskExecutor();
 			if (executor != null) {

spring-beans/src/main/java/org/springframework/beans/factory/config/ConfigurableListableBeanFactory.java

@@ -522,7 +522,7 @@ public void refresh() throws BeansException, IllegalStateException {
 			prepareRefresh();
 
 			// Tell the subclass to refresh the internal bean factory.
-			// 初始化BeanFactory，并进行XML文件读取
+			// 初始化BeanFactory，并进行XML文件读取配置，此时已经转化为beanDefinition
 			ConfigurableListableBeanFactory beanFactory = obtainFreshBeanFactory();
 
 			// Prepare the bean factory for use in this context.
@@ -543,7 +543,7 @@ public void refresh() throws BeansException, IllegalStateException {
 				registerBeanPostProcessors(beanFactory);
 
 				// Initialize message source for this context.
-				// 为上下文初始化Message消息资源，即不同语言的消息体，国际化处理
+				// 为Context初始化Message消息资源，即不同语言的消息体，国际化处理
 				initMessageSource();
 
 				// Initialize event multicaster for this context.
@@ -597,7 +597,7 @@ public void refresh() throws BeansException, IllegalStateException {
 	 * active flag as well as performing any initialization of property sources.
 	 */
 	protected void prepareRefresh() {
-		this.startupDate = System.currentTimeMillis();
+		this.startupDate = System.currentTimeMillis();  // 容器刷新计时
 		this.closed.set(false); // AtomicBoolean类型，并发
 		this.active.set(true); // AtomicBoolean类型，并发
 
@@ -661,7 +661,7 @@ protected void prepareBeanFactory(ConfigurableListableBeanFactory beanFactory) {
 		// 添加BeanPostProcessor，对这些Aware接口信息进行信息注入
 		beanFactory.addBeanPostProcessor(new ApplicationContextAwareProcessor(this));
 
-		// 设置几个忽略自动装配的接口
+		// 上一步实现Aware接口的bean由于其特殊性，所以在自动装配时需要忽略来手动注入  https://www.jianshu.com/p/3c7e0608ff1f
 		beanFactory.ignoreDependencyInterface(EnvironmentAware.class);
 		beanFactory.ignoreDependencyInterface(EmbeddedValueResolverAware.class);
 		beanFactory.ignoreDependencyInterface(ResourceLoaderAware.class);
@@ -678,7 +678,7 @@ protected void prepareBeanFactory(ConfigurableListableBeanFactory beanFactory) {
 		beanFactory.registerResolvableDependency(ApplicationContext.class, this);
 
 		// Register early post-processor for detecting inner beans as ApplicationListeners.
-		// 添加BeanPostProcessor实现：ApplicationListenerDetector，它是用来将实现了ApplicationListener接口的Bean添加到容器的监听器列表
+		// 添加BeanPostProcessor实现：ApplicationListenerDetector，它是用来将 实现了ApplicationListener接口的Bean 添加到容器的监听器列表
 		beanFactory.addBeanPostProcessor(new ApplicationListenerDetector(this));
 
 		// Detect a LoadTimeWeaver and prepare for weaving, if found.
@@ -720,7 +720,7 @@ protected void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactor
 	protected void invokeBeanFactoryPostProcessors(ConfigurableListableBeanFactory beanFactory) {
 		PostProcessorRegistrationDelegate.invokeBeanFactoryPostProcessors(beanFactory, getBeanFactoryPostProcessors());
 
-		// Detect a LoadTimeWeaver and prepare for weaving, if found in the meantime
+		// 如果beanFactory中定义了loadTimeWeaver的bean，则检测LoadTimeWeaver并准备织入
 		// (e.g. through an @Bean method registered by ConfigurationClassPostProcessor)
 		if (beanFactory.getTempClassLoader() == null && beanFactory.containsBean(LOAD_TIME_WEAVER_BEAN_NAME)) {
 			beanFactory.addBeanPostProcessor(new LoadTimeWeaverAwareProcessor(beanFactory));
@@ -747,7 +747,7 @@ protected void initMessageSource() {
 		ConfigurableListableBeanFactory beanFactory = getBeanFactory();
 		// 如果配置文件中定义了messageSource这个bean，那么将其提取并记录在ApplicationContext(this.messageSource)中
 		if (beanFactory.containsLocalBean(MESSAGE_SOURCE_BEAN_NAME)) {
-			// 获取名为messageSource这个bean
+			// 实例化名为messageSource这个bean
 			this.messageSource = beanFactory.getBean(MESSAGE_SOURCE_BEAN_NAME, MessageSource.class);
 			// Make MessageSource aware of parent MessageSource.
 			if (this.parent != null && this.messageSource instanceof HierarchicalMessageSource) {
@@ -1293,8 +1293,8 @@ public boolean containsLocalBean(String name) {
 	}
 
 	/**
-	 * Return the internal bean factory of the parent context if it implements
-	 * ConfigurableApplicationContext; else, return the parent context itself.
+	 * 如果父Context实现了ConfigurableApplicationContext，则返回父Context的内部beanFactory;
+	 * 否则，直接返回父Context本身
 	 * @see org.springframework.context.ConfigurableApplicationContext#getBeanFactory
 	 */
 	@Nullable

spring-beans/src/main/java/org/springframework/beans/factory/support/AbstractAutowireCapableBeanFactory.java

@@ -68,6 +68,7 @@ public Object postProcessBeforeInitialization(Object bean, String beanName) {
 
 	@Override
 	public Object postProcessAfterInitialization(Object bean, String beanName) {
+		// 在返回bean之前检测是否是ApplicationListener类型，如果是会添加到容器的监听器列表
 		if (bean instanceof ApplicationListener) {
 			// potentially not detected as a listener by getBeanNamesForType retrieval
 			Boolean flag = this.singletonNames.get(beanName);

spring-beans/src/main/java/org/springframework/beans/factory/support/AutowireUtils.java

@@ -154,7 +154,7 @@ private void startBeans(boolean autoStartupOnly) {
 			List<Integer> keys = new ArrayList<>(phases.keySet());
 			Collections.sort(keys);
 			for (Integer key : keys) {
-				phases.get(key).start();
+				phases.get(key).start();  // 遍历调用start()方法
 			}
 		}
 	}

spring-beans/src/main/java/org/springframework/beans/factory/support/DefaultListableBeanFactory.java

@@ -55,7 +55,7 @@ private PostProcessorRegistrationDelegate() {
 	/**
 	 * 调用BeanFactoryPostProcessors后处理方法
 	 * @param beanFactory
-	 * @param beanFactoryPostProcessors
+	 * @param beanFactoryPostProcessors 所有硬编码的beanFactoryPostProcessors
 	 */
 	public static void invokeBeanFactoryPostProcessors(
 			ConfigurableListableBeanFactory beanFactory, List<BeanFactoryPostProcessor> beanFactoryPostProcessors) {
@@ -76,7 +76,7 @@ public static void invokeBeanFactoryPostProcessors(
 
 		// Invoke BeanDefinitionRegistryPostProcessors first, if any.
 
-		// 记录已经处理的bean的hashset
+		// 记录已经处理的bean的HashSet
 		Set<String> processedBeans = new HashSet<>();
 
 		// 对BeanDefinitionRegistry类型的beanFactory处理
@@ -121,7 +121,7 @@ public static void invokeBeanFactoryPostProcessors(
 			String[] postProcessorNames =
 					beanFactory.getBeanNamesForType(BeanDefinitionRegistryPostProcessor.class, true, false);
 			for (String ppName : postProcessorNames) {
-				if (beanFactory.isTypeMatch(ppName, PriorityOrdered.class)) {
+				if (beanFactory.isTypeMatch(ppName, PriorityOrdered.class)) {  // 先处理那些有顺序的BeanDefinitionRegistryPostProcessors
 					currentRegistryProcessors.add(beanFactory.getBean(ppName, BeanDefinitionRegistryPostProcessor.class));
 					processedBeans.add(ppName);
 				}
@@ -151,7 +151,7 @@ public static void invokeBeanFactoryPostProcessors(
 				reiterate = false;
 				postProcessorNames = beanFactory.getBeanNamesForType(BeanDefinitionRegistryPostProcessor.class, true, false);
 				for (String ppName : postProcessorNames) {
-					// 处理剩下的
+					// 处理配置文件中剩下的没有顺序的BeanDefinitionRegistryPostProcessors
 					if (!processedBeans.contains(ppName)) {
 						currentRegistryProcessors.add(beanFactory.getBean(ppName, BeanDefinitionRegistryPostProcessor.class));
 						processedBeans.add(ppName);
@@ -170,9 +170,9 @@ public static void invokeBeanFactoryPostProcessors(
 
 			// Now, invoke the postProcessBeanFactory callback of all processors handled so far.
 			// 激活postProcessBeanFactory方法，之前激活的是postProcessBeanDefinitionRegistry
-			// 激活硬编码设置的BeanDefinitionRegistryPostProcessor的postProcessBeanFactory
+			// 激活硬编码和配置文件中所有BeanDefinitionRegistryPostProcessor的postProcessBeanFactory方法
 			invokeBeanFactoryPostProcessors(registryProcessors, beanFactory);
-			// 激活常规的BeanFactoryPostProcessor的postProcessBeanFactory
+			// 激活硬编码常规的BeanFactoryPostProcessor的postProcessBeanFactory
 			invokeBeanFactoryPostProcessors(regularPostProcessors, beanFactory);
 
 			// ==============1.1.3结束之处==============
@@ -186,7 +186,7 @@ public static void invokeBeanFactoryPostProcessors(
 
 		// Do not initialize FactoryBeans here: We need to leave all regular beans
 		// uninitialized to let the bean factory post-processors apply to them!
-		// 对于配置中读取的BeanFactoryPostProcessor的处理
+		// 对于配置文件中读取的BeanFactoryPostProcessor的处理
 		String[] postProcessorNames =
 				beanFactory.getBeanNamesForType(BeanFactoryPostProcessor.class, true, false);
 
@@ -247,15 +247,15 @@ else if (beanFactory.isTypeMatch(ppName, Ordered.class)) {
 	 */
 	public static void registerBeanPostProcessors(
 			ConfigurableListableBeanFactory beanFactory, AbstractApplicationContext applicationContext) {
-
+		// 获取配置文件中所有BeanPostProcessor.class类型的beanName
 		String[] postProcessorNames = beanFactory.getBeanNamesForType(BeanPostProcessor.class, true, false);
 
 		// Register BeanPostProcessorChecker that logs an info message when
 		// a bean is created during BeanPostProcessor instantiation, i.e. when
 		// a bean is not eligible for getting processed by all BeanPostProcessors.
 		// BeanPostProcessorChecker是一个普通的信息打印，可能会有些情况，当Spring的配置中的后处理器还没有被注册就已经开始了bean的初始化时
 		// 便打印出BeanPostProcessorChecker中设定的信息
-		// 1就是指下面要加的BeanPostProcessorChecker
+		// 获得硬编码与配置文件中的所有BeanPostProcessors，1就是指下面要加的BeanPostProcessorChecker
 		int beanProcessorTargetCount = beanFactory.getBeanPostProcessorCount() + 1 + postProcessorNames.length;
 		beanFactory.addBeanPostProcessor(new BeanPostProcessorChecker(beanFactory, beanProcessorTargetCount));
 
@@ -271,7 +271,7 @@ public static void registerBeanPostProcessors(
 
 		for (String ppName : postProcessorNames) {
 			if (beanFactory.isTypeMatch(ppName, PriorityOrdered.class)) {
-				BeanPostProcessor pp = beanFactory.getBean(ppName, BeanPostProcessor.class);
+				BeanPostProcessor pp = beanFactory.getBean(ppName, BeanPostProcessor.class);  // 实例化BeanPostProcessor
 				priorityOrderedPostProcessors.add(pp);
 				if (pp instanceof MergedBeanDefinitionPostProcessor) {
 					internalPostProcessors.add(pp);
@@ -286,15 +286,15 @@ else if (beanFactory.isTypeMatch(ppName, Ordered.class)) {
 		}
 
 		// First, register the BeanPostProcessors that implement PriorityOrdered.
-		// 第一步，注册所有实现PriorityOrdered的BeanPostProcessor
+		// 第一步，注册配置文件中所有实现PriorityOrdered的BeanPostProcessor
 		sortPostProcessors(priorityOrderedPostProcessors, beanFactory);
 		registerBeanPostProcessors(beanFactory, priorityOrderedPostProcessors);
 
 		// Next, register the BeanPostProcessors that implement Ordered.
-		// 第二步，注册所有实现Ordered的BeanPostProcessor
+		// 第二步，注册配置文件中所有实现Ordered的BeanPostProcessor
 		List<BeanPostProcessor> orderedPostProcessors = new ArrayList<>();
 		for (String ppName : orderedPostProcessorNames) {
-			BeanPostProcessor pp = beanFactory.getBean(ppName, BeanPostProcessor.class);
+			BeanPostProcessor pp = beanFactory.getBean(ppName, BeanPostProcessor.class);  // 实例化
 			orderedPostProcessors.add(pp);
 			if (pp instanceof MergedBeanDefinitionPostProcessor) {
 				internalPostProcessors.add(pp);
@@ -304,7 +304,7 @@ else if (beanFactory.isTypeMatch(ppName, Ordered.class)) {
 		registerBeanPostProcessors(beanFactory, orderedPostProcessors);
 
 		// Now, register all regular BeanPostProcessors.
-		// 第三步，注册所有无序的BeanPostProcessor
+		// 第三步，注册配置文件中所有无序的BeanPostProcessor
 		List<BeanPostProcessor> nonOrderedPostProcessors = new ArrayList<>();
 		for (String ppName : nonOrderedPostProcessorNames) {
 			BeanPostProcessor pp = beanFactory.getBean(ppName, BeanPostProcessor.class);
@@ -316,13 +316,13 @@ else if (beanFactory.isTypeMatch(ppName, Ordered.class)) {
 		registerBeanPostProcessors(beanFactory, nonOrderedPostProcessors);
 
 		// Finally, re-register all internal BeanPostProcessors.
-		// 第四步，注册所有MergedBeanDefinitionPostProcessor类型的BeanPostProcessor，并非重复注册，在beanFactory中会先移除已经存在的BeanPostProcessor
+		// 第四步，注册配置文件中所有MergedBeanDefinitionPostProcessor类型的BeanPostProcessor，并非重复注册，在beanFactory中会先移除已经存在的BeanPostProcessor
 		sortPostProcessors(internalPostProcessors, beanFactory);
 		registerBeanPostProcessors(beanFactory, internalPostProcessors);
 
 		// Re-register post-processor for detecting inner beans as ApplicationListeners,
 		// moving it to the end of the processor chain (for picking up proxies etc).
-		// 最后添加了ApplicationListener探测器的后处理器
+		// 最后添加了ApplicationListener探测器的后处理器，之前已经添加过一次，再次添加会移到arrayList的末尾
 		beanFactory.addBeanPostProcessor(new ApplicationListenerDetector(applicationContext));
 	}
 

spring-context/src/main/java/org/springframework/context/event/SimpleApplicationEventMulticaster.java

@@ -142,7 +142,7 @@ public void setRequiredProperties(String... requiredProperties) {
 	}
 
 	/**
-	 * 对属性进行验证
+	 * 对requiredProperties属性进行验证
 	 */
 	@Override
 	public void validateRequiredProperties() {

spring-context/src/main/java/org/springframework/context/support/AbstractApplicationContext.java

@@ -18,8 +18,8 @@ public class CustomTagTest {
 
 	@Test
 	public void testCustomTag() {
-		XmlBeanFactory context = new XmlBeanFactory(new ClassPathResource("customTag-Test.xml"));
-//		ApplicationContext context = new ClassPathXmlApplicationContext("${config}");
+//		XmlBeanFactory context = new XmlBeanFactory(new ClassPathResource("customTag-Test.xml"));
+		ApplicationContext context = new ClassPathXmlApplicationContext("${config}");
 		User user = (User) context.getBean("testUserBean");
 		Order order = (Order) context.getBean("testOrderBean");
 		System.out.println(user);

spring-context/src/main/java/org/springframework/context/support/ApplicationListenerDetector.java

@@ -20,10 +20,10 @@ public class MyBeanFactoryPostProcessorTest {
 
 	@Test
 	public void testMyBeanFactoryPostProcessor() {
-		ConfigurableListableBeanFactory bf = new XmlBeanFactory(new ClassPathResource("selfBeanFactoryPostProcessor-Test.xml"));
-		BeanFactoryPostProcessor bfpp = (BeanFactoryPostProcessor) bf.getBean("myBeanFactoryPostProcessor");
-//		ApplicationContext bf = new ClassPathXmlApplicationContext("selfBeanFactoryPostProcessor-Test.xml");
-		bfpp.postProcessBeanFactory(bf);
+//		ConfigurableListableBeanFactory bf = new XmlBeanFactory(new ClassPathResource("selfBeanFactoryPostProcessor-Test.xml"));
+//		BeanFactoryPostProcessor bfpp = (BeanFactoryPostProcessor) bf.getBean("myBeanFactoryPostProcessor");
+		ApplicationContext bf = new ClassPathXmlApplicationContext("selfBeanFactoryPostProcessor-Test.xml");
+//		bfpp.postProcessBeanFactory(bf);
 		User user = (User) bf.getBean("user");
 		System.out.println(user);
 	}