Getting Started
Tämä artikkeli kuvaa vaiheet uuden webforJ-sovelluksen luomiseksi käyttäen webforJ archetypes. Archetypes tarjoavat esikonfiguroituja projektirakenteita ja aloituskoodia, joten voit saada projektin nopeasti toimintaan. Uuden webforJ-sovelluksen luomiseksi archetypesta voit käyttää startforJ tai komentoriviltä.
Ennen aloittamista, tarkista tarvittavat edellytykset webforJ:n asentamiseksi ja käytöksi.
Käyttäen startforJ
Yksinkertaisin tapa luoda uusi webforJ-sovellus on startforJ, joka luo minimialoitusprojektin valitun webforJ archetypen perusteella. Tämä aloitusprojekti sisältää kaikki tarvittavat riippuvuudet, konfigurointitiedostot ja valmiin asettelun, joten voit aloittaa sen kehittämisen heti.
Mukauttaminen startforJ:llä
Kun luot sovelluksen startforJ avulla, voit mukauttaa sitä antamalla seuraavat tiedot:
- Perusprojektin metatiedot (Sovelluksen nimi, Ryhmä-ID, Artefakti-ID)
- webforJ-versio ja Java-versio
- Teeman väri ja kuvake
- Archetype
- Flavor
Valittavana on kaksi flavor-vaihtoehtoa, joista "webforJ Only" on oletusarvo:
- webforJ Only: Vakiovesi webforJ-sovellus
- webforJ + Spring Boot: webforJ-sovellus, jossa on Spring Boot -tuki
webforJ tulee useiden ennalta määritettyjen archetypien kanssa auttaakseen sinua aloittamaan nopeasti. Täydellisen luettelon saatavilla olevista archetypeista löydät archetypes-katalogista.
Näiden tietojen avulla startforJ luo perusprojektin valitsemastasi archetypesta ja valitsemiesi mukautusten kanssa. Voit valita lataavasi projektisi ZIP-tiedostona tai julkaisevat 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.