Archétype HelloWorld
Cet archétype crée une application simple "hello world" pour démontrer les bases de la construction d'une interface utilisateur avec webforJ. Ce modèle est idéal pour les débutants afin de commencer rapidement. Il fournit un exemple clair de la manière de configurer et d'exécuter une application webforJ de base, ce qui en fait un excellent point de départ pour les nouveaux développeurs.
Cet archétype crée une application minimaliste avec quelques composants et un peu de style. Pour les développeurs souhaitant créer un projet avec un minimum d'infrastructure, voir l'archétype vide.
Pour plus de contrôle sur la personnalisation et la configuration, vous pouvez utiliser startforJ pour créer votre projet - il suffit de sélectionner l'archétype HelloWorld lors du choix des options de configuration.
Utilisation de l'archétype hello-world
Pour créer et structurer un nouveau projet hello-world, suivez ces étapes :
- Naviguer vers le bon répertoire: Ouvrez un terminal et déplacez-vous vers le dossier où vous voulez créer votre nouveau projet.
- Exécuter la commande archetype:generate: Utilisez la commande Maven ci-dessous et personnalisez groupId, artifactId et version selon les besoins de votre projet.
- 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"
| 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 spécifique de l'archétype. Utiliser LATEST sélectionne la version la plus récente disponible. |
groupId | Représente l'espace de noms pour le projet généré. Typiquement structuré comme un package Java, tel que 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'artefact 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électionne une variante de projet :
|
appName | Un paramètre optionnel qui peut être utilisé dans le fichier POM du projet généré. Selon l'archétype webforJ utilisé, il peut être utilisé comme titre par défaut pour l'application. |
Après avoir exécuté 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 vous ne l'avez pas encore fait. Ensuite, naviguez vers le répertoire racine du projet et exécutez la commande suivante :
# pour une application standard webforJ
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.