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 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 progresa 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 más información detallada sobre cómo usar startforJ.
- En el menú desplegable de versión webforJ, elige la versión de webforJ 26.00 o superior.
- En el menú desplegable de Sabor, elige webforJ + Spring Boot.
Usando la línea de comando
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 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 a través del tutorial:
-
Navega al directorio para el 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 Spring Boot localmente:
mvn
Ejecutar la aplicación abre automáticamente un nuevo navegador en http://localhost:8080.