Configuración del Proyecto
Para comenzar este tutorial, necesitas un lugar para tu proyecto donde puedas gestionar tus clases y recursos. Las siguientes secciones describen las diferentes maneras en que puedes crear tu proyecto webforJ para este tutorial.
Usando el código fuente
La forma más fácil de seguir este tutorial es referirse a su código fuente. Puedes descargar todo el proyecto o clonarlo desde GitHub:
- Descargar ZIP: webforj-tutorial.zip
- Repositorio de GitHub: Clona el proyecto directamente desde GitHub
git clone https://github.com/webforj/webforj-tutorial.git
Estructura del proyecto
El proyecto tiene seis subdirectorios, uno para cada paso del tutorial, y cada uno contiene una aplicación ejecutable. Seguir el tutorial te permite ver cómo la aplicación avanza desde una configuración básica hasta un sistema de gestión de clientes completamente funcional.
webforj-tutorial
│ .gitignore
│ LICENSE
│ README.md
│
├───1-creating-a-basic-app
├───2-working-with-data
├───3-routing-and-composites
├───4-observers-and-route-parameters
├───5-validating-and-binding-data
└───6-integrating-an-app-layout
Usando startforJ
Si prefieres crear un nuevo proyecto, puedes usar startforJ para generar un proyecto mínimo. Consulta Introducción para obtener información más detallada sobre el uso de startforJ.
- En el menú desplegable de versión de webforJ, selecciona la versión de webforJ 26.01 o superior.
- En Se ejecuta en, elige Spring Boot.
Usando la línea de comandos
También puedes generar un nuevo proyecto con el siguiente comando:
- Bash/Zsh
- PowerShell
- Símbolo del sistema
mvn -B archetype:generate \
-DarchetypeGroupId=com.webforj \
-DarchetypeArtifactId=webforj-archetype-hello-world \
-DarchetypeVersion=LATEST \
-DgroupId=com.webforj.tutorial \
-DartifactId=customer-app \
-Dversion=1.0-SNAPSHOT \
-Dflavor=webforj-spring
mvn -B archetype:generate `
-DarchetypeGroupId="com.webforj" `
-DarchetypeArtifactId="webforj-archetype-hello-world" `
-DarchetypeVersion="LATEST" `
-DgroupId="com.webforj.tutorial" `
-DartifactId="customer-app" `
-Dversion="1.0-SNAPSHOT" `
-Dflavor="webforj-spring"
mvn -B archetype:generate ^
-DarchetypeGroupId="com.webforj" ^
-DarchetypeArtifactId="webforj-archetype-hello-world" ^
-DarchetypeVersion="LATEST" ^
-DgroupId="com.webforj.tutorial" ^
-DartifactId="customer-app" ^
-Dversion="1.0-SNAPSHOT" ^
-Dflavor="webforj-spring"
Configuraciones
Las dos maneras mencionadas para crear un nuevo proyecto utilizan arquetipos de webforJ, que añaden automáticamente las configuraciones necesarias a tu proyecto. Esto incluye las dependencias de Spring, el plugin de Maven de webforJ que compila y supervisa las fuentes del frontend, y las siguientes propiedades en src/main/resources/application.properties:
spring.application.name=CustomerApplication
server.port=8080
webforj.entry = com.webforj.tutorial.Application
webforj.debug=true
Ejecutando la aplicación
Para ver la aplicación en acción mientras avanzas a través del tutorial:
-
Navega al directorio para el paso deseado. Este debería ser el directorio de nivel superior para ese paso, que contiene el
pom.xml. -
Usa el siguiente comando de Maven para ejecutar la aplicación Spring Boot localmente:
mvnEl POM generado configura este comando predeterminado para compilar la aplicación, iniciar el observador del frontend de webforJ y ejecutar Spring Boot.
Ejecutar la aplicación abrirá automáticamente un nuevo navegador en http://localhost:8080.
Sigue aprendiendo
ArtículoCursor Spring Boot UI: Let the Assistant Write Your Screens in Java
ArtículoStarting a New Java Project: The Decisions That Shape the Stack
ArtículoHow to build a web app in Java, step by step
ArtículoMCP server for Java developers: webforJ setup guide
ArtículoJava web app tutorial for beginners: build your first app