Projektsetup

In ChatGPT öffnen

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, dieses Tutorial zu verfolgen, besteht darin, 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. Das Mitverfolgen ermöglicht es Ihnen zu sehen, wie die Anwendung sich von einer grundlegenden Einrichtung zu einem voll funktionsfähigen Kundenverwaltungssystem entwickelt.

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 detaillierte Informationen zur Verwendung von startforJ finden Sie unter Erste Schritte.

Erforderliche Einstellungen

Wählen Sie im Dropdown „webforJ-Version“ die webforJ-Version 26.01 oder höher.
Wählen Sie unter „Läuft auf“ 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 erforderlichen Konfigurationen zu Ihrem Projekt hinzufügen. Dazu gehören Spring Abhängigkeiten, das webforJ Maven-Plugin, das die Frontend-Quellen erstellt und überwacht, sowie die folgenden Eigenschaften in src/main/resources/application.properties:

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

Ausführen der Anwendung

Um die Anwendung in Aktion zu sehen, während Sie das Tutorial durchlaufen:

Navigieren Sie zum Verzeichnis des gewünschten Schrittes. Dies sollte das oberste Verzeichnis für diesen Schritt sein, das die pom.xml enthält.
Verwenden Sie den folgenden Maven-Befehl, um die Spring Boot-Anwendung lokal auszuführen:
```
mvn
```
Die generierte POM konfiguriert diesen Standardbefehl, um die Anwendung zu kompilieren, den webforJ-Frontend-Watcher zu starten und Spring Boot auszuführen.

Das Ausführen der Anwendung öffnet automatisch einen neuen Browser unter http://localhost:8080.