Getting Started
Tässä artikkelissa kuvataan vaiheet uuden webforJ-sovelluksen luomiseksi käyttäen webforJ archetypeseja. Archetypet tarjoavat esikonfiguroituja projektirakenteita ja aloituskoodia, jotta voit saada projektin nopeasti toimimaan. Voit luoda uuden webforJ-sovelluksen archetypestä käyttämällä startforJ tai komentoriviä.
Ennen kuin aloitat, tarkista tarvittavat edellytykset webforJ:n asentamiseksi ja käyttämiseksi.
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 tarvittavat riippuvuudet, konfigurointitiedostot ja valmiin ulkoasun, jotta voit aloittaa rakentamisen heti.
Mukauttaminen startforJ:llä
Kun luot sovellusta startforJ avulla, voit mukauttaa sitä antamalla seuraavat tiedot:
- Perusprojektin metatiedot (Sovelluksen nimi, Ryhmätunnus, Artefaktitunnus)
- webforJ-versio ja Java-versio
- Teema väri ja kuvake
- Archetype
- Maku
Valittavissa on kaksi makuvaihtoehtoa, joista "webforJ Only" on oletus:
- webforJ Only: Standardi webforJ-sovellus
- webforJ + Spring Boot: webforJ-sovellus Spring Boot -tuella
webforJ sisältää useita esimäärättyjä archetypeseja, jotka auttavat sinua aloittamaan nopeasti. Saat täydellisen luettelon saatavilla olevista archetypeseista, katso archetype-katalogi.
Tämän tiedon avulla startforJ luo perusprojektin valitsemastasi archetypestä valitsemiesi mukautusten kanssa. Voit valita projektisi lataamisen ZIP-tiedostona tai julkaista sen suoraan GitHubiin.
Kun olet ladannut projektisi, avaa projektikansio IDE:ssäsi ja siirry eteenpäin sovelluksen suorittamiseen.
Käyttäen komentoriviä
Jos mieluummin käytät 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.