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 manière la plus simple de suivre ce tutoriel est de vous 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 possède six sous-répertoires, un pour chaque étape du tutoriel, et chacun contient une application exécutable. Suivre ce tutoriel vous permet de voir comment l'application progresse d'une configuration de base à un système de gestion de clients entièrement 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
└───6-integrating-an-app-layout

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 Commencer pour des informations plus détaillées sur l'utilisation de startforJ.

Paramètres requis
  • Dans le menu déroulant version webforJ, choisissez la version webforJ 26.00 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 archetypes webforJ, qui ajoutent automatiquement les configurations nécessaires à votre projet, telles que 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 de votre progression dans le tutoriel :

  1. Naviguez vers le répertoire de l'étape souhaitée. Cela devrait être le répertoire de niveau supérieur 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.