
💖简介
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 生成工具进行生成直接使用。(直接网络上检索即可)
结束
