@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnClassCondition.class)
public @interface ConditionalOnClass {
    // The classes that must be present.
	Class<?>[] value() default {};
    // The classes names that must be present.
	String[] name() default {};

}

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Conditional {

   /**
    * All {@link Condition} classes that must {@linkplain Condition#matches match}
    * in order for the component to be registered.
    */
   Class<? extends Condition>[] value();

}

@FunctionalInterface
public interface Condition {
    /**
     * 決定條件是否通過(guò)
     * @param context - 條件上下文
     * @param metadata - 元數(shù)據(jù)，里面標(biāo)注該注解的類(lèi)或方法
     * @return true-通過(guò)，false-不通過(guò)
     **/
   boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata);
}

public abstract class SpringBootCondition implements Condition {
	private final Log logger = LogFactory.getLog(getClass());
    /**
     * matches()方法的實(shí)現(xiàn)————決定條件是否通過(guò)
     * @param context - 條件上下文
     * @param metadata - 元數(shù)據(jù)，里面標(biāo)注該注解的類(lèi)或方法
     * @return true-通過(guò)，false-不通過(guò)
     **/
	@Override
	public final boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        // 獲取方法名或類(lèi)名
		String classOrMethodName = getClassOrMethodName(metadata);
		try {
            // 對(duì)元數(shù)據(jù)進(jìn)行判斷，看是否符合要求。
            // ConditionOutcome中封裝了判斷的結(jié)果和相應(yīng)的結(jié)果信息，
			ConditionOutcome outcome = getMatchOutcome(context, metadata);
            // 日志，
			logOutcome(classOrMethodName, outcome);
            // 記錄
			recordEvaluation(context, classOrMethodName, outcome);
            // 如果isMatch()的值為true，則表示條件通過(guò)
			return outcome.isMatch();
		}
		catch (NoClassDefFoundError ex) {
			// 拋出IllegalStateException異常
		}
		catch (RuntimeException ex) {
			// 拋出IllegalStateException異常
		}
	}
    public abstract ConditionOutcome getMatchOutcome(ConditionContext context, AnnotatedTypeMetadata metadata);
}

class OnClassCondition extends FilteringSpringBootCondition {
    // 該方法分三部分
    // 1. 處理ConditionalOnClass注解
    // 2. 處理ConditionalOnMissingClass注解
    // 3. 返回條件判斷的結(jié)果
    @Override
	public ConditionOutcome getMatchOutcome(ConditionContext context, AnnotatedTypeMetadata metadata) {
		ClassLoader classLoader = context.getClassLoader();
        // 通過(guò)靜態(tài)方法，創(chuàng)建一個(gè)ConditionMessage實(shí)例，用來(lái)保存條件判斷結(jié)果對(duì)應(yīng)的信息
		ConditionMessage matchMessage = ConditionMessage.empty();
        // 1. 處理ConditionalOnClass注解
        // 獲取該元數(shù)據(jù)表示的類(lèi)或方法上的ConditionalOnClass注解中標(biāo)注的類(lèi)的限定名，
        // 表示這些類(lèi)應(yīng)當(dāng)在classpath類(lèi)路徑中存在，所以叫onClass
        // 例如：@ConditionalOnClass({ RabbitTemplate.class, Channel.class })，
        //      則返回RabbitTemplate和Channel的全限定類(lèi)名
		List<String> onClasses = getCandidates(metadata, ConditionalOnClass.class);
		if (onClasses != null) {
            // filter()方法內(nèi)部 對(duì)onClass表示的類(lèi)進(jìn)行反射，條件為MISSING，
            // 如果得到的集合不為空，則說(shuō)明類(lèi)路徑中不存在ConditionalOnClass注解中標(biāo)注的類(lèi)
            // 這種情況下直接通過(guò)ConditionOutcome.noMatch()封裝ConditionOutcome條件判斷的結(jié)果并返回，noMatch()即表示不通過(guò)。
			List<String> missing = filter(onClasses, ClassNameFilter.MISSING, classLoader);
			if (!missing.isEmpty()) {
				return ConditionOutcome.noMatch(ConditionMessage.forCondition(ConditionalOnClass.class)
						.didNotFind("required class", "required classes").items(Style.QUOTE, missing));
			}
            // 對(duì)ConditionalOnClass注解的條件判斷通過(guò)，并保存對(duì)應(yīng)的信息到matchMessage
			matchMessage = matchMessage.andCondition(ConditionalOnClass.class)
					.found("required class", "required classes")
					.items(Style.QUOTE, filter(onClasses, ClassNameFilter.PRESENT, classLoader));
		}
        // 2. 處理ConditionalOnMissingClass注解
        // 獲取該元數(shù)據(jù)表示的類(lèi)或方法上的ConditionalOnMissingClass注解中標(biāo)注的類(lèi)的限定名，
        // 表示這些類(lèi)應(yīng)當(dāng)在classpath類(lèi)路徑中不存在，所以叫onMissingClass
        // 例如：@ConditionalOnMissingClass({ RabbitTemplate.class, Channel.class })，
        //      則返回RabbitTemplate和Channel的全限定類(lèi)名
		List<String> onMissingClasses = getCandidates(metadata, ConditionalOnMissingClass.class);
		if (onMissingClasses != null) {
            // filter()方法內(nèi)部 對(duì)onMissingClasses表示的類(lèi)進(jìn)行反射，條件為PRESENT，
            // 如果得到的集合不為空，則說(shuō)明類(lèi)路徑中存在ConditionalOnMissingClass注解中標(biāo)注的類(lèi)
            // 這種情況下直接通過(guò)ConditionOutcome.noMatch()封裝ConditionOutcome條件判斷的結(jié)果并返回，noMatch()即表示不通過(guò)。
			List<String> present = filter(onMissingClasses, ClassNameFilter.PRESENT, classLoader);
			if (!present.isEmpty()) {
				return ConditionOutcome.noMatch(ConditionMessage.forCondition(ConditionalOnMissingClass.class)
						.found("unwanted class", "unwanted classes").items(Style.QUOTE, present));
			}
            // 對(duì)ConditionalOnMissingClass注解的條件判斷通過(guò)，并保存對(duì)應(yīng)的信息到matchMessage
			matchMessage = matchMessage.andCondition(ConditionalOnMissingClass.class)
					.didNotFind("unwanted class", "unwanted classes")
					.items(Style.QUOTE, filter(onMissingClasses, ClassNameFilter.MISSING, classLoader));
		}
        // 3. 返回條件判斷的結(jié)果，到這一步，就說(shuō)明ConditionalOnClass注解和ConditionalOnMissingClass注解上的條件都已經(jīng)通過(guò)了。
		return ConditionOutcome.match(matchMessage);
	}
}