SpringBoot 教程之 banner 定製
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。
原始碼
完整示例：原始碼
使用方法：
mvn clean package
cd target
java -jar sbe-core-banner.jar
複製程式碼引申和引用
引申
參考