package org.springframework.context.event;
//... 省略 import
/**
 * Registers {@link EventListener} methods as individual {@link ApplicationListener} instances.
 * Implements {@link BeanFactoryPostProcessor} (as of 5.1) primarily for early retrieval,
 * avoiding AOP checks for this processor bean and its {@link EventListenerFactory} delegates.
 *
 * @author Stephane Nicoll
 * @author Juergen Hoeller
 * @since 4.2
 * @see EventListenerFactory
 * @see DefaultEventListenerFactory
 */
public class EventListenerMethodProcessor
		implements SmartInitializingSingleton, ApplicationContextAware, BeanFactoryPostProcessor {
	protected final Log logger = LogFactory.getLog(getClass());
    // 用于記錄檢測(cè)發(fā)現(xiàn)`@EventListener`注解方法，生成和注冊(cè)`ApplicationListener`實(shí)例的應(yīng)用上下文
	@Nullable
	private ConfigurableApplicationContext applicationContext;
   // 記錄當(dāng)前 BeanFactory， 實(shí)際上這個(gè)變量可用可不用，因?yàn)橥ㄟ^(guò) applicationContext 也可以找到
   // 當(dāng)前 BeanFactory
	@Nullable
	private ConfigurableListableBeanFactory beanFactory;
   // 記錄從容器中找到的所有 EventListenerFactory
	@Nullable
	private List<EventListenerFactory> eventListenerFactories;
	private final EventExpressionEvaluator evaluator = new EventExpressionEvaluator();
    // 緩存機(jī)制，記住那些根本任何方法上沒(méi)有使用注解 @EventListener 的類，避免處理過(guò)程中二次處理 
	private final Set<Class<?>> nonAnnotatedClasses = Collections.newSetFromMap(new ConcurrentHashMap<>(64));
	@Override
	public void setApplicationContext(ApplicationContext applicationContext) {
		Assert.isTrue(applicationContext instanceof ConfigurableApplicationContext,
				"ApplicationContext does not implement ConfigurableApplicationContext");
		this.applicationContext = (ConfigurableApplicationContext) applicationContext;
	}
	@Override
	public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) {
		this.beanFactory = beanFactory;
       // 從容器中找到所有的  EventListenerFactory 組件
       // 常見(jiàn)的一些 EventListenerFactory :
       // TransactionalEventListenerFactory --
       // 用于支持使用 @TransactionalEventListener 注解的事件監(jiān)聽(tīng)器, @TransactionalEventListener 是一種特殊的
       // @EventListener，它定義的事件監(jiān)聽(tīng)器應(yīng)用于事務(wù)提交或者回滾的某些特殊時(shí)機(jī)，
       // 由 ProxyTransactionManagementConfiguration 注冊(cè)到容器
       // 注冊(cè)到容器
       // DefaultEventListenerFactory -- 系統(tǒng)缺省, 最低優(yōu)先級(jí)，如果其他 EventListenerFactory 都不支持的時(shí)候使用
		Map<String, EventListenerFactory> beans = beanFactory.getBeansOfType(EventListenerFactory.class, false, false);
		List<EventListenerFactory> factories = new ArrayList<>(beans.values());
		AnnotationAwareOrderComparator.sort(factories);
		this.eventListenerFactories = factories;
	}
	@Override
	public void afterSingletonsInstantiated() {
		ConfigurableListableBeanFactory beanFactory = this.beanFactory;
		Assert.state(this.beanFactory != null, "No ConfigurableListableBeanFactory set");
       // 這里獲取容器中所有bean組件的名稱， 
		String[] beanNames = beanFactory.getBeanNamesForType(Object.class);
		for (String beanName : beanNames) {
          // 遍歷每個(gè)bean組件，檢測(cè)其中`@EventListener`注解方法，生成和注冊(cè)`ApplicationListener`實(shí)例
			if (!ScopedProxyUtils.isScopedTarget(beanName)) {
				Class<?> type = null;
				try {
					type = AutoProxyUtils.determineTargetClass(beanFactory, beanName);
				}
				catch (Throwable ex) {
					// An unresolvable bean type, probably from a lazy bean - let's ignore it.
					if (logger.isDebugEnabled()) {
						logger.debug("Could not resolve target class for bean with name '" + beanName + "'", ex);
					}
				}
				if (type != null) {
					if (ScopedObject.class.isAssignableFrom(type)) {
						try {
							Class<?> targetClass = AutoProxyUtils.determineTargetClass(
									beanFactory, ScopedProxyUtils.getTargetBeanName(beanName));
							if (targetClass != null) {
								type = targetClass;
							}
						}
						catch (Throwable ex) {
							// An invalid scoped proxy arrangement - let's ignore it.
							if (logger.isDebugEnabled()) {
								logger.debug("Could not resolve target bean for scoped proxy '" + beanName + "'", ex);
							}
						}
					}
					try {
                     // 注意這一行，針對(duì)一個(gè)bean的真正的`@EventListener`注解方法檢測(cè)，
                     // `ApplicationListener`實(shí)例生成注冊(cè)發(fā)生在這里
						processBean(beanName, type);
					}
					catch (Throwable ex) {
						throw new BeanInitializationException("Failed to process @EventListener " +
								"annotation on bean with name '" + beanName + "'", ex);
					}
				}
			}
		}
	}
   // 該方法拿到某個(gè)bean的名稱和它的目標(biāo)類，在這個(gè)范圍上檢測(cè)`@EventListener`注解方法，
   // 生成和注冊(cè)`ApplicationListener`實(shí)例
	private void processBean(final String beanName, final Class<?> targetType) {
		if (!this.nonAnnotatedClasses.contains(targetType) &&
				AnnotationUtils.isCandidateClass(targetType, EventListener.class) &&
				!isSpringContainerClass(targetType)) {
			Map<Method, EventListener> annotatedMethods = null;
			try {
             // *** 注意這里, 這里檢測(cè)當(dāng)前類targetType上使用了注解 @EventListener 的方法
				annotatedMethods = MethodIntrospector.selectMethods(targetType,
						(MethodIntrospector.MetadataLookup<EventListener>) method ->
								AnnotatedElementUtils.findMergedAnnotation(method, EventListener.class));
			}
			catch (Throwable ex) {
				// An unresolvable type in a method signature, probably from a lazy bean - let's ignore it.
				if (logger.isDebugEnabled()) {
					logger.debug("Could not resolve methods for bean with name '" + beanName + "'", ex);
				}
			}
			if (CollectionUtils.isEmpty(annotatedMethods)) {
              // 如果當(dāng)前類 targetType 中沒(méi)有任何使用了 注解 @EventListener 的方法，則將該類保存到
              // 緩存 nonAnnotatedClasses, 從而避免當(dāng)前處理方法重入該類，其目的應(yīng)該是為了提高效率，             
				this.nonAnnotatedClasses.add(targetType);
				if (logger.isTraceEnabled()) {
					logger.trace("No @EventListener annotations found on bean class: " + targetType.getName());
				}
			}
			else {
              // 發(fā)現(xiàn)當(dāng)前類 targetType 中有些方法使用了注解 @EventListener,現(xiàn)在根據(jù)這些方法上的信息
              // 對(duì)應(yīng)地創(chuàng)建和注冊(cè)ApplicationListener實(shí)例
				// Non-empty set of methods
				ConfigurableApplicationContext context = this.applicationContext;
				Assert.state(context != null, "No ApplicationContext set");
              // 注意，這里使用到了  this.eventListenerFactories, 這些 EventListenerFactory 是在 
              // 該類 postProcessBeanFactory 方法調(diào)用時(shí)被記錄的
				List<EventListenerFactory> factories = this.eventListenerFactories;
				Assert.state(factories != null, "EventListenerFactory List not initialized");
				for (Method method : annotatedMethods.keySet()) {
					for (EventListenerFactory factory : factories) {
						if (factory.supportsMethod(method)) {
                        // 如果當(dāng)前 EventListenerFactory factory 支持處理該 @EventListener 注解的方法,
                        // 則使用它創(chuàng)建 ApplicationListener
							Method methodToUse = AopUtils.selectInvocableMethod(method, context.getType(beanName));
							ApplicationListener<?> applicationListener =
									factory.createApplicationListener(beanName, targetType, methodToUse);
							if (applicationListener instanceof ApplicationListenerMethodAdapter) {
								((ApplicationListenerMethodAdapter) applicationListener).init(context, this.evaluator);
							}
                        // 將所生成的  ApplicationListener 實(shí)例注冊(cè)到容器   
							context.addApplicationListener(applicationListener);
							break;
						}
					}
				}
				if (logger.isDebugEnabled()) {
					logger.debug(annotatedMethods.size() + " @EventListener methods processed on bean '" +
							beanName + "': " + annotatedMethods);
				}
			}
		}
	}
	/**
	 * Determine whether the given class is an {@code org.springframework}
	 * bean class that is not annotated as a user or test {@link Component}...
	 * which indicates that there is no {@link EventListener} to be found there.
	 * @since 5.1
	 */
	private static boolean isSpringContainerClass(Class<?> clazz) {
		return (clazz.getName().startsWith("org.springframework.") &&
				!AnnotatedElementUtils.isAnnotated(ClassUtils.getUserClass(clazz), Component.class));
	}
}