Project Setup
Um dieses Tutorial zu beginnen, benötigen Sie einen Speicherort für Ihr Projekt, an dem Sie Ihre Klassen und Ressourcen verwalten können. Die folgenden Abschnitte beschreiben die verschiedenen Möglichkeiten, wie Sie Ihr webforJ-Projekt für dieses Tutorial erstellen können.
Verwendung des Quellcodes
Der einfachste Weg, diesem Tutorial zu folgen, besteht darin, auf den Quellcode zuzugreifen. Sie können das gesamte Projekt herunterladen oder es von GitHub klonen:
- ZIP herunterladen: webforj-tutorial.zip
- GitHub-Repository: Klonen Sie das Projekt direkt von GitHub
git clone https://github.com/webforj/webforj-tutorial.git
Projektstruktur
Das Projekt hat sechs Unterverzeichnisse, eines für jeden Schritt des Tutorials, und jedes enthält eine ausführbare Anwendung. Wenn Sie Schritt für Schritt folgen, können Sie sehen, wie die App von einer grundlegenden Einrichtung zu einem voll funktionsfähigen Kundenmanagementsystem fortschreitet.
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
Verwendung von startforJ
Wenn Sie lieber ein neues Projekt erstellen möchten, können Sie startforJ verwenden, um ein minimales Starterprojekt zu generieren. Siehe Erste Schritte für detailliertere Informationen zur Verwendung von startforJ.
- Wählen Sie im Dropdown-Menü webforJ-Version die webforJ-Version 26.00 oder höher.
- Wählen Sie im Dropdown-Menü Flavor webforJ + Spring Boot.
Verwendung der Befehlszeile
Sie können auch ein neues Projekt mit dem folgenden Befehl generieren:
- Bash/Zsh
- PowerShell
- Eingabeaufforderung
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
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"
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"
Konfigurationen
Die beiden genannten Möglichkeiten zur Erstellung eines neuen Projekts verwenden webforJ Archetypen, die automatisch die benötigten Konfigurationen zu Ihrem Projekt hinzufügen, wie z.B. Spring Abhängigkeiten in Ihr POM und die folgenden Eigenschaften in src/main/resources/application.properties:
spring.application.name=CustomerApplication
server.port=8080
webforj.entry = com.webforj.tutorial.Application
webforj.debug=true
Ausführen der App
Um die App aktiv zu sehen, während Sie durch das Tutorial fortschreiten:
-
Navigieren Sie zu dem Verzeichnis für den gewünschten Schritt. Dies sollte das oberste Verzeichnis für diesen Schritt sein, das die
pom.xmlenthält. -
Verwenden Sie den folgenden Maven-Befehl, um die Spring-Boot-App lokal auszuführen:
mvn
Die Ausführung der App öffnet automatisch einen neuen Browser unter http://localhost:8080.