Banner的輸出打印過(guò)程
今天，我給大家來(lái)講講如何讓你的 Spring Boot 屌炸天，自定義 banner 。有些新入門(mén)的朋友可能會(huì)不知道 banner 是什么？它在哪里？我在哪里見(jiàn)過(guò)它嗎？這3連門(mén)是不是很有意思。我們今天所說(shuō)的 banner 如下圖所示，想必大家在啟動(dòng) Spring Boot 項(xiàng)目的時(shí)候，大家都見(jiàn)過(guò)吧。
大家可能都見(jiàn)過(guò)永不宕機(jī)的佛祖的 banner 圖片吧。下圖，大家應(yīng)該都很熟悉吧。
今天我就來(lái)帶大家來(lái)看看源碼，看看這個(gè) banner 到底是怎么實(shí)現(xiàn)的。
Spring Boot 內(nèi)置 3 種 Banner打印方式
從下圖可以看出，Spring Boot 支持打印的Banner 方式有3種， SpringBootBanner 是Spring Boot 默認(rèn)的 Banner 打印方式， ResouceBanner 是文本類(lèi)型的 Banner 打印方式， ImageBanner 是圖片類(lèi)型的 Banner 打印方式。
我們來(lái)看看 Banner 接口，從下方的代碼，我們可以了解到，Banner 接口包含一個(gè) printBanner 的方法 和 Mode 的枚舉，Mode 包含三種狀態(tài)，其中 OFF 表示不打印 Banner ， LOG 表示把 Banner 輸出到日志文件中， CONSOLE 表示輸出到控制臺(tái)，也是我們比較常見(jiàn)的方式。
@FunctionalInterface
public interface Banner {
void printBanner(Environment environment, Class< ? > sourceClass, PrintStream out);
enum Mode {
OFF,
CONSOLE,
LOG
}
}
Banner 打印流程
從 SpringApplication 類(lèi)的 run 方法可以看出，printBanner 方法在 prepareEnvironment 之后，這是因?yàn)?application.properties 中有一些關(guān)于 Banner 的配置項(xiàng)。需要先解析 application.properties 的值，并將其綁定到對(duì)應(yīng)的 bean 之后，再進(jìn)行后續(xù)的操作。
public ConfigurableApplicationContext run(String... args) {
...
ApplicationArguments applicationArguments = new DefaultApplicationArguments(args);
ConfigurableEnvironment environment = prepareEnvironment(listeners, bootstrapContext, applicationArguments);
configureIgnoreBeanInfo(environment);
// 打印 Banner
Banner printedBanner = printBanner(environment);
...
}
private Banner printBanner(ConfigurableEnvironment environment) {
if (this.bannerMode == Banner.Mode.OFF) {
return null;
}
ResourceLoader resourceLoader = (this.resourceLoader != null) ? this.resourceLoader
: new DefaultResourceLoader(null);
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);
}
printBanner 具體的流程如下：
- 判斷 bannerMode，如果是 OFF，表示不打印。如果是 LOG，表示打印到文件，否則打印到控制臺(tái)。
- SpringApplicationBannerPrinter 依據(jù)指定位置是是否存在文件，判斷 Banner 類(lèi)型是文本還是圖片，文本類(lèi)型使用 ResourceBanner, 圖片類(lèi)型使用 ImageBanner， 如果都不是，使用 Spring Boot 默認(rèn)的 SpringBootBanner。
- SpringApplicationBannerPrinter#print 方法調(diào)用 Banner 對(duì)象的的 printBanner 方法。不同類(lèi)型的 Banner 的 printBanner 方法實(shí)現(xiàn)不同。
如下是 Banner 對(duì)象的獲得方法，可以看出，Spring Boot 首先獲得 ImageBanner，然后是 ResourceBanner，需要注意的是，這兩者可以同時(shí)存在，此時(shí)會(huì)一次性打印兩種 Banner。如果都不滿足，還會(huì)去獲得 fallbackBanner，這個(gè)是用戶自己設(shè)定的 Banner，但是我們基本很少使用，大部分情況我們使用了 Spring Boot 內(nèi)置的 SpringBootBanner。
class SpringApplicationBannerPrinter {
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;
}
private Banner getTextBanner(Environment environment) {
String location = environment.getProperty(BANNER_LOCATION_PROPERTY, DEFAULT_BANNER_LOCATION);
Resource resource = this.resourceLoader.getResource(location);
try {
if (resource.exists() && !resource.getURL().toExternalForm().contains("liquibase-core")) {
return new ResourceBanner(resource);
}
}
catch (IOException ex) {
// Ignore
}
return null;
}
private Banner getImageBanner(Environment environment) {
String location = environment.getProperty(BANNER_IMAGE_LOCATION_PROPERTY);
if (StringUtils.hasLength(location)) {
Resource resource = this.resourceLoader.getResource(location);
return resource.exists() ? new ImageBanner(resource) : null;
}
for (String ext : IMAGE_EXTENSION) {
Resource resource = this.resourceLoader.getResource("banner." + ext);
if (resource.exists()) {
return new ImageBanner(resource);
}
}
return null;
}
}
如何關(guān)閉 Spring Boot 的 Banner
從 SpringApplication#printBanner 方法可以看出。當(dāng)我們將 bannerMode 設(shè)置為 Banner.Mode.OFF 的時(shí)候，該方法返回 null，也就是此時(shí)不會(huì)打印 Banner。所以只要設(shè)置 bannerMode 為 OFF ，我們就能關(guān)閉 Banner 功能。
private Banner printBanner(ConfigurableEnvironment environment) {
if (this.bannerMode == Banner.Mode.OFF) {
return null;
}
...
}
第一種就是在啟動(dòng)代碼中設(shè)置。如下所示。
public static void main(String[] args) {
SpringApplication app
= new SpringApplication(HelloApplication.class);
app.setBannerMode(Banner.Mode.OFF);
app.run(args);
}
第二種是在 application.properties 中配置 spring.main.banner-mode
spring.main.banner-mode=off
這兩種方式都可以關(guān)閉 Banner，那當(dāng)它們同時(shí)存在的時(shí)候，哪個(gè)生效呢？我們可以這樣分析，啟動(dòng)代碼中調(diào)用 setBannerMode 方法，改變了 bannerMode 的值，之后 SpringApplication 對(duì)象執(zhí)行 run 方法，在 run 方法中會(huì)解析 application.properties 的值，并將其綁定到對(duì)應(yīng)的 bean，后者覆蓋前者，所以 application.properties 中的配置優(yōu)先級(jí)更高。
自定義文本類(lèi)型的 Banner
Spring Boot 中自定義文本類(lèi)型的 Banner 很簡(jiǎn)單，我們只要在 resources 下增加一個(gè) banner.txt 就可以了。比如我想讓 Banner 顯示 永不宕機(jī)的佛祖雕像。那我就可以在 banner.txt 中增加以下文本。
////////////////////////////////////////////////////////////////////
// _ooOoo_ //
// o8888888o //
// 88" . "88 //
// (| ^_^ |) //
// O = /O //
// ____/`---'____ //
// .' | |// `. //
// / ||| : |||// //
// / _||||| -:- |||||- //
// | | - /// | | //
// | _| ''---/'' | | //
// .-__ `-` ___/-. / //
// ___`. .' /--.-- `. . ___ //
// ."" '< `.____<| >_/___.' >'"". //
// | | : `- `.;` _ /`;.`/ - ` : | | //
// `-. _ __ /__ _/ .-` / / //
// ========`-.____`-.________/___.-`____.-'======== //
// `=---=' //
// ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ //
// 佛祖保佑 永不宕機(jī) 永無(wú)BUG //
////////////////////////////////////////////////////////////////////
打印結(jié)果是這樣的
如果我們想打印彩色的 banner 出來(lái)呢？在Spring Boot 中我們可以利用 AnsiColor 類(lèi)來(lái)實(shí)現(xiàn)，我們可以在 banner.txt 中使用 AnsiColor 指定后續(xù)的文本的顏色。
${AnsiColor.YELLOW}
////////////////////////////////////////////////////////////////////
// _ooOoo_ //
// o8888888o //
// 88" . "88 //
// (| ^_^ |) //
// O = /O //
// ____/`---'____ //
// .' | |// `. //
// / ||| : |||// //
// / _||||| -:- |||||- //
// | | - /// | | //
// | _| ''---/'' | | //
// .-__ `-` ___/-. / //
// ___`. .' /--.-- `. . ___ //
// ."" '< `.____<| >_/___.' >'"". //
// | | : `- `.;` _ /`;.`/ - ` : | | //
// `-. _ __ /__ _/ .-` / / //
// ========`-.____`-.________/___.-`____.-'======== //
// `=---=' //
// ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ //
// 佛祖保佑 永不宕機(jī) 永無(wú)BUG //
////////////////////////////////////////////////////////////////////
如下是最終的結(jié)果
public class ResourceBanner implements Banner {
@Override
public void printBanner(Environment environment, Class< ? > sourceClass, PrintStream out) {
try {
String banner = StreamUtils.copyToString(this.resource.getInputStream(),
environment.getProperty("spring.banner.charset", Charset.class, StandardCharsets.UTF_8));
for (PropertyResolver resolver : getPropertyResolvers(environment, sourceClass)) {
banner = resolver.resolvePlaceholders(banner);
}
out.println(banner);
}
catch (Exception ex) {
logger.warn(LogMessage.format("Banner not printable: %s (%s: '%s')", this.resource, ex.getClass(),
ex.getMessage()), ex);
}
}
protected List< PropertyResolver > getPropertyResolvers(Environment environment, Class< ? > sourceClass) {
List< PropertyResolver > resolvers = new ArrayList< >();
resolvers.add(environment);
resolvers.add(getVersionResolver(sourceClass));
resolvers.add(getAnsiResolver());
resolvers.add(getTitleResolver(sourceClass));
return resolvers;
}
}
我們通過(guò)上述代碼來(lái)看看，Spring Boot 為什么能打印出帶顏色的 banner， ResourceBanner 將讀取到的文本流轉(zhuǎn)換為一串字符串。再通過(guò)4個(gè)解析器，來(lái)處理待輸出的 Banner 內(nèi)容。
四個(gè)解析器分別是：
- environment 對(duì)應(yīng) application.properties 中的配置;
- VersionResolver 解析 spring boot 版本，
- AnsiResolver 解析顏色或字體等樣式配置，
- TitleResolver 解析當(dāng)前應(yīng)用的版本，名稱(chēng)等。
Banner圖在線生成
在線生成 banner 的地址：
- https://www.bootschool.net/ascii
- http://www.network-science.de/ascii/
- http://patorjk.com/software/taag//
- http://www.degraeve.com/img2txt.php
總結(jié)
本文主要講述了Banner的輸出打印過(guò)程，如何打印個(gè)性化的文本 Banner。ImageBanner 沒(méi)在本文詳細(xì)說(shuō)明，有興趣的朋友可以查看閱讀源碼，也比較簡(jiǎn)單，也有助于你了解 Java 如何實(shí)現(xiàn)圖片轉(zhuǎn)文本的知識(shí)點(diǎn)。通過(guò)本文的知識(shí)點(diǎn)，你也可以根據(jù)自己的要求來(lái)實(shí)現(xiàn) Banner， 設(shè)置為 fallbackBanner, 從而達(dá)到完全個(gè)性化的自定義 Banner 的效果。
-
接口
+關(guān)注
關(guān)注
33文章
9000瀏覽量
153712 -
打印
+關(guān)注
關(guān)注
1文章
66瀏覽量
19014 -
Banner
+關(guān)注
關(guān)注
0文章
4瀏覽量
7771 -
日志
+關(guān)注
關(guān)注
0文章
144瀏覽量
10865
發(fā)布評(píng)論請(qǐng)先 登錄
福祿克紅外熱像儀:如何控制3D打印工藝
AB32VG1開(kāi)發(fā)板開(kāi)發(fā)環(huán)境搭建和串口調(diào)試打印過(guò)程
東芝數(shù)碼復(fù)印機(jī)復(fù)印過(guò)程概述
東芝數(shù)碼復(fù)印機(jī)復(fù)印過(guò)程詳述
東芝數(shù)碼復(fù)印機(jī)原理與復(fù)印過(guò)程概述
什么是Banner
3D打印機(jī)使用說(shuō)明書(shū)包括操作說(shuō)明和注意事項(xiàng)和保養(yǎng)資料免費(fèi)下載
打印機(jī)如何取消打印任務(wù)
網(wǎng)印過(guò)程中網(wǎng)會(huì)出現(xiàn)哪些故障
膠印技術(shù)工藝參數(shù)會(huì)如何影響膠印過(guò)程
3D打印過(guò)程中會(huì)遇到哪些問(wèn)題
計(jì)算機(jī)視覺(jué)算法在監(jiān)測(cè)金屬3D打印過(guò)程中產(chǎn)生的缺陷
如何避免3D打印機(jī)使用過(guò)程中出現(xiàn)拉絲
為什么在金屬 3D 打印過(guò)程中使用氧氣分析儀很重要？
工商網(wǎng)監(jiān)
評(píng)論