Einführung

In ChatGPT öffnen

Dieser Artikel beschreibt die Schritte zur Erstellung einer neuen webforJ-App mit Hilfe von webforJ Archetypen. Archetypen bieten vorkonfigurierte Projektstrukturen und Starter-Code, sodass Sie ein Projekt schnell aufsetzen und in Betrieb nehmen können. Um eine neue webforJ-App aus einem Archetyp zu erstellen, können Sie startforJ oder die Kommandozeile verwenden.

Voraussetzungen

Bevor Sie beginnen, überprüfen Sie die notwendigen Voraussetzungen für die Einrichtung und Nutzung von webforJ.

Verwendung von startforJ

Der einfachste Weg, eine neue webforJ-App zu erstellen, ist startforJ, das ein minimales Starterprojekt basierend auf einem gewählten webforJ-Archetyp generiert. Dieses Starterprojekt enthält alle erforderlichen Abhängigkeiten, Konfigurationsdateien und ein vorgefertigtes Layout, sodass Sie sofort mit dem Bauen beginnen können.

Anpassung mit startforJ

Wenn Sie eine App mit startforJ erstellen, können Sie diese anpassen, indem Sie die folgenden Informationen bereitstellen:

Grundlegende Projektdaten (App-Name, Gruppen-ID, Artefakt-ID)
webforJ-Version und Java-Version
Farbthema und Symbol
Archetyp
Laufumgebung

Die Wahl der Laufumgebung bestimmt, wo die App ausgeführt wird, wobei Servlet-Container als Standard festgelegt ist:

Servlet-Container: eine WAR für Jetty, Tomcat oder einen anderen Servlet-Container
Spring Boot: eine ausführbare JAR mit einem eingebetteten Server
BBjServices: eine App, die über BBjShip in BBjServices ausgeführt wird

Verfügbare Archetypen

webforJ bietet mehrere vordefinierte Archetypen, um Ihnen den Einstieg zu erleichtern. Eine vollständige Liste der verfügbaren Archetypen finden Sie im Archetypen-Katalog.

Mit diesen Informationen wird startforJ ein Grundprojekt aus Ihrem gewählten Archetyp mit Ihren gewählten Anpassungen erstellen. Sie können Ihr Projekt entweder als ZIP-Datei herunterladen oder direkt auf GitHub veröffentlichen.

Nachdem Sie Ihr Projekt heruntergeladen haben, öffnen Sie den Projektordner in Ihrer IDE.

Verwendung der Kommandozeile

Wenn Sie die Kommandozeile bevorzugen, können Sie ein Projekt direkt mit dem Maven-Archetyp generieren:

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: `webforj` - Standard webforJ-App. `webforj-spring` 25.02- webforJ-App mit Spring-Boot-Unterstützung. `webforj-bbj` 26.03- webforJ-App, die über BBjShip in BBjServices ausgeführt wird.
`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.