Passer au contenu principal

Project Setup

Ouvrir dans ChatGPT

Pour commencer ce tutoriel, vous avez besoin d'un emplacement pour votre projet où vous pouvez gérer vos classes et ressources. Les sections suivantes décrivent les différentes façons de créer votre projet webforJ pour ce tutoriel.

Utilisation du code source​

La façon la plus simple de suivre ce tutoriel est de se référer à son code source. Vous pouvez télécharger l'intégralité du projet ou le cloner depuis GitHub :

git clone https://github.com/webforj/webforj-tutorial.git

Structure du projet​

Le projet comporte cinq sous-répertoires, un pour chaque étape du tutoriel, et chacun contient une application exécutable. Suivre permet de voir comment l'application progresse d'une configuration de base à un système de gestion de clients pleinement fonctionnel.

webforj-tutorial
│   .gitignore
│   LICENSE
│   README.md
│
├───1-creating-a-basic-app  
├───2-working-with-data
├───3-routing-and-composites
├───4-observers-and-route-parameters
└───5-validating-and-binding-data

Utilisation de startforJ​

Si vous préférez créer un nouveau projet, vous pouvez utiliser startforJ pour générer un projet de démarrage minimal. Consultez Premiers pas pour plus d'informations détaillées sur l'utilisation de startforJ.

Paramètres requis
  • Dans le menu déroulant version webforJ, choisissez la version webforJ 25.10 ou supérieure.
  • Dans le menu déroulant Flavor, choisissez webforJ + Spring Boot.

Utilisation de la ligne de commande​

Vous pouvez également générer un nouveau projet avec la commande suivante :

mvn -B archetype:generate \
  -DarchetypeGroupId=com.webforj \
  -DarchetypeArtifactId=webforj-archetype-hello-world \
  -DarchetypeVersion=LATEST \
  -DgroupId=com.webforj.tutorial \
  -DartifactId=customer-app \
  -Dversion=1.0-SNAPSHOT \
  -Dflavor=webforj-spring

Configurations​

Les deux méthodes mentionnées pour créer un nouveau projet utilisent les archétypes webforJ, qui ajoutent automatiquement les configurations nécessaires à votre projet, comme les dépendances Spring à votre POM et les propriétés suivantes dans src/main/resources/application.properties :

spring.application.name=CustomerApplication
server.port=8080
webforj.entry = com.webforj.tutorial.Application
webforj.debug=true

Exécution de l'application​

Pour voir l'application en action au fur et à mesure que vous progressez dans le tutoriel :

  1. Naviguez jusqu'au répertoire pour l'étape souhaitée. Cela devrait être le répertoire de premier niveau pour cette étape, contenant le pom.xml.

  2. Utilisez la commande Maven suivante pour exécuter l'application Spring Boot localement :

    mvn

L'exécution de l'application ouvre automatiquement un nouveau navigateur à http://localhost:8080.