Getting Started
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 aan de slag kunt gaan.
Om een nieuwe webforJ-app vanuit een archetype te maken, kun je startforJ of de opdrachtregel gebruiken.
Voordat je begint, bekijk de noodzakelijke vereisten voor het opzetten en gebruiken van webforJ.
Gebruik 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 bevat alle vereiste afhankelijkheden, configuratiebestanden en een vooraf gemaakte lay-out, zodat je er meteen op kunt bouwen.
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, Artefact ID)
- webforJ-versie en Java-versie
- Thema kleur en pictogram
- Archetype
- Smaak
Er zijn twee smaakopties om uit te kiezen, waarbij "webforJ Only" de standaard is:
- webforJ Only: Standaard webforJ-app
- webforJ + Spring Boot: webforJ-app met Spring Boot-ondersteuning
De Spring Boot-smaak is alleen beschikbaar in webforJ-versie 25.02 en hoger. Als je deze optie selecteert, zorg er dan voor dat je een compatibele versie kiest.
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 maken vanuit je gekozen archetype met je gekozen aanpassingen. Je kunt ervoor kiezen om je project als een ZIP-bestand te downloaden of het rechtstreeks naar GitHub te publiceren.
Zodra je je project hebt gedownload, open je de projectmap in je IDE en ga je verder met het uitvoeren van de app.
Gebruik van de opdrachtregel
Als je liever de opdrachtregel gebruikt, kun je een project rechtstreeks genereren met behulp van het 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:
|
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. |
Na het uitvoeren van de opdracht genereert Maven de projectbestanden die nodig zijn om het project uit te voeren.
De app uitvoeren
Voordat je je app uitvoert, installeer je de vereisten als je dat nog niet hebt gedaan. Navigeer vervolgens naar de hoofddirectory van het project en voer de volgende opdracht uit:
# voor standaard webforj-app
mvn jetty:run
# voor webforj + Spring Boot
mvn spring-boot:run
Zodra de server draait, open je je browser en ga je naar http://localhost:8080 om de app te bekijken.