Saltar al contenido principal

Project Setup

Abrir en ChatGPT

Para comenzar este tutorial, necesitas una ubicación 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:

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 progresa de una configuración básica a un sistema de gestión de clientes totalmente 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 inicial. Consulta Introducción para obtener más información detallada sobre el uso de startforJ.

Configuraciones requeridas
  • En el menú desplegable de versión webforJ, elige la versión 26.01 o superior.
  • En el menú desplegable de Flavor, elige webforJ + Spring Boot.

Usando la línea de comandos​

También puedes generar un nuevo proyecto con el siguiente comando:

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 de crear un nuevo proyecto utilizan los arquetipos de webforJ, que añaden automáticamente las configuraciones necesarias a tu proyecto. Esto incluye dependencias de Spring, el plugin de Maven de webforJ que construye y observa 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

Ejecución de la aplicación​

Para ver la aplicación en acción a medida que avanzas por el tutorial:

  1. Navega al directorio para el paso deseado. Este debe ser el directorio de nivel superior para ese paso, que contiene el pom.xml.

  2. Usa el siguiente comando de Maven para ejecutar la aplicación de Spring Boot localmente:

    mvn

    El POM generado configura este comando predeterminado para compilar la aplicación, iniciar el vigilante de frontend de webforJ y ejecutar Spring Boot.

La ejecución de la aplicación abre automáticamente un nuevo navegador en http://localhost:8080.