> Hello,欢迎来到程序员社区。 今天聊一聊 用了自定义Banner后,SpringBoot瞬间变的高大上了...,希望对大家有所帮助。
Java面试手册PDF下载:[点击下载最全Java面试手册](http://117.78.51.75/219-2)
SpringBoot在启动的时候,我们或许想要把自己公司的logo,或者是项目的logo放上去,我们可以试试本文的这些方法,可以让你快速制作一些SpringBoot项目启动时的彩蛋,以提高项目的辨识度,或者是纯碎为了给枯燥的生活平添一些乐趣,那么本文这些内容能很好的帮助到你。
本文知识点,如下图所示:
Banner效果展示
Spring Boot默认的banner图展示效果如下:
我们可以把它变成这样的:
或者是这样的:
或者是这样的:
简直秀的飞起,不但能自定义内容,还能自定义颜色,那接下来我们就来看它是如何实现的吧。
自定义Banner
自定义banner的实现方式有两种,一种是通过重写自定义的 Banner类来实现,另一种通过txt文件来实现。
1.重写Banner类
首先,需要自定义类实现Banner接口,实现代码如下:
import org.springframework.boot.Banner;
import org.springframework.core.env.Environment;
import java.io.PrintStream;
public class MyBanner implements Banner {
private static final String BANNER =
" ___ ___ .__ .__ n" +
" / | \ ____ | | | | ____ n" +
"/ ~ \_/ __ \| | | | / _ \ n" +
"\ Y /\ ___/| |_| |_( )n" +
" \___|_ / \___ >____/____/\____/ n"Java面试手册 +
" \/ \/ ";
@Override
public void printBanner(Environment environment, Class?> sourceClass, PrintStream out) {
out.println(BANNER);
out.println();
}
}
其中 BANNER
变量为自定义banner的内容,我这放入了一个 hello
,然后在SpringBoot启动时设置Banner类为自定义类,实现代码如下:
public static void main(String[] args) {
SpringApplication springApplication = new SpringApplication(DemoApplication.class);
// 设置自定义 Banner
springApplication.setBanner(new MyBanner());
// 启动 Spring Boot
springApplication.run(args);
}
最终的执行效果如下图所示:
2.通过txt文件实现
我们可以在 Spring Boot 工程的 /src/main/resources 目录下创建一个 banner.txt 文件,然后将 ASCII 字符画复制进去,就能替换默认的 banner 了,如下图所示:
之所以可以使用banner.txt文件的方式实现自定义banner是因为SpringBoot框架在启动时会按照以下顺序,查找banner信息:
- 先在 Classpath 下找 文件 banner.gif或banner.jpg 或banner.png , 先找到谁就用谁;
- 以上都没有就在 Classpath 下找 banner.txt;
- 如果都没找到才会使用默认的 SpringBootBanner。
以上知识点是在SpringApplicationBannerPrinter源码中得知的,核心源码如下:
class SpringApplicationBannerPrinter {
static final String BANNER_LOCATION_PROPERTY = "spring.banner.location";
static final String BANNER_IMAGE_LOCATION_PROPERTY = "spring.banner.image.location";
static final String DEFAULT_BANNER_LOCATION = "banner.txt";
static final String[] IMAGE_EXTENSION = new String[]{"gif", "jpg", "png"};
// 忽略非核心源码
private Banner getBanner(Environment environment) {
SpringApplicationBannerPrinter.Banners banners = new SpringApplicationBannerPrinter.Banners();
// 获取图片形式 banner
banners.addIfNotNull(this.getImageBanner(environment));
// 获取文编程电子书汇总字形式 banner
banners.addIfNotNull(this.getTextBanner(environment));
if (banners.hasAtLeastOneBanner()) {
return banners;
} else {
return this.fallbackBanner != null ? this.fallbackBanner : DEFAULT_BANNER;
}
}
private Banner getTextBanner(Environment environment) {
Java面试手册 String location = environment.getProperty("spring.banner.location", "banner.txt");
Resource resource = this.resourceLoader.getResource(location);
return resource.exists() ? new ResourceBanner(resource) : null;
}
private Banner getImageBanner(Environment environment) {
String location = environment.getProperty("spring.banner.image.location");
if (StringUtils.hasLength(location)) {
Resource resource = this.resourceLoader.getResource(location);
return resource.exists() ? new ImageBanner(resource) : null;
} else {
String[] var3 = IMAGE_EXTENSION;
int var4 = var3.length;
for(int var5 = 0; var5 var4; ++var5) {
String ext = var3[var5];
Resource resource = this.resourceLoader.getResource("banner." + ext);
if (resource.exists()) {
return new ImageBanner(resource);
}
}
return null;
}
}
}
所以我们才能使用banner.txt自定义banner信息,当然你也可以使用图片的方式来自定义banner。
此种方式实现起来比较简单,且是无代码侵入式的,推荐使用这种方式。
Banner样式控制
上面讲了banner文字部分的修改,我们还可以修改banner的演示以及其他属性,例如字体的样式,粗体、斜体等,SpringBoot为提供了三个枚举类来设定这些样式,他们分别是:
- AnsiColor:用来设定字符的前景色;
- AnsiBackground:用来设定字符的背景色。
- AnsiStyle:用来控制加粗、斜体、下划线等等。
例如,我们可以使用AnsiColor来设置颜色,banner.txt中的信息如下:
${AnsiColor.BRIGHT_RED} _ _ _ _
${AnsiColor.BRIGHT_RED} | || | ___ | | | | ___
${AnsiColor.BRIGHT_YELLOW} | __ | / -_) | | | | / _
${AnsiColor.BRIGHT_YELLOW} |_||_| ___| _|_|_ _|_|_ ___/
${AnsiColor.BRIGHT_RED}_|"""""|_|"""""|_|"""""|_|"""""|_|"""""|
${AnsiColor.BRIGHT_RED}"`-0-0-'"`-0-0-'"`-0-0-'"`-0-0-'"`-0-0-'
最终的展示效果如下图所示:
Banner使用输出变量
在banner.txt中我们还可以输出一些全局变量,例如:
- ${application.version}:用来获取 MANIFEST.MF 文件中的版本号;
- ${application.formatted-version}:格式化后的 ${application.version} 版本信息;
- ${spring-boot.version}:Spring Boot 版本号;
- ${spring-boot.formatted-version}:格式化后的 ${spring-boot.version} 版本信息。
使用示例如下:
/
o-|[][]|-o
|_--_|
/
||| |||
||| |||
(o)| |(o)
| || |
|__||__|
|__||__|
Spring Boot 版本:${spring-boot.version}
Banner图在线生成
在线生成banner的地址:
- https://www.bootschool.net/ascii
- http://www.network-science.de/ascii/
- http://patorjk.com/software/taag/
- http://www.degraeve.com/img2txt.php
推荐使用第一种,使用缩略图如下:
隐藏Banner
如果我们需要隐藏 banner信息,可以通过以下三种方法实现。
1.通过代码关闭Banner
我们可以在SpringBoot 启动(run)之前设置隐藏 banner,实现代码如下:
public class DemoApplication {
public static void main(String[] args) {
SpringApplication springApplication = new SpringApplication(DemoApplication.class);
// 隐藏 banner
springApplication.setBannerMode(Banner.Mode.OFF);
// 启动 Spring Boot
springApplication.run(args);
}
}
2.通过配置文件隐藏Banner
在SpringBoot的配置文件 application.properties
通过设置如下配置来隐藏banner的显示,配置如下:
spring.main.banner-mode=off
3.在Idea中隐藏Banner
我们可以在Idea的调试配置中隐藏banner,如下图所示:
附:彩蛋
文章的末尾,附一个七彩佛祖的 banner内容:
${AnsiColor.BRIGHT_GREEN}$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$编程电子书汇总$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
${AnsiColor.BRIGHT_YELLOW}$$ _.ooOoo._ $$
${AnsiColor.BRIGHT_RED}$$ o888888888o $$
${AnsiColor.BRIGHT_CYAN}$$ 88" . "88 $$
${AnsiColor.BRIGHT_MAGENTA}$$ (| ^_^ |) $$
${AnsiColor.BRIGHT_GREEN}$$ O = /O $$
${AnsiColor.BRIGHT_RED}$$ ____/`-----'____ $$
${AnsiColor.BRIGHT_CYAN}$$ .' \| |$$ `. $$
${AnsiColor.BRIGHT_MAGENTA}$$ / \||| : |||$$ $$
${AnsiColor.BRIGHT_GREEN}$$ / _||||| -:- |||||- $$
${AnsiColor.BRIGHT_YELLOW}$$ | | \ - $$/ | | $$
${AnsiColor.BRIGHT_GREEN}$$ | _| ''-----/'' | | $$
${AnsiColor.BRIGHT_YELLOW}$$ .-___ `-` ____/-. / $$
${AnsiColor.BRIGHT_CYAN}$$ ___`. .' /--.-- `. . ___ $$
${AnsiColor.BRIGHT_RED}$$ ."" '_/____.' >'"". $$
${AnsiColor.BRIGHT_GREEN}$$ | | : `- `.;`. _ /``;.`/ - ` : | | $$
${AnsiColor.BRIGHT_YELLOW}$$ `-. _ ___ /___ _/ .-` / / $$
${AnsiColor.BRIGHT_CYAN}$$ ========`-.____`-._________/____.-`____.-'======== $$
${AnsiColor.BRIGHT_MAGENTA}$$ `=---=' $$
${AnsiColor.BRIGHT_YELLOW}$$ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ $$
${AnsiColor.BRIGHT_GREEN}$$ 佛祖保佑 永无BUG 永不修改 $$
${AnsiColor.BRIGHT_YELLOW}$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
${AnsiColor.BRIGHT_YELLOW}
实现效果如下图所示:
总结
本文我们讲了自定义banner的两种方法,自定义banner类和banner.txt的方式,其中以源码分析的方式讲了为什么可以通过 banner.txt
自定义banner信息。我们还讲了banner样式控制(颜色、字体样式等)和全局变量输出的方法,以及banner图在线生成的几个地址,最后还讲了 3种隐藏banner的方法。
最后的话
认真写好每一篇原创,只为不辜负你的观看。写作是一件很酷并且能帮助他人的事,我希望能一直坚持下去。如果觉得有用,请随手给我一个赞吧,他将鼓励我产出更好的文章。
参考 &鸣谢
https://www.jianshu.com/p/c1f7617c99aa
https://www.jianshu.com/p/9a2c20e3766d
> 时间不一定能证明很多东西,但是一定能看透很多东西。坚信自己的选择,不动摇,使劲跑,明天会更好。