// SpringApplication類(lèi)方法
public ConfigurableApplicationContext run(String... args) {
    // 記錄應(yīng)用啟動(dòng)的開(kāi)始時(shí)間
    long startTime = System.nanoTime();

    // 1.創(chuàng)建引導(dǎo)上下文，用于管理應(yīng)用啟動(dòng)時(shí)的依賴(lài)和資源
    DefaultBootstrapContext bootstrapContext = createBootstrapContext();
    ConfigurableApplicationContext context = null;

    // 配置無(wú)頭模式屬性，以支持在無(wú)圖形環(huán)境下運(yùn)行
    // 將系統(tǒng)屬性 java.awt.headless 設(shè)置為 true
    configureHeadlessProperty();

    // 2.獲取Spring應(yīng)用啟動(dòng)監(jiān)聽(tīng)器，用于在應(yīng)用啟動(dòng)的各個(gè)階段執(zhí)行自定義邏輯
    SpringApplicationRunListeners listeners = getRunListeners(args);
    // 啟動(dòng)開(kāi)始方法（發(fā)布開(kāi)始事件、通知應(yīng)用監(jiān)聽(tīng)器ApplicationListener）
    listeners.starting(bootstrapContext, this.mainApplicationClass);

    try {
        // 3.解析應(yīng)用參數(shù)
        ApplicationArguments applicationArguments = new DefaultApplicationArguments(args);

        // 4.準(zhǔn)備應(yīng)用環(huán)境，包括讀取配置文件和設(shè)置環(huán)境變量
        ConfigurableEnvironment environment = prepareEnvironment(listeners, bootstrapContext, applicationArguments);

        // 配置是否忽略 BeanInfo，以加快啟動(dòng)速度
        configureIgnoreBeanInfo(environment);

        // 5.打印啟動(dòng)Banner
        Banner printedBanner = printBanner(environment);

        // 6.創(chuàng)建應(yīng)用程序上下文
        context = createApplicationContext();
        
        // 設(shè)置應(yīng)用啟動(dòng)的上下文，用于監(jiān)控和管理啟動(dòng)過(guò)程
        context.setApplicationStartup(this.applicationStartup);

        // 7.準(zhǔn)備應(yīng)用上下文，包括加載配置、添加 Bean 等
        prepareContext(bootstrapContext, context, environment, listeners, applicationArguments, printedBanner);

        // 8.刷新上下文，完成 Bean 的加載和依賴(lài)注入
        refreshContext(context);

        // 9.刷新后的一些操作，如事件發(fā)布等
        afterRefresh(context, applicationArguments);

        // 計(jì)算啟動(dòng)應(yīng)用程序的時(shí)間，并記錄日志
        Duration timeTakenToStartup = Duration.ofNanos(System.nanoTime() - startTime);
        if (this.logStartupInfo) {
            new StartupInfoLogger(this.mainApplicationClass).logStarted(getApplicationLog(), timeTakenToStartup);
        }

        // 10.通知監(jiān)聽(tīng)器應(yīng)用啟動(dòng)完成
        listeners.started(context, timeTakenToStartup);

        // 11.調(diào)用應(yīng)用程序中的 `CommandLineRunner` 或 `ApplicationRunner`，以便執(zhí)行自定義的啟動(dòng)邏輯
        callRunners(context, applicationArguments);
    }
    catch (Throwable ex) {
        // 12.處理啟動(dòng)過(guò)程中發(fā)生的異常，并通知監(jiān)聽(tīng)器
        handleRunFailure(context, ex, listeners);
        throw new IllegalStateException(ex);
    }
    try {
        // 13.計(jì)算應(yīng)用啟動(dòng)完成至準(zhǔn)備就緒的時(shí)間，并通知監(jiān)聽(tīng)器
        Duration timeTakenToReady = Duration.ofNanos(System.nanoTime() - startTime);
        listeners.ready(context, timeTakenToReady);
    }
    catch (Throwable ex) {
        // 處理準(zhǔn)備就緒過(guò)程中發(fā)生的異常
        handleRunFailure(context, ex, null);
        throw new IllegalStateException(ex);
    }

    // 返回已啟動(dòng)并準(zhǔn)備就緒的應(yīng)用上下文
    return context;
}

// 5.打印啟動(dòng)Banner
Banner printedBanner = printBanner(environment);

// 打印啟動(dòng) Banner 的方法，根據(jù)配置的 Banner 模式選擇打印方式
private Banner printBanner(ConfigurableEnvironment environment) {
    // 如果 Banner 模式被設(shè)置為 OFF，則不打印 Banner，直接返回 null
    if (this.bannerMode == Banner.Mode.OFF) {
        return null;
    }

    // 確定資源加載器。如果當(dāng)前實(shí)例的 resourceLoader 不為空，則使用它；否則創(chuàng)建一個(gè)默認(rèn)的資源加載器
    ResourceLoader resourceLoader = (this.resourceLoader != null) ? this.resourceLoader
            : new DefaultResourceLoader(null);

    // 創(chuàng)建 Banner 打印器，負(fù)責(zé)加載和打印 Banner
    SpringApplicationBannerPrinter bannerPrinter = new SpringApplicationBannerPrinter(resourceLoader, this.banner);

    // 根據(jù) Banner 模式?jīng)Q定打印到日志還是控制臺(tái)
    if (this.bannerMode == Mode.LOG) {
        // 如果 Banner 模式為 LOG，則將 Banner 打印到日志中
        return bannerPrinter.print(environment, this.mainApplicationClass, logger);
    }

    // 默認(rèn)情況下（CONSOLE 模式），將 Banner 打印到標(biāo)準(zhǔn)輸出（控制臺(tái)）
    return bannerPrinter.print(environment, this.mainApplicationClass, System.out);
}

// 一個(gè)用于以編程方式輸出 Banner 的接口類(lèi)
@FunctionalInterface
public interface Banner {
	// 將 Banner 輸出到指定的打印流
	void printBanner(Environment environment, Class<?> sourceClass, PrintStream out);

	// 用于配置 Banner 的模式枚舉
	enum Mode {
		// 禁用 Banner 的打印
		OFF,
		// 將 Banner 輸出到 System.out
		CONSOLE,
		// 將 Banner 輸出到日志文件
		LOG
	}
}

spring.main.banner-mode=off

// SpringApplicationBannerPrinter類(lèi)方法
Banner print(Environment environment, Class<?> sourceClass, PrintStream out) {
    // 根據(jù)提供的環(huán)境信息獲取橫幅。
    Banner banner = getBanner(environment);
    
    // 將橫幅打印到指定的輸出流中。
    banner.printBanner(environment, sourceClass, out);
    
    // 返回一個(gè) PrintedBanner 對(duì)象，包含打印的橫幅和源類(lèi)信息。
    return new PrintedBanner(banner, sourceClass);
}

// SpringApplicationBannerPrinter類(lèi)方法
Banner print(Environment environment, Class<?> sourceClass, Log logger) {
	// 根據(jù)提供的環(huán)境信息獲取橫幅。
	Banner banner = getBanner(environment);
	try {
		logger.info(createStringFromBanner(banner, environment, sourceClass));
	}
	catch (UnsupportedEncodingException ex) {
		logger.warn("Failed to create String for banner", ex);
	}
	// 返回一個(gè) PrintedBanner 對(duì)象，包含打印的橫幅和源類(lèi)信息。
	return new PrintedBanner(banner, sourceClass);
}

// SpringApplicationBannerPrinter類(lèi)方法

// 默認(rèn)Banner
private static final Banner DEFAULT_BANNER = new SpringBootBanner();

// 根據(jù)當(dāng)前環(huán)境獲取適當(dāng)?shù)臋M幅（Banner）
private Banner getBanner(Environment environment) {
    // 創(chuàng)建一個(gè) Banners 對(duì)象，用于存儲(chǔ)圖片和文本橫幅
    Banners banners = new Banners();
    // 嘗試獲取圖片橫幅，并將其添加到 Banners 中（如果非空）
    banners.addIfNotNull(getImageBanner(environment));
    // 嘗試獲取文本橫幅，并將其添加到 Banners 中（如果非空）
    banners.addIfNotNull(getTextBanner(environment));
    // 如果至少包含一個(gè)橫幅，則返回組合的 Banners 對(duì)象
    if (banners.hasAtLeastOneBanner()) {
        return banners;
    }
    
    // 如果沒(méi)有任何橫幅但存在備用橫幅，則返回備用橫幅
    if (this.fallbackBanner != null) {
        return this.fallbackBanner;
    }
    
    // 如果沒(méi)有任何橫幅，則返回默認(rèn)橫幅
    // Banner DEFAULT_BANNER = new SpringBootBanner();
    return DEFAULT_BANNER;
}

private Banner getImageBanner(Environment environment) {
    // 從環(huán)境變量中獲取橫幅圖片的路徑
    // String BANNER_IMAGE_LOCATION_PROPERTY = "spring.banner.image.location";
    String location = environment.getProperty(BANNER_IMAGE_LOCATION_PROPERTY);
    
    // 如果路徑不為空，嘗試加載對(duì)應(yīng)的資源
    if (StringUtils.hasLength(location)) {
        Resource resource = this.resourceLoader.getResource(location);
        // 如果資源存在，返回對(duì)應(yīng)的 ImageBanner 對(duì)象
        return resource.exists() ? new ImageBanner(resource) : null;
    }

    // 如果未指定路徑，嘗試加載默認(rèn)圖片橫幅文件
    // String[] IMAGE_EXTENSION = { "gif", "jpg", "png" };
    for (String ext : IMAGE_EXTENSION) {
        Resource resource = this.resourceLoader.getResource("banner." + ext);
        // 如果找到存在的文件資源，返回對(duì)應(yīng)的 ImageBanner 對(duì)象
        if (resource.exists()) {
            return new ImageBanner(resource);
        }
    }
    // 如果沒(méi)有找到任何圖片橫幅資源，返回 null
    return null;
}

private Banner getTextBanner(Environment environment) {
    // 獲取橫幅的路徑，優(yōu)先使用環(huán)境變量中的配置，如果沒(méi)有配置則使用默認(rèn)路徑
    // String BANNER_LOCATION_PROPERTY = "spring.banner.location";
    // String DEFAULT_BANNER_LOCATION = "banner.txt";
    String location = environment.getProperty(BANNER_LOCATION_PROPERTY, DEFAULT_BANNER_LOCATION);

    // 使用 ResourceLoader 加載指定路徑的資源
    Resource resource = this.resourceLoader.getResource(location);

    try {
        // 檢查資源是否存在，且路徑中不包含 "liquibase-core"（防止加載到不相關(guān)的資源）
        if (resource.exists() && !resource.getURL().toExternalForm().contains("liquibase-core")) {
            // 如果資源有效，返回對(duì)應(yīng)的 ResourceBanner 對(duì)象
            return new ResourceBanner(resource);
        }
    } catch (IOException ex) {
        // 忽略異常，可能是資源加載時(shí)出錯(cuò)或路徑無(wú)效
        // 在這里不拋出異常，而是返回 null，表示沒(méi)有有效的橫幅資源
    }
    // 如果資源無(wú)效或發(fā)生異常，返回 null
    return null;
}

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication app = new SpringApplication(Application.class);
        // 設(shè)置全局備用橫幅
        app.setBanner((environment, sourceClass, out) -> {
            out.println("===== 全局備用橫幅 =====");
            out.println(" 默認(rèn)橫幅已啟用 ");
            out.println("=====================");
        });
        app.run(args);
    }
}

// 默認(rèn)的 Banner 實(shí)現(xiàn)，用于打印 "Spring" 的啟動(dòng)橫幅，和版本信息
class SpringBootBanner implements Banner {

    // 預(yù)定義的 ASCII 藝術(shù)橫幅，每行為一個(gè)數(shù)組元素
	private static final String[] BANNER = { 
		"", 
		"  .   ____          _            __ _ _",
		" /\\\\ / ___'_ __ _ _(_)_ __  __ _ \\ \\ \\ \\",
		"( ( )\\___ | '_ | '_| | '_ \\/ _` | \\ \\ \\ \\",
		" \\\\/  ___)| |_)| | | | | || (_| |  ) ) ) )", 
		"  '  |____| .__|_| |_|_| |_\\__, | / / / /",
		" =========|_|==============|___/=/_/_/_/" 
	};

	// 固定的 Spring Boot 標(biāo)識(shí)符，用于橫幅輸出
	private static final String SPRING_BOOT = " :: Spring Boot :: ";

	// 橫幅固定寬度，用于計(jì)算 padding 的空格數(shù)
	private static final int STRAP_LINE_SIZE = 42;

	/**
	 * 輸出橫幅到指定的 PrintStream（如控制臺(tái)或日志）。
	 */
	@Override
	public void printBanner(Environment environment, Class<?> sourceClass, PrintStream printStream) {
		// 遍歷并打印每一行 ASCII 藝術(shù)橫幅
		for (String line : BANNER) {
			printStream.println(line);
		}
		// 獲取 Spring Boot 的版本信息
		String version = SpringBootVersion.getVersion();
		// 如果版本信息不為空，則格式化為 "(vX.X.X)"
		version = (version != null) ? " (v" + version + ")" : "";
		
		// 構(gòu)造 padding 空格，使橫幅版本號(hào)對(duì)齊
		StringBuilder padding = new StringBuilder();
		while (padding.length() < STRAP_LINE_SIZE - (version.length() + SPRING_BOOT.length())) {
			padding.append(" ");
		}

		// 打印 Spring Boot 標(biāo)識(shí)符和版本信息，使用 ANSI 輸出樣式
		printStream.println(AnsiOutput.toString(
			AnsiColor.GREEN,       // 綠色輸出 Spring Boot 標(biāo)識(shí)符
			SPRING_BOOT, 
			AnsiColor.DEFAULT,     // 恢復(fù)默認(rèn)顏色
			padding.toString(),    // 填充的空格
			AnsiStyle.FAINT,       // 微弱樣式（淡化顯示版本信息）
			version                // 版本號(hào)
		));
		// 添加空行用于分隔橫幅和其他輸出
		printStream.println();
	}
}