Getting Started

Abrir en ChatGPT

Este artículo describe los pasos para crear una nueva aplicación webforJ utilizando los archetypes de webforJ. Los archetypes proporcionan estructuras de proyecto preconfiguradas y código inicial para que pueda iniciar un proyecto de manera rápida.

Para crear una nueva aplicación webforJ a partir de un archetype, puede usar startforJ o la línea de comandos.

Prerrequisitos

Antes de comenzar, revise los prerrequisitos necesarios para configurar y utilizar webforJ.

Usando startforJ

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

Personalizando con startforJ

Cuando crea una aplicación con startforJ, puede personalizarla proporcionando la siguiente información:

• Metadatos básicos del proyecto (Nombre de la aplicación, ID de grupo, ID de artefacto)
• versión de webforJ y versión de Java
• Color del tema e ícono
• Archetype
• Sabor

Hay dos opciones de sabor para elegir, siendo "solo webforJ" la opción predeterminada:

• Solo webforJ: Aplicación estándar de webforJ
• webforJ + Spring Boot: Aplicación de webforJ con soporte de Spring Boot

Soporte de Spring Boot

El sabor de Spring Boot solo está disponible en la versión 25.02 de webforJ y superiores. Si selecciona esta opción, asegúrese de elegir una versión compatible.

Archetypes disponibles

webforJ viene con varios archetypes predefinidos para ayudarle a comenzar rápidamente. Para ver la lista completa de archetypes disponibles, consulte el catálogo de archetypes.

Con esta información, startforJ creará un proyecto básico a partir de su archetype seleccionado con las personalizaciones elegidas. Puede optar por descargar su proyecto como un archivo ZIP o publicarlo directamente en GitHub.

Una vez que haya descargado su proyecto, abra la carpeta del proyecto en su IDE y continúe con ejecutar la aplicación.

Usando la línea de comandos

Si prefiere usar la línea de comandos, puede generar un proyecto directamente utilizando el archetype de Maven:

Para crear y estructurar un nuevo proyecto hello-world, sigue estos pasos:

1. Navegar al directorio adecuado: Abre una terminal y muévete a la carpeta donde deseas crear tu nuevo proyecto.
2. Ejecutar el comando archetype:generate: Utiliza el comando Maven a continuación y personaliza el groupId, artifactId y versión según sea necesario para tu proyecto.

Bash/Zsh

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 \
-DappName=MyApp

PowerShell

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" `
-DappName="MyApp"

Command Prompt

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" ^
-DappName="MyApp"

Argumento	Explicación
archetypeGroupId	El ID del grupo del arquetipo es com.webforj para los arquetipos de webforJ.
archetypeArtifactId	Especifica el nombre del arquetipo a usar.
archetypeVersion	Especifica la versión del arquetipo a utilizar. Esto asegura que el proyecto generado sea compatible con una versión específica del arquetipo. Usar LATEST selecciona la versión más reciente disponible.
groupId	Representa el espacio de nombres para el proyecto generado. Típicamente estructurado como un paquete de Java, como org.example, y se utiliza para identificar de manera única su organización o dominio del proyecto.
artifactId	Especifica el nombre del proyecto generado. Este será el nombre del artefacto resultante y la carpeta del proyecto.
version	Define la versión del proyecto generado. Una convención común es MAYOR.MENOR-SNAPSHOT, como 1.0-SNAPSHOT, donde SNAPSHOT indica que el proyecto aún está en desarrollo.
flavor	Seleccionar un sabor de proyecto: webforj - Aplicación estándar de webforJ. webforj-spring - Aplicación webforJ con soporte para Spring Boot (requiere webforJ 25.02 o superior).
appName	Un parámetro opcional que se puede usar en el archivo POM del proyecto generado. Dependiendo del arquetipo webforJ utilizado, se puede utilizar como título predeterminado para la aplicación.

Después de ejecutar el comando, Maven generará los archivos del proyecto necesarios para ejecutar el proyecto.

Ejecutando la aplicación

Antes de ejecutar su aplicación, instale los prerrequisitos si aún no lo ha hecho. Luego, navegue hasta el directorio raíz del proyecto y ejecute el siguiente comando:

# para aplicación estándar webforj
mvn jetty:run

# para webforj + Spring Boot
mvn spring-boot:run

Una vez que el servidor esté en funcionamiento, abra su navegador y vaya a http://localhost:8080 para ver la aplicación.