Aloittaminen

Avaa ChatGPT:ssä

Tässä oppaassa luodaan webforJ-sovellus, joka toimii BBjServices-palvelussa, suoritetaan kehityksen aikana paikallisessa BBj:ssä ja otetaan käyttöön BBjShipillä.

Edellytykset

Tarvitset Maven-projektin ja webforJ:n kanssa samaa versiota olevan BBj-asennuksen, esimerkiksi BBj 26.03:n webforJ 26.03:lle, sekä käynnissä olevan BBjServices-palvelun. BBjShip ei tue Gradlea. Katso muiden tarvittavien työkalujen osalta edellytykset.

Luo BBj-sovellus

Voit luoda uuden BBjServices-palvelussa toimivan webforJ-sovelluksen kahdella tavalla: graafisella startforJ-työkalulla tai Mavenin komentorivillä.

Vaihtoehto 1: startforJ:n käyttäminen

Kun luot sovelluksen startforJ:llä, voit mukauttaa sitä antamalla seuraavat tiedot:

Projektin perustiedot (sovelluksen nimi, ryhmätunnus, artefaktin tunnus)
webforJ-versio ja Java-versio
Teeman väri ja kuvake
Arkkityyppi
Toimii ympäristössä – Valitse BBjServices, jos haluat luoda BBjServices-palvelussa toimivan projektin

Vaihtoehto 2: komentorivin käyttäminen

Jos haluat käyttää komentoriviä, luo projekti virallisilla webforJ-arkkityypeillä:

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"

flavor-parametrin avulla arkkityyppi luo projektin, joka toimii BBjServices-palvelussa.

Näin syntyvään projektiin sisältyy:

webforj-riippuvuus ilman webforJ-moottoria, jonka BBjServices tarjoaa
webforJ-Maven-laajennus, joka on määritetty ottamaan sovellus käyttöön paikallisessa BBj:ssä BBjShipillä artefaktin tunnuksen mukaisella sovelluksen nimellä
HotswapAgent kehitysaikaista suorittamista varten
Esimerkkinäkymät
webforJ-määritystiedostot kehitystä ja tuotantoa varten

Suorita sovellus

Arkkityyppiprojekti määrittää Mavenin oletustavoitteen, joten komento mvn ilman argumentteja kääntää sovelluksen ja käynnistää kehitysajon paikallisessa BBjServices-palvelussa:

mvn

Ensimmäinen suoritus valmistelee paikallisen BBj:n. Se asentaa BBjShipin ja lisää HotswapAgentin BBjServices-palveluun, joka käynnistyy tämän jälkeen kerran uudelleen. Koonti tulostaa sitten sovelluksen osoitteen:

[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

Kääntämäsi luokat tulevat käynnissä olevan sovelluksen käyttöön ilman uudelleenkäynnistystä. Pysäytä sovellus painamalla Ctrl+C, jolloin myös koonti pysähtyy.

Ota sovellus käyttöön

Ota paketoitu sovellus käyttöön suorittamalla:

mvn install

Sovellus julkaistaan osoitteessa http://localhost:8888/webapp/my-app, kunnes otat sen uudelleen käyttöön tai poistat sen. Katso kohdasta Käyttöönotto, miten sovellus otetaan käyttöön toisella BBj-palvelimella, esimerkiksi CI-putkesta.