Getting Started
Tässä artikkelissa kuvataan vaiheet uuden webforJ-sovelluksen luomiseksi käyttäen webforJ archetypseja. Archetypit tarjoavat esikonfiguroituja projektiarkkitehtuureja ja aloituskoodia, jotta voit saada projektin nopeasti toimintaan. Uuden webforJ-sovelluksen luomiseksi archetypestä voit käyttää startforJ tai komentorivikäskyä.
Ennen kuin aloitat, tarkista tarvittavat edellytykset webforJ:n määritykselle ja käytölle.
Käyttäminen startforJ
Yksinkertaisin tapa luoda uusi webforJ-sovellus on startforJ, joka luo minimaalisen aloitusprojektin valitun webforJ-archetyypin perusteella. Tämä aloitusprojekti sisältää kaikki vaatimukset, määritystiedostot ja valmiiksi tehdyn asettelun, jotta voit alkaa työstämään sitä heti.
Mukauttaminen startforJ:n avulla
Kun luot sovellusta startforJ avulla, voit mukauttaa sitä antamalla seuraavat tiedot:
- Perusprojekti metadata (Sovelluksen nimi, Ryhmä ID, Artefakti ID)
- webforJ-versio ja Java-versio
- Teeman väri ja ikoni
- 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
webforJ:ssä on useita ennakkoon määriteltyjä archetyyppejä, joiden avulla pääset käynnistämään nopeasti. Täydellisen luettelon saatavilla olevista archetypeista löydät archetypes-katalogista.
Näiden tietojen avulla startforJ luo perusprojektin valitsemastasi archetypestä valitsemillasi mukautuksilla. Voit valita projektisi lataamisen ZIP-tiedostona tai julkaista sen suoraan GitHubiin.
Kun olet ladannut projektisi, avaa projektikansio IDE:ssäsi.
Käyttäminen komentoriviltä
Jos suosittelet komentorivipohjaista työskentelyä, voit luoda projektin suoraan käyttämällä Maven-archetypeta:
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.