Aan de slag
Deze handleiding maakt een webforJ-app die met BBjServices wordt uitgevoerd, laat je de app tijdens de ontwikkeling op je lokale BBj uitvoeren en zet de app met BBjShip in productie.
Je hebt een Maven-project nodig en een BBj-installatie met dezelfde versie als webforJ, bijvoorbeeld BBj 26.03 voor webforJ 26.03, waarop BBjServices actief is. BBjShip ondersteunt Gradle niet. Bekijk de vereisten voor de overige tools.
Een BBj-app maken
Je hebt twee opties om een nieuwe webforJ-app te maken die met BBjServices wordt uitgevoerd: de grafische tool startforJ gebruiken of de Maven-opdrachtregel.
Optie 1: startforJ gebruiken
Wanneer je een app maakt met startforJ, kun je deze aanpassen door de volgende informatie op te geven:
- Basisgegevens van het project (appnaam, groeps-ID, artefact-ID)
- webforJ-versie en Java-versie
- Themakleur en pictogram
- Archetype
- Wordt uitgevoerd op - Selecteer BBjServices om een project te maken dat met BBjServices wordt uitgevoerd
Optie 2: de opdrachtregel gebruiken
Als je liever de opdrachtregel gebruikt, genereer je het project met de officiële webforJ-archetypen:
- 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-bbj
mvn -B archetype:generate `
-DarchetypeGroupId="com.webforj" `
-DarchetypeArtifactId="webforj-archetype-blank" `
-DarchetypeVersion="LATEST" `
-DgroupId="org.example" `
-DartifactId="my-app" `
-Dversion="1.0-SNAPSHOT" `
-Dflavor="webforj-bbj"
mvn -B archetype:generate ^
-DarchetypeGroupId="com.webforj" ^
-DarchetypeArtifactId="webforj-archetype-blank" ^
-DarchetypeVersion="LATEST" ^
-DgroupId="org.example" ^
-DartifactId="my-app" ^
-Dversion="1.0-SNAPSHOT" ^
-Dflavor="webforj-bbj"
Met de parameter flavor genereert het archetype een project dat met BBjServices wordt uitgevoerd.
Dit maakt een project met:
- De afhankelijkheid
webforj, zonder de webforJ-engine die door BBjServices wordt geleverd - De webforJ Maven-plug-in, ingesteld om naar BBjShip op je lokale BBj te implementeren, met de artefact-ID als appnaam
- HotswapAgent voor ontwikkelruns
- Voorbeeldweergaven
- webforJ-configuratiebestanden voor ontwikkeling en productie
De app uitvoeren
Een archetypeproject stelt het standaard Maven-doel in. Daarom compileert mvn zonder argumenten de app en start het een ontwikkelrun in je lokale BBjServices:
mvn
De eerste run bereidt je lokale BBj voor. BBjShip wordt geïnstalleerd en HotswapAgent wordt toegevoegd aan BBjServices, waarna BBjServices één keer opnieuw wordt gestart. Vervolgens toont de build het adres van je app:
[INFO] webforJ watch: my-app is running at http://localhost:8888/webapp/my-app
[INFO] webforJ watch: press <kbd>Ctrl</kbd>+<kbd>C</kbd> to stop the app and the watch
De klassen die je compileert, worden beschikbaar in de actieve app zonder dat deze opnieuw hoeft te worden gestart. Stop de build met Ctrl+C om de app te stoppen.
De app implementeren
Voer de volgende opdracht uit om de verpakte app te implementeren:
mvn install
De app wordt vervolgens gepubliceerd op http://localhost:8888/webapp/my-app, totdat je deze opnieuw implementeert of verwijdert. Zie Implementeren voor informatie over implementatie naar een andere BBj-server, bijvoorbeeld vanuit een CI-pipeline.
