Project Setup
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 manera 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. Seguirlo 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 inicial mínimo. Consulta Introducción para obtener información más detallada sobre el uso de startforJ.
- En el desplegable versión de webforJ, elige la versión de webforJ 26.00 o superior.
- En el desplegable Sabor, elige webforJ + Spring Boot.
Usando la línea de comandos
También puedes generar un nuevo proyecto con el siguiente comando:
- Bash/Zsh
- PowerShell
- Command Prompt
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 formas mencionadas de crear un nuevo proyecto utilizan los arquetipos de webforJ, que añaden automáticamente las configuraciones necesarias a tu proyecto, como las dependencias de Spring a tu POM 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 por el tutorial:
-
Navega al directorio del paso deseado. Este debe 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 de Spring Boot localmente:
mvn
Ejecutar la aplicación abrirá automáticamente un nuevo navegador en http://localhost:8080.