Aan de Slag

Openen in ChatGPT

Dit artikel beschrijft de stappen om een nieuwe webforJ-app te maken met behulp van webforJ archetypes. Archetypes bieden vooraf geconfigureerde projectstructuren en startercode, zodat je snel een project kunt opzetten en draaien. Om een nieuwe webforJ-app vanuit een archetype te maken, kun je startforJ of de opdrachtregel gebruiken.

Vereisten

Voordat je begint, bekijk de noodzakelijke vereisten voor het instellen en gebruiken van webforJ.

Gebruik maken van startforJ

De eenvoudigste manier om een nieuwe webforJ-app te maken is met startforJ, dat een minimaal starterproject genereert op basis van een gekozen webforJ-archetype. Dit starterproject omvat alle vereiste afhankelijkheden, configuratiebestanden en een vooraf gemaakte lay-out, zodat je er meteen mee kunt beginnen.

Aanpassen met startforJ

Wanneer je een app maakt met startforJ, kun je deze aanpassen door de volgende informatie te verstrekken:

Basisprojectmetadata (App-naam, Groep-ID, Artifact-ID)
webforJ-versie en Java-versie
Thema Kleur en Pictogram
Archetype
Draait op

De keuze voor Draait op bepaalt waar de app draait, met Servlet-container als de standaard:

Servlet-container: een WAR voor Jetty, Tomcat of een andere servlet-container
Spring Boot: een uitvoerbare JAR met een ingebouwde server
BBjServices: een app die draait in BBjServices via BBjShip

Beschikbare Archetypes

webforJ wordt geleverd met verschillende vooraf gedefinieerde archetypes om je snel op weg te helpen. Voor een complete lijst van beschikbare archetypes, zie de archetypes catalogus.

Met deze informatie zal startforJ een basisproject creëren op basis van jouw gekozen archetype met jouw gekozen aanpassingen. Je kunt ervoor kiezen om je project als een ZIP-bestand te downloaden of het direct naar GitHub te publiceren.

Zodra je je project hebt gedownload, open je de projectmap in je IDE.

Gebruik maken van de opdrachtregel

Als je liever de opdrachtregel gebruikt, kun je een project rechtstreeks genereren met behulp van de Maven-archetype:

Om een nieuw hello-world project te creëren en te scaffolden, volg deze stappen:

Navigeer naar de juiste map: Open een terminal en ga naar de map waar je je nieuwe project wilt maken.
Voer het archetype:generate commando uit: Gebruik de onderstaande Maven-opdracht en pas groupId, artifactId en versie aan zoals nodig voor jouw project.

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"

Argumenten	Uitleg
`archetypeGroupId`	De groeps-ID van de archetype is com.webforj voor webforJ archetypes.
`archetypeArtifactId`	Geeft de naam van het te gebruiken archetype op.
`archetypeVersion`	Geeft de versie van de archetype op die gebruikt moet worden. Dit zorgt ervoor dat het gegenereerde project compatibel is met een specifieke versie van de archetype. Het gebruik van LATEST selecteert de meest recente beschikbare versie.
`groupId`	Geeft de naamruimte voor het gegenereerde project weer. Typisch gestructureerd als een Java-pakket, zoals org.example, en wordt gebruikt om uw organisatie of projectdomein uniek te identificeren.
`artifactId`	Geeft de naam op van het gegenereerde project. Dit zal de naam zijn van het resulterende artifact en de projectmap.
`version`	Definieert de versie van het gegenereerde project. Een gangbare conventie is MAJOR.MINOR-SNAPSHOT, zoals 1.0-SNAPSHOT, waarbij SNAPSHOT aangeeft dat het project nog in ontwikkeling is.
`flavor`	Selecteer een projectvariant: `webforj` - Standaard webforJ-app. `webforj-spring` 25.02- webforJ-app met Spring Boot-ondersteuning. `webforj-bbj` 26.03- webforJ-app die via BBjShip in BBjServices draait.
`appName`	Een optionele parameter die kan worden gebruikt in het POM-bestand van het gegenereerde project. Afhankelijk van de gebruikte webforJ-archetype kan het worden gebruikt als een standaardtitel voor de applicatie.