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 manières de créer votre projet webforJ pour ce tutoriel.

Using the source code​

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

Project structure​

Le projet a six sous-répertoires, un pour chaque étape du tutoriel, et chacun contient une application exécutable. Suivre les étapes vous permet de voir comment l'application évolue 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

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

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

Using the command line​

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 façons mentionnées de créer un nouveau projet utilisent les archétypes de webforJ, qui ajoutent automatiquement les configurations nécessaires à votre projet. Cela inclut les dépendances Spring, le plugin Maven webforJ qui construit et surveille les sources frontend, 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

Running the app​

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

  1. Naviguez vers le répertoire de 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

    Le POM généré configure cette commande par défaut pour compiler l'application, démarrer le surveillant frontend de webforJ et exécuter Spring Boot.

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