Getting Started

Ouvrir dans ChatGPT

Cet article décrit les étapes pour créer une nouvelle application webforJ en utilisant les archétypes webforJ. Les archétypes fournissent des structures de projet préconfigurées et du code de démarrage afin que vous puissiez mettre en place un projet rapidement. Pour créer une nouvelle application webforJ à partir d'un archétype, vous pouvez utiliser startforJ ou la ligne de commande.

Prérequis

Avant de commencer, consultez les prérequis nécessaires pour configurer et utiliser webforJ.

Utilisation de startforJ

La manière la plus simple de créer une nouvelle application webforJ est startforJ, qui génère un projet de démarrage minimal basé sur un archétype webforJ choisi. Ce projet de démarrage inclut toutes les dépendances requises, les fichiers de configuration et une mise en page prédéfinie, afin que vous puissiez commencer à construire dessus immédiatement.

Personnalisation avec startforJ

Lorsque vous créez une application avec startforJ, vous pouvez la personnaliser en fournissant les informations suivantes :

• Métadonnées de projet de base (Nom de l'Application, ID de Groupe, ID d'Artifact)
• Version de webforJ et version de Java
• Couleur du Thème et Icône
• Archétype
• Saveur

Il existe deux options de saveur parmi lesquelles choisir, "webforJ Only" étant la valeur par défaut :

• webforJ Only : Application webforJ standard
• webforJ + Spring Boot : Application webforJ avec support Spring Boot

Support Spring Boot

La saveur Spring Boot n'est disponible que dans la version 25.02 de webforJ et supérieure. Si vous sélectionnez cette option, assurez-vous de choisir une version compatible.

Archétypes Disponibles

webforJ est fourni avec plusieurs archétypes prédéfinis pour vous aider à commencer rapidement. Pour une liste complète des archétypes disponibles, consultez le catalogue des archétypes.

En utilisant ces informations, startforJ créera un projet de base à partir de votre archétype choisi avec vos personnalisations choisies. Vous pouvez choisir de télécharger votre projet en tant que fichier ZIP ou de le publier directement sur GitHub.

Une fois votre projet téléchargé, ouvrez le dossier du projet dans votre IDE et passez à l'exécution de l'application.

Utilisation de la ligne de commande

Si vous préférez utiliser la ligne de commande, vous pouvez générer un projet directement en utilisant l'archétype Maven :

Pour créer et mettre en place un nouveau projet hello-world, suivez ces étapes :

1. Naviguez vers le répertoire approprié: Ouvrez un terminal et déplacez-vous dans le dossier où vous souhaitez créer votre nouveau projet.
2. Exécuter la commande archetype:generate: Utilisez la commande Maven ci-dessous et personnalisez le groupId, l'artifactId et la version selon les besoins de votre projet.

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"

Argument	Explication
archetypeGroupId	L'ID de groupe de l'archétype est com.webforj pour les archétypes webforJ.
archetypeArtifactId	Spécifie le nom de l'archétype à utiliser.
archetypeVersion	Spécifie la version de l'archétype à utiliser. Cela garantit que le projet généré est compatible avec une version d'archétype spécifique. Utiliser LATEST sélectionne la version la plus récente disponible.
groupId	Représente l'espace de nom du projet généré. Généralement structuré comme un package Java, par exemple org.example, et est utilisé pour identifier de manière unique votre organisation ou domaine de projet.
artifactId	Spécifie le nom du projet généré. Ce sera le nom de l'artifact résultant et du dossier du projet.
version	Définit la version du projet généré. Une convention courante est MAJOR.MINOR-SNAPSHOT, comme 1.0-SNAPSHOT, où SNAPSHOT indique que le projet est encore en développement.
flavor	Sélectionnez un type de projet : webforj - Application webforJ standard. webforj-spring - application webforJ avec support Spring Boot (nécessite webforJ 25.02 ou version supérieure).
appName	Un paramètre optionnel pouvant être utilisé dans le fichier POM du projet généré. Selon l'archétype webforJ utilisé, il peut servir de titre par défaut pour l'application.

Après l'exécution de la commande, Maven générera les fichiers de projet nécessaires pour exécuter le projet.

Exécution de l'application

Avant d'exécuter votre application, installez les prérequis si ce n'est pas déjà fait. Ensuite, naviguez jusqu'au répertoire racine du projet et exécutez la commande suivante :

# pour une application webforj standard
mvn jetty:run

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

Une fois le serveur en cours d'exécution, ouvrez votre navigateur et allez sur http://localhost:8080 pour voir l'application.