HelloWorld-Archetyp
Dieses Archetyp erstellt eine einfache Hello World-App, um die Grundlagen des Aufbaus einer Benutzeroberfläche mit webforJ zu demonstrieren. Diese Vorlage ist großartig für Anfänger, um schnell zu starten. Sie bietet ein einfaches Beispiel dafür, wie man eine grundlegende webforJ-App einrichtet und ausführt, was sie zu einem ausgezeichneten Ausgangspunkt für neue Entwickler macht.
Dieses Archetyp erstellt eine minimalistischen App mit einigen Komponenten und etwas Styling. Für Entwickler, die ein Projekt mit minimaler Struktur erstellen möchten, siehe das blank Archetyp.
Für mehr Kontrolle über Anpassungen und Konfigurationen können Sie startforJ verwenden, um Ihr Projekt zu erstellen - wählen Sie einfach das HelloWorld Archetyp, wenn Sie Konfigurationsoptionen auswählen.
Verwendung des hello-world Archetyps
Um ein neues hello-world-Projekt zu erstellen und zu scaffolden, folgen Sie diesen Schritten:
- Navigieren Sie zum richtigen Verzeichnis: Öffnen Sie ein Terminal und wechseln Sie in den Ordner, in dem Sie Ihr neues Projekt erstellen möchten.
- Führe den Befehl archetype:generate aus: Verwenden Sie den folgenden Maven-Befehl und passen Sie groupId, artifactId und version nach Bedarf für Ihr Projekt an.
- Bash/Zsh
- PowerShell
- Command Prompt
mvn -B archetype:generate \
-DarchetypeGroupId=com.webforj \
-DarchetypeArtifactId=webforj-archetype-hello-world \
-DarchetypeVersion=LATEST \
-DgroupId=org.example \
-DartifactId=my-app \
-Dversion=1.0-SNAPSHOT \
-Dflavor=webforj \
-DappName=MyApp
mvn -B archetype:generate `
-DarchetypeGroupId="com.webforj" `
-DarchetypeArtifactId="webforj-archetype-hello-world" `
-DarchetypeVersion="LATEST" `
-DgroupId="org.example" `
-DartifactId="my-app" `
-Dversion="1.0-SNAPSHOT" `
-Dflavor="webforj" `
-DappName="MyApp"
mvn -B archetype:generate ^
-DarchetypeGroupId="com.webforj" ^
-DarchetypeArtifactId="webforj-archetype-hello-world" ^
-DarchetypeVersion="LATEST" ^
-DgroupId="org.example" ^
-DartifactId="my-app" ^
-Dversion="1.0-SNAPSHOT" ^
-Dflavor="webforj" ^
-DappName="MyApp"
| Argumentation | Erklärung |
|---|---|
archetypeGroupId | Die Gruppen-ID des Archetyps ist com.webforj für webforJ-Archetypen. |
archetypeArtifactId | Gibt den Namen des zu verwendenden Archetyps an. |
archetypeVersion | Legt die zu verwendende Version des Archetyps fest. Dies stellt sicher, dass das generierte Projekt mit einer bestimmten Archetyp-Version kompatibel ist. Die Auswahl von LATEST wählt die aktuellste verfügbare Version aus. |
groupId | Namespace für das generierte Projekt. Typisch strukturiert wie ein Java-Paket, z.B. org.example und wird verwendet, um Ihre Organisation oder Projektdomain eindeutig zu identifizieren. |
artifactId | Gibt den Namen des generierten Projekts an. Dies wird der Name des resultierenden Artefakts und des Projektordners sein. |
version | Legt die Version des generierten Projekts fest. Eine gängige Konvention ist MAJOR.MINOR-SNAPSHOT, wie 1.0-SNAPSHOT, wobei SNAPSHOT bedeutet, dass sich das Projekt noch in der Entwicklung befindet. |
flavor | Wählen Sie einen Projektgeschmack aus:
|
appName | Ein optionaler Parameter, der in der POM-Datei des generierten Projekts verwendet werden kann. Abhängig vom verwendeten webforJ-Archetyp kann er als Standardtitel für die Anwendung genutzt werden. |
Nach Ausführung des Befehls wird Maven die benötigten Projektdateien generieren, um das Projekt auszuführen.
Ausführen der App
Bevor Sie Ihre App ausführen, installieren Sie die Voraussetzungen, falls Sie dies noch nicht getan haben. Navigieren Sie dann zum Stammverzeichnis des Projekts und führen Sie den folgenden Befehl aus:
# für die standardmäßige webforJ-App
mvn jetty:run
# für webforJ + Spring Boot
mvn spring-boot:run
Sobald der Server läuft, öffnen Sie Ihren Browser und gehen Sie zu http://localhost:8080, um die App anzuzeigen.