Project Setup
Um mit diesem 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, ist, sich auf den Quellcode zu beziehen. 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. Folgen Sie den Anweisungen, um zu sehen, wie die Anwendung vom einfachen Setup zu einem voll funktionsfähigen Kundenverwaltungssystem 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. Weitere Informationen zur Verwendung von startforJ finden Sie unter Erste Schritte.
- Wählen Sie im Dropdown webforJ-Version die webforJ-Version 26.00 oder höher.
- Wählen Sie im Dropdown 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 zwei genannten Möglichkeiten zur Erstellung eines neuen Projekts verwenden webforJ Archetypen, die automatisch die benötigten Konfigurationen zu Ihrem Projekt hinzufügen, wie Spring Abhängigkeiten in Ihrem 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 in Aktion zu sehen, während Sie durch das Tutorial fortschreiten:
-
Navigieren Sie zum 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
Das Ausführen der App öffnet automatisch einen neuen Browser unter http://localhost:8080.