Zum Hauptinhalt springen

Project Setup

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, diesem Tutorial zu folgen, besteht darin, sich auf den Quellcode zu beziehen. Sie können das gesamte Projekt herunterladen oder es von GitHub klonen:

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

Erforderliche Einstellungen
  • Wählen Sie im Dropdown-Menü webforJ-Version die webforJ-Version 26.01 oder höher.
  • Wählen Sie im Dropdown-Menü Flavor die Option webforJ + Spring Boot.

Verwendung der Befehlszeile​

Sie können auch ein neues Projekt mit dem folgenden Befehl generieren:

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 Methoden zur Erstellung eines neuen Projekts verwenden die webforJ Archetypen, die automatisch die benötigten Konfigurationen zu Ihrem Projekt hinzufügen. Dazu gehören Spring Abhängigkeiten, das webforJ Maven-Plugin, das die Frontend-Quellen erstellt und überwacht, 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 Anwendung​

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

  1. Navigieren Sie zu dem Verzeichnis für den gewünschten Schritt. Dies sollte das oberste Verzeichnis für diesen Schritt sein, das die pom.xml enthält.

  2. Verwenden Sie den folgenden Maven-Befehl, um die Spring Boot-Anwendung lokal auszuführen:

    mvn

    Die generierte POM konfiguriert diesen Standardbefehl so, dass die Anwendung kompiliert, der webforJ-Frontend-Watcher gestartet und Spring Boot ausgeführt wird.

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