只要你在 resources 目錄下放置名為 banner.txt、banner.gif 、banner.jpg 或 banner.png 的文件,Spring Boot 會自動載入,將其作為啟動時列印的 logo。 ...
本人免費整理了Java高級資料,涵蓋了Java、Redis、MongoDB、MySQL、Zookeeper、Spring Cloud、Dubbo高併發分散式等教程,一共30G,需要自己領取。
傳送門:https://mp.weixin.qq.com/s/JzddfH-7yNudmkjT0IRL8Q
- 簡介
- 變數
- 配置
- 編程
Spring Boot 啟動時預設會顯示以下 logo:
. ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v2.1.1.RELEASE)
實際上,Spring Boot 支持自定義 logo 的功能。
讓我們來看看如何實現的。
簡介
只要你在 resources
目錄下放置名為 banner.txt
、banner.gif
、banner.jpg
或 banner.png
的文件,Spring Boot 會自動載入,將其作為啟動時列印的 logo。
- 對於文本文件,Spring Boot 會將其直接輸出。
- 對於圖像文件(
banner.gif
、banner.jpg
或banner.png
),Spring Boot 會將圖像轉為 ASCII 字元,然後輸出。
變數
banner.txt 文件中還可以使用變數來設置字體、顏色、版本號。
變數描述${application.version}MANIFEST.MF
中定義的版本。如:1.0${application.formatted-version}MANIFEST.MF
中定義的版本,並添加一個v
首碼。如:v1.0${spring-boot.version}
Spring Boot 版本。如:2.1.1.RELEASE
.${spring-boot.formatted-version}
Spring Boot 版本,並添加一個v
首碼。如:v2.1.1.RELEASE${Ansi.NAME}
(or${AnsiColor.NAME}
,${AnsiBackground.NAME}
,${AnsiStyle.NAME}
)ANSI 顏色、字體。更多細節,參考:AnsiPropertySource
。${application.title}MANIFEST.MF
中定義的應用名。
示例:
在 Spring Boot 項目中的 resources
目錄下添加一個名為 banner.txt 的文件,內容如下:
${AnsiColor.BRIGHT_YELLOW}${AnsiStyle.BOLD} ________ ___ ___ ________ ___ __ ___ ___ |\ ___ \|\ \|\ \|\ ___ \|\ \ |\ \|\ \|\ \ \ \ \_|\ \ \ \\\ \ \ \\ \ \ \ \ \ \ \ \ \\\ \ \ \ \ \\ \ \ \\\ \ \ \\ \ \ \ \ __\ \ \ \ \\\ \ \ \ \_\\ \ \ \\\ \ \ \\ \ \ \ \|\__\_\ \ \ \\\ \ \ \_______\ \_______\ \__\\ \__\ \____________\ \_______\ \|_______|\|_______|\|__| \|__|\|____________|\|_______| ${AnsiBackground.WHITE}${AnsiColor.RED}${AnsiStyle.UNDERLINE} :: Spring Boot :: (v${spring-boot.version}) :: Spring Boot Tutorial :: (v1.0.0)
註:${}
設置字體顏色的變數之間不能換行或空格分隔,否則會導致除最後一個變數外,都不生效。
啟動應用後,控制台將列印如下 logo:
推薦兩個生成字元畫的網站,可以將生成的字元串放入這個banner.txt
文件:
配置
application.properties
中與 Banner 相關的配置:
# banner 模式。有三種模式:console/log/off
# console 列印到控制台(通過 System.out)
# log - 列印到日誌中
# off - 關閉列印
spring.main.banner-mode = off
# banner 文件編碼
spring.banner.charset = UTF-8
# banner 文本文件路徑
spring.banner.location = classpath:banner.txt
# banner 圖像文件路徑(可以選擇 png,jpg,gif 文件)
spring.banner.image.location = classpath:banner.gif
used).
# 圖像 banner 的寬度(字元數)
spring.banner.image.width = 76
# 圖像 banner 的高度(字元數)
spring.banner.image.height =
# 圖像 banner 的左邊界(字元數)
spring.banner.image.margin = 2
# 是否將圖像轉為黑色控制台主題
spring.banner.image.invert = false
當然,你也可以在 YAML 文件中配置,例如:
spring:
main:
banner-mode: off
編程
預設,Spring Boot 會註冊一個 SpringBootBanner
的單例 Bean,用來負責列印 Banner。
如果想完全個人定製 Banner,可以這麼做:先實現 org.springframework.boot.Banner#printBanner
介面來自己定製 Banner。在將這個 Banner 通過 SpringApplication.setBanner(…)
方法註入 Spring Boot。