Spring Boot

Abrir en ChatGPT

Spring Boot es una opción popular para construir aplicaciones Java, proporcionando inyección de dependencias, autoconfiguración y un modelo de servidor embebido. Al usar Spring Boot con webforJ, puedes inyectar servicios, repositorios y otros beans gestionados por Spring directamente en tus componentes de UI a través de la inyección por constructor.

Cuando usas Spring Boot con webforJ, tu aplicación se ejecuta como un JAR ejecutable con un servidor Tomcat embebido en lugar de desplegar un archivo WAR en un servidor de aplicaciones externo. Este modelo de empaquetado simplifica la implementación y se alinea con las prácticas de implementación nativas de la nube. El modelo de componentes de webforJ y el enrutamiento funcionan junto con el contexto de la aplicación de Spring para gestionar dependencias y configuración.

Crear una aplicación Spring Boot

Tienes dos opciones para crear una nueva aplicación webforJ con Spring Boot: usar la herramienta gráfica startforJ o la línea de comandos de Maven.

Opción 1: Usar startforJ

La forma más sencilla de crear una nueva aplicación webforJ es startforJ, que genera un proyecto inicial mínimo basado en un arquetipo de webforJ elegido. Este proyecto inicial incluye todas las dependencias necesarias, archivos de configuración y un diseño predefinido, para que puedas comenzar a construir sobre él de inmediato.

Cuando creas una aplicación con startforJ, puedes personalizarla proporcionando la siguiente información:

• Metadatos básicos del proyecto (Nombre de la Aplicación, ID del Grupo, ID del Artefacto)
• Versión de webforJ y versión de Java
• Color del Tema e Icono
• Arquetipo
• Sabor - Selecciona webforJ Spring para crear un proyecto Spring Boot

Usando esta información, startforJ creará un proyecto básico de tu arquetipo elegido configurado para Spring Boot. Puedes optar por descargar tu proyecto como un archivo ZIP o publicarlo directamente en GitHub.

Opción 2: Usar la línea de comandos

Si prefieres usar la línea de comandos, genera un proyecto Spring Boot webforJ directamente utilizando los arquetipos oficiales de webforJ:

mvn -B archetype:generate \
  -DarchetypeGroupId=com.webforj \
  -DarchetypeArtifactId=webforj-archetype-hello-world \
  -DarchetypeVersion=LATEST \
  -DgroupId=org.example \
  -DartifactId=my-app \
  -Dversion=1.0-SNAPSHOT \
  -Dflavor=webforj-spring

El parámetro flavor le dice al arquetipo que genere un proyecto Spring Boot en lugar de un proyecto estándar webforJ.

Esto crea un proyecto Spring Boot completo con:

• Configuración del POM principal de Spring Boot
• Dependencia inicial de Spring Boot de webforJ
• Clase principal de la aplicación con @SpringBootApplication y @Routify
• Vistas de ejemplo
• Archivos de configuración tanto para Spring como para webforJ

Ejecutar la aplicación Spring Boot

Un proyecto de arquetipo establece su objetivo predeterminado de Maven, por lo que mvn sin argumentos compila la aplicación, inicia el frontend watch y ejecuta la aplicación:

mvn

La aplicación se inicia con un servidor Tomcat embebido en el puerto 8080 por defecto. Tus vistas y rutas webforJ existentes funcionan exactamente como antes, pero ahora puedes inyectar beans de Spring y usar características de Spring.

Configuración

Usa el archivo application.properties en src/main/resources para configurar tu aplicación. Consulta Configuración de Propiedades para obtener información sobre las propiedades de configuración de webforJ.

Las siguientes configuraciones de application.properties de webforJ son específicas de Spring:

Propiedad	Tipo	Descripción	Predeterminado
webforj.servlet-mapping	Cadena	Patrón de mapeo de URL para el servlet de webforJ.	/*
webforj.exclude-urls	Lista	Patrones de URL que no deben ser manejados por webforJ cuando se mapean a la raíz. Cuando webforJ está mapeado al contexto raíz (/*), estos patrones de URL se excluirán del manejo de webforJ y pueden ser manejados por controladores de Spring MVC en su lugar. Esto permite que los puntos finales REST y otros mapeos de Spring MVC coexistan con las rutas de webforJ.	[]

Diferencias en la configuración

Cuando cambias a Spring Boot, varios aspectos de configuración cambian:

Aspecto	webforJ estándar	webforJ Spring Boot
Empaquetado	Archivo WAR	JAR ejecutable
Servidor	Externo (Jetty, Tomcat)	Tomcat embebido
Comando de ejecución	mvn jetty:run	mvn spring-boot:run
Configuración principal	Solo webforj.conf	application.properties + webforj.conf
Perfiles	webforj-dev.conf, webforj-prod.conf	Perfiles de Spring con application-{profile}.properties
Configuración de puerto	En la configuración del plugin	server.port en propiedades