Comenzando

Abrir en ChatGPT

Este artículo describe los pasos para crear una nueva aplicación webforJ utilizando los arquetipos de webforJ. Los arquetipos proporcionan estructuras de proyecto preconfiguradas y código inicial para que puedas iniciar un proyecto rápidamente. Para crear una nueva aplicación webforJ a partir de un arquetipo, puedes usar startforJ o la línea de comandos.

Prerrequisitos

Antes de comenzar, revisa los prerrequisitos necesarios para configurar y usar webforJ.

Usando startforJ

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

Personalizando con startforJ

Cuando creas una aplicación con startforJ, puedes personalizarla proporcionando la siguiente información:

Metadatos básicos del proyecto (Nombre de la aplicación, ID del grupo, ID del artefacto)
Versión de webforJ y versión de Java
Color y icono del tema
Arquetipo
Se ejecuta en

La opción Se ejecuta en decide dónde se ejecuta la aplicación, siendo Contenedor de Servlets la opción predeterminada:

Contenedor de Servlets: un WAR para Jetty, Tomcat u otro contenedor de servlets
Spring Boot: un JAR ejecutable con un servidor embebido
BBjServices: una aplicación que se ejecuta en BBjServices a través de BBjShip

Arquetipos Disponibles

webforJ incluye varios arquetipos predefinidos para ayudarte a comenzar rápidamente. Para una lista completa de arquetipos disponibles, consulta el catálogo de arquetipos.

Utilizando esta información, startforJ creará un proyecto básico a partir de tu arquetipo elegido con las personalizaciones seleccionadas. Puedes optar por descargar tu proyecto como un archivo ZIP o publicarlo directamente en GitHub.

Una vez que hayas descargado tu proyecto, abre la carpeta del proyecto en tu IDE.

Usando la línea de comandos

Si prefieres utilizar la línea de comandos, puedes generar un proyecto directamente utilizando el arquetipo de Maven:

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

Navegar al directorio adecuado: Abre una terminal y muévete a la carpeta donde deseas crear tu nuevo proyecto.
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
PowerShell
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

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"

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` 25.02- Aplicación webforJ con compatibilidad con Spring Boot. `webforj-bbj` 26.03- Aplicación webforJ que se ejecuta en BBjServices a través de BBjShip.
`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.