Spring Boot Banner là gì? Tùy chỉnh file banner.txt

Spring Boot Banner là gì? Tùy chỉnh file banner.txt

1. Spring Boot Banner là gì

Spring Boot banner là banner được in khi ứng dụng được start. Mặc định banner sẽ là:

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::            (v2.0.0.RC1)

– Chúng ta có thể thay đổi banner được in ra bằng cách thêm file banner.txt với thông tin cần in ra vào classpath (src/main/resource) hoặc chỉ rõ đường dẫn file banner bằng tham số spring.banner.location trong file application.properties.

– Ngoài sử dụng file text, chúng ta cũng có thể thêm file image như banner.gif, banner.jpg hoặc banner.png vào classpath hoặc chỉ rõ bằng tham số spring.banner.image.location trong file applicaton.properties. Image sẽ được chuyển thành mã ASCII và được in ra giống text.

– Các biến trong file banner (banner variable)

${application.version}: Số của version ứng dụng được khai báo trong MANIFEST.MF, ví dụ version Snap 1.0 sẽ được in ra là 1.0

${application.formatted-version}: Số của version ứng dụng được khai báo trong MANIFEST.MF và định đạng cho hiển thị.

${spring-boot.version}: Hiển thị Spring Boot version, ví dụ 2.0.0.RC1

${spring-boot.formatted-version}: Hiển thị Spring Boot version với định dạng cho hiển thị (ví dụ được bao quanh bởi dấu ngoặc và bắt đầu bằng chữ v: (v2.0.0.RC1 ))

${application.title}: Tilte của ứng dụng được khai báo trong MANIFEST.MF

– Để tắt không in ra banner ta làm như sau:

Cấu hình trong file YAML:

spring:
  main:
    banner-mode: "off"

Hoặc trong file code:

public static void main(String[] args) {
  SpringApplication app = new SpringApplication(MySpringConfiguration.class);
  app.setBannerMode(Banner.Mode.OFF);
  app.run(args);
}

2. Ví dụ tùy chỉnh Spring Boot banner

ví dụ mình sẽ sử dụng file my_banner.txt

                   +++                                                
                +++++++++                                             
            +++++++++++++++++                                         
         +++++++++++++++++++++++        +++++++++++           ++++    
      ++++++++++++++++++++++++++++++  +++         ++          ++++    
        +++++++++++++++++++++++++    ++++                     ++++    
       +   +++++++++++++++++++   +   ++++                     ++++    
      ++++++   +++++++++++    +++++    ++++++                 ++++    
          +++++   +++++   ++++++           +++++++            ++++    
      ++++   ++++++    +++++   ++++             +++++         ++++    
        +++++    ++++++++   ++++++                ++++        ++++    
       ++  ++++++   ++   +++++   ++               +++         ++++    
      ++++++   +++++ ++++++   +++++ +++++      +++++    +    ++++     
          +++++   +++++   ++++++        ++++++++         ++++++       
             ++++++    +++++                                          
                 ++++++++                                             
                    +                                                 

Demo Spring Boot Banner. Spring Boot${spring-boot.formatted-version} :: ${Ansi.DEFAULT}

Cấu hình trong file application.properties

spring.banner.location=my_banner.txt

Kết quả:

Spring Boot Banner là gì? Tùy chỉnh file banner.txt

 

Spring Boot Banner là gì? Tùy chỉnh file banner.txt

Okay, Done!
Download code ví dụ trên tại đây.

 

References:

https://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#boot-features-banner

stackjava.com