💖简介
Banner
是指应用程序启动时显示的信息。对于Spring Boot
应用来说,默认情况下,当你启动一个 Spring Boot
应用时,控制台上会打印出一段由 Spring Boot
自带的ASCII
艺术字样的 banner
。这不仅是为了美观,也是一种品牌标识的方式。然而,Spring Boot
允许开发者通过简单的配置来替换这个默认的 banner
,以展示自己的个性化内容。
📖原理
Spring Boot
在启动过程中会自动加载src/main/resources
目录下的banner.txt
文件,并将其内容作为启动 banner
输出到控制台。此外,Spring Boot
还支持从banner.gif
、banner.jpg
或 banner.png
图片文件中读取并转换为ASCII
字符输出。如果找不到这些文件,它将使用默认的banner
。
具体如下:SpringApplication
类中的printBanner()
方法负责处理banner
的加载与显示。它首先尝试从环境变量中获取banner
的位置,如果没有指定,则按照一定的顺序查找资源文件。一旦找到合适的banner
资源,就会调用相应的ResourceBanner
或ImageBanner
实现类来解析并输出内容。
⭐使用
🌟使用文本文件定制 Banner
最简单的方法是创建一个名为banner.txt
的文本文件,并将它放在src/main/resources
目录下。你可以在banner.txt
中添加任何你喜欢的文字或ASCII
艺术图案。例如:
____ _ __ __ _/ ___|___ __| | ___ | \/ (_)_ __| | / _ \ / _` |/ _ \_____| |\/| | | '_ \| |__| (_) | (_| | __/_____| | | | | |_) |\____\___/ \__,_|\___| |_| |_|_| .__/|_|
🌟使用属性动态调整 Banner 内容
利用Spring Boot
的占位符功能,在banner.txt
中插入一些动态的内容,如应用版本号、运行环境等。例如:
${AnsiColor.BRIGHT_GREEN}Hello, ${spring-boot.version}${AnsiColor.BRIGHT_RED}
根据实际的
Spring Boot
版本号动态地替换${spring-boot.version}
🌟图像 Banner
除了文本之外,还可以使用图片作为banner
。只需将图片命名为banner.gif
、banner.jpg
或 banner.png
并放置于resources
文件夹下即可。不过需要注意的是,图片会被转换为ASCII
字符形式展示,因此清晰度可能会有所损失。
🌟配置属性
如果不需要显示任何banner
,可以通过在application.properties
或application.yml
中设置 spring.main.banner-mode=off
来禁用它。指定banner
文件路径可以用spring.banner.location=classpath:my-banner.txt
👉在线生成平台
可以使用在线的 Banner 生成工具进行生成直接使用。(直接网络上检索即可)
结束