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 mettre en place un nouveau projet hello-world, suivez ces étapes :
- Naviguez vers le répertoire approprié: Ouvrez un terminal et déplacez-vous dans le dossier où vous souhaitez créer votre nouveau projet.
- 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
- 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 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 :
|
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 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.