Getting Started
Tämä artikkeli kuvaa vaiheet uuden webforJ-sovelluksen luomiseksi käyttämällä webforJ archetypes. Archetypes tarjoavat esikonfiguroituja projektirakenteita ja aloituskoodia, jotta voit saada projektin nopeasti toimimaan. Uuden webforJ-sovelluksen luomiseksi archetypesta voit käyttää startforJ tai komentoriviä.
Ennen kuin aloitat, tarkista tarvittavat esivaatimukset webforJ:n asentamiseen ja käyttöön.
Käyttäen startforJ
Yksinkertaisin tapa luoda uusi webforJ-sovellus on startforJ, joka luo minimaalisen aloitusprojektin valitun webforJ archetypen perusteella. Tämä aloitusprojekti sisältää kaikki vaadittavat riippuvuudet, konfiguraatiotiedostot ja valmiin asettelun, jotta voit aloittaa rakentamisen heti.
Mukauttaminen startforJ:llä
Kun luot sovelluksen startforJ avulla, voit mukauttaa sitä antamalla seuraavat tiedot:
- Perusprojektin metatiedot (Sovelluksen nimi, Ryhmän tunnus, Artefaktin tunnus)
- webforJ-versio ja Java-versio
- Teeman väri ja kuvake
- Archetype
- Flavor
Valittavana on kaksi makuvaihtoehtoa, joista "webforJ Only" on oletus:
- webforJ Only: Vakioprojekti webforJ:llä
- webforJ + Spring Boot: webforJ-sovellus Spring Boot -tukea varten
webforJ tulee useiden ennalta määriteltyjen archetyppien kanssa auttaakseen sinua pääsemään nopeasti alkuun. Täydellisen luettelon saatavilla olevista archetyypeistä katso archetypes-katalogista.
Tämän tiedon avulla startforJ luo perustason projektin valitsemastasi archetypesta valitsemillasi mukautuksilla. Voit valita ladattavaksi projektisi ZIP-tiedostona tai julkaista sen suoraan GitHubiin.
Kun olet ladannut projektisi, avaa projektikansio IDE:ssäsi.
Käyttäen komentoriviä
Jos haluat käyttää komentoriviä, voit luoda projektin suoraan käyttämällä Maven archetypea:
Luo ja rakenna uusi hello-world projekti seuraamalla näitä vaiheita:
- Siirry oikeaan hakemistoon: Avaa pääte ja siirry kansioon, johon haluat luoda uuden projektin.
- Suorita komento: archetype:generate: Käytä alla olevaa Maven-komentoa ja mukauta groupId, artifactId ja versio tarpeidesi mukaan.
- 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"
| 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:
|
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.
Running the app
Before running your app, install the prerequisites if you haven't yet. Then, navigate to the project's root directory and run the following command:
mvn
The shorthand mvn command works because the archetype's POM file includes a <defaultGoal> configuration that automatically runs the appropriate goal for your project type. If your project doesn't have <defaultGoal>, run the following:
# for a standard webforJ app
mvn jetty:run
# for a webforJ + Spring Boot app
mvn spring-boot:run
Once the server is running, open your browser and go to http://localhost:8080 to view the app.
