Tips Spring:[BOOT] Logotipo personalizado

logo spring

Al iniciarse una aplicación Spring Boot, se muestra en la salida estándar un banner o logotipo con el número de versión.

Esta funcionalidad puede configurarse en el fichero application.properties o application.yml con la opción spring.main.banner-mode. Sus posibles valores son los del enumerado Banner.Mode.

  • off: no se muestra.
  • console: el banner se muestra en la consola, esto es, en la salida estándar de la máquina virtual Java (JVM) que ejecuta la aplicación. Este es el comportamiento predeterminado.
  • log: el banner se escribe en la bitácora con el nivel INFO. Se usa el mismo logger que el empleado para los mensajes de la clase anotada con @SpringBootApplication.

Aunque no es más que un curioso detalle estético, cuesta poco darle cariño a nuestros proyectos y mostrar un logotipo personalizado. Lo que haremos es crearlo en formato Arte ASCII y situarlo en el fichero /src/main/resources/banner.txt. Se puede indicar cualquier otro fichero con la propiedad spring.banner.location. La codificación predeterminada (UTF-8) puede cambiarse con spring.banner.charset.

El siguiente banner ha sido creado a partir de un texto con esta web.

Al texto ASCII se le pueden aplicar los colores definidos en el enumerado AnsiColor del siguiente modo.

¿Te parece útil mostrar la versión de Spring Boot? No la perdemos al usar nuestro propio logo si incluimos la última línea del ejemplo anterior. De hecho, se pueden imprimir estas variables.

application.versionLa versión de la aplicación en el fichero MANIFEST.MF.
spring-boot.versionLa versión de Spring Boot.
application.formatted-versionLe da formato a la versión de Spring Boot. La pone entre paréntesis y precedida de ‘v.
spring-boot.formatted-versionLe da formato a la versión de la aplicación. La pone entre paréntesis y precedida de ‘v.

Este es el resultado en una consola que soporta coloreado ANSI, como la de IntelliJ o Eclipse. Si usas una versión del segundo anterior a 2022-09 (4.25), necesitarás este plugin.

También es posible mostrar la imagen ubicada en el fichero /src/main/resources/banner.png (se admite gif y jpg) o en el indicado por la propiedad spring.banner.image.location. Spring Boot la convertirá a ASCII, pero el resultado puede que no sea bueno del todo y la conversión consume algo de tiempo.

Si finalmente te decantas por la opción de la imagen, encontrarás varias propiedades de configuración con el prefijo spring.banner.image.

Otros tutoriales relacionados con Spring

Introducción a Spring Boot: Aplicación Web con servicios REST y Spring Data JPA

Spring Boot: Gestión de errores en aplicaciones web y REST

Testing en Spring Boot con JUnit 45. Mockito, MockMvc, REST Assured, bases de datos embebidas

Spring JDBC Template: simplificando el uso de SQL

Persistencia en BD con Spring Data JPA

Ficheros .properties en Spring IoC

Deja una respuesta

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Salir /  Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Salir /  Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Salir /  Cambiar )

Conectando a %s

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.