Getting Started

Avaa ChatGPT:ssä

Tässä artikkelissa käsitellään vaiheita uuden webforJ-sovelluksen luomiseksi käyttäen webforJ archetypet. Archetypet tarjoavat esikonfiguroituja projektirakenteita ja aloituskoodia, jotta voit saada projektisi nopeasti käyntiin. Uuden webforJ-sovelluksen luomiseksi archetypestä voit käyttää startforJ tai komentoriviä.

Esivaatimukset

Ennen aloittamista tarkista tarvittavat esivaatimukset webforJ:n asentamiseksi ja käyttämiseksi.

Käyttämällä startforJ

Yksinkertaisin tapa luoda uusi webforJ-sovellus on startforJ, joka generoi minimiaalisen aloitusprojektin valitun webforJ-archetypen perusteella. Tämä aloitusprojekti sisältää kaikki tarvittavat riippuvuudet, konfiguraatiotiedostot ja valmiin ulkoasun, jotta voit alkaa rakentaa sitä heti.

Mukauttaminen startforJ:n avulla

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

• Perusprojektin metatiedot (Sovelluksen nimi, Ryhmän ID, Artefaktin ID)
• webforJ-versio ja Java-versio
• Teeman väri ja kuvake
• Archetype
• Flavor

Valittavana on kaksi flavor-vaihtoehtoa, joista "webforJ Only" on oletus:

• webforJ Only: Standardi webforJ-sovellus
• webforJ + Spring Boot: webforJ-sovellus Spring Boot -tuella

Spring Boot -tuki

Spring Boot -flavor on saatavilla vain webforJ-versiossa 25.02 ja korkeammissa. Jos valitset tämän vaihtoehdon, varmista, että valitset yhteensopivan version.

Saatavilla olevat Archetypet

webforJ sisältää useita ennalta määriteltyjä archetypeja auttaakseen sinua pääsemään nopeasti alkuun. Täydellisen luettelon saatavilla olevista archetypeista löydät archetype-katalogista.

Tämän tiedon avulla startforJ luo perusprojektin valitsemastasi archetypestä ja valitsemillasi mukautuksilla. Voit valita, haluatko ladata projektisi ZIP-tiedostona tai julkaista sen suoraan GitHubiin.

Kun olet ladannut projektisi, avaa projektikansio IDE:ssäsi ja siirry eteenpäin sovelluksen ajamiseen.

Käyttämällä komentoriviä

Jos haluat käyttää komentoriviä, voit luoda projektin suoraan käyttäen Maven-archetypea:

Luo ja rakenna uusi hello-world projekti seuraamalla näitä vaiheita:

1. Siirry oikeaan hakemistoon: Avaa pääte ja siirry kansioon, johon haluat luoda uuden projektin.
2. Suorita komento: archetype:generate: Käytä alla olevaa Maven-komentoa ja mukauta groupId, artifactId ja versio tarpeidesi mukaan.

Bash/Zsh

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

PowerShell

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"

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"

Argumentti	Selitys
archetypeGroupId	Archetyypin ryhmätunnus on com.webforj webforJ-archetyypeille.
archetypeArtifactId	Määritä käytettävän arkkityypin nimi.
archetypeVersion	Määritä käytettävän arkkityypin versio. Tämä varmistaa, että luotu projekti on yhteensopiva tietyn arkkityypin version kanssa. LATEST valitsee saatavilla olevan uusimman version.
groupId	Edustaa generoituun projektiin liittyvää nimiavaruutta. Tyypillisesti rakennettu Java-paketin kaltaisesti, kuten org.esimerkki, ja käytetään organisaatiosi tai projektisi alueen ainutlaatuisen tunnistamisen tueksi.
artifactId	Määrittelee luodun projektin nimen. Tämä on lopullisen artefaktin ja projektikansion nimi.
version	Määrittelee luodun projektin version. Yleinen käytäntö on MAJOR.MINOR-SNAPSHOT, kuten 1.0-SNAPSHOT, missä SNAPSHOT viittaa siihen, että projekti on edelleen kehitysvaiheessa.
flavor	Valitse projekti flavor: webforj - Vakiomalli webforJ-sovellus. webforj-spring - webforJ-sovellus Spring Boot -tuella (vaatii webforJ 25.02 tai uudemman).
appName	Valinnainen parametri, jota voidaan käyttää generoituessa projektin POM-tiedostossa. Voidaan käyttää oletustittelinä sovellukselle käytetyn webforJ-archetypen mukaan.

Maven luo komennon suorittamisen jälkeen projektille tarvittavat tiedostot.

Sovelluksen ajaminen

Ennen sovelluksesi käynnistämistä asenna esivaatimukset, jos et ole vielä tehnyt niin. Siirry sitten projektin juurihakemistoon ja suorita seuraava komento:

# standardille webforj-sovellukselle
mvn jetty:run

# webforj + Spring Boot
mvn spring-boot:run

Kun palvelin on käynnissä, avaa selain ja siirry osoitteeseen http://localhost:8080 nähdäksesi sovelluksen.