快捷導(dǎo)航

SpringBoot詳解Banner的使用

更新時(shí)間：2022年07月15日 09:39:52 作者：lhf2112

這篇文章主要介紹了超個(gè)性修改SpringBoot項(xiàng)目的啟動(dòng)banner的方法，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

Banner的設(shè)置方式有以下幾種

1、默認(rèn)：SpringBoot + 版本號(hào)；

2、添加自定義資源文件：banner.txt；

3、添加自定義資源文件：banner.jpg/png/gif；

4、SpringApplication的setBanner方法，自定義資源；

下面我們進(jìn)入源碼，SpringBoot如何實(shí)現(xiàn)banner的加載：

進(jìn)入SpringApplication的run方法，可以看到如下的一行內(nèi)容：

Banner printedBanner = printBanner(environment);

這個(gè)就是獲取banner的入口，我們來跟進(jìn)下這個(gè)方法：

	private Banner printBanner(ConfigurableEnvironment environment) {
		if (this.bannerMode == Banner.Mode.OFF) {
			return null;
		}
		ResourceLoader resourceLoader = (this.resourceLoader != null) ? this.resourceLoader
				: new DefaultResourceLoader(getClassLoader());
		SpringApplicationBannerPrinter bannerPrinter = new SpringApplicationBannerPrinter(resourceLoader, this.banner);
		if (this.bannerMode == Mode.LOG) {
			return bannerPrinter.print(environment, this.mainApplicationClass, logger);
		}
		return bannerPrinter.print(environment, this.mainApplicationClass, System.out);

代碼首先檢驗(yàn)是否關(guān)閉了banner(可以通過spring.main.banner-mode=off來配置)，Banner.Mode的取值方式有三種，包括OFF、CONSOLE(控制臺(tái)，默認(rèn))以及LOG(日志)。如果是關(guān)閉狀態(tài)，那么直接返回空。

接下來程序會(huì)根據(jù)模式是CONSOLE或是LOG來分別進(jìn)行處理。處理過程比較相似，我們先看LOG方式打印的方法：

	Banner print(Environment environment, Class<?> sourceClass, Log logger) {
		Banner banner = getBanner(environment);
		try {
			logger.info(createStringFromBanner(banner, environment, sourceClass));
		}
		catch (UnsupportedEncodingException ex) {
			logger.warn("Failed to create String for banner", ex);
		}
		return new PrintedBanner(banner, sourceClass);
	}

我們重點(diǎn)先關(guān)注getBanner方法：

	private Banner getBanner(Environment environment) {
		Banners banners = new Banners();
		banners.addIfNotNull(getImageBanner(environment));
		banners.addIfNotNull(getTextBanner(environment));
		if (banners.hasAtLeastOneBanner()) {
			return banners;
		}
		if (this.fallbackBanner != null) {
			return this.fallbackBanner;
		}
		return DEFAULT_BANNER;
	}

getBanner方法首先會(huì)嘗試通過getImageBanner加載圖片的banner，從配置文件的"spring.banner.image.location"配置項(xiàng)來拼接后綴gif、jpg、png，讀取相應(yīng)的文件，返回一個(gè)ImageBanner對(duì)象，添加到banners；

如果沒有圖片的banner，則會(huì)通過getTextBanner方法獲取txt，從配置文件的"spring.banner.location"獲取配置項(xiàng)，默認(rèn)為banner.txt，讀取文件，返回ResourceBanner對(duì)象，添加到banners；

這時(shí)如果banners還是空的，說明沒有ImageBanner和ResourceBanner被配置，但是有手動(dòng)設(shè)置的fallbackBanner，那么就會(huì)返回它，fallbackBanner就是通過setBanner方法加入的banner。否則就返回不含有自定義信息的，系統(tǒng)默認(rèn)banner。

LOG方式下，會(huì)調(diào)用logger來進(jìn)行info級(jí)別的日志輸出。

而CONSOLE方式的情況下，方法如下：

	Banner print(Environment environment, Class<?> sourceClass, PrintStream out) {
		Banner banner = getBanner(environment);
		banner.printBanner(environment, sourceClass, out);
		return new PrintedBanner(banner, sourceClass);
	}

這里的getBanner方法和LOG方式是一樣的，在這就不再贅述了。與LOG方式不同的是，這種方式是通過System.out標(biāo)準(zhǔn)輸出流，將banner打印到控制臺(tái)上。

到此這篇關(guān)于SpringBoot詳解Banner的使用的文章就介紹到這了,更多相關(guān)SpringBoot Banner內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: