Project Setup
Aloittaaksesi tämän oppaan, tarvitset paikan projektiisi, jossa voit hallita luokkia ja resursseja. Seuraavissa osioissa kuvataan eri tapoja luoda webforJ-projekti tälle oppaalle.
Koodin käyttäminen
Helpoin tapa seurata tätä oppaata on viitata sen lähdekoodiin. Voit ladata koko projektin tai kloonata sen GitHubista:
- Lataa ZIP: webforj-tutorial.zip
- GitHub-repositorio: Kloonaa projekti suoraan GitHubista
git clone https://github.com/webforj/webforj-tutorial.git
Projektin rakenne
Projektissa on kuusi alikansiota, yksi jokaiselle oppaan vaiheelle, ja jokaisessa on suoritettava sovellus. Seuraamalla mukana voit nähdä, kuinka sovellus etenee perustason asetuksesta täysin toimivaksi asiakashallintajärjestelmäksi.
webforj-tutorial
│ .gitignore
│ LICENSE
│ README.md
│
├───1-creating-a-basic-app
├───2-working-with-data
├───3-routing-and-composites
├───4-observers-and-route-parameters
├───5-validating-and-binding-data
└───6-integrating-an-app-layout
Käyttämällä startforJ
Jos haluat mieluummin luoda uuden projektin, voit käyttää startforJ -työkalua luodaksesi minimaalisen aloitusprojektin. Katso Aloitus saadaksesi tarkempaa tietoa startforJ:n käytöstä.
- Valitse webforJ version -pudotusvalikosta webforJ versio 26.00 tai uudempi.
- Valitse Flavor -pudotusvalikosta webforJ + Spring Boot.
Komentorivin käyttäminen
Voit myös luoda uuden projektin seuraavalla komennolla:
- Bash/Zsh
- PowerShell
- Komentokehotte
mvn -B archetype:generate \
-DarchetypeGroupId=com.webforj \
-DarchetypeArtifactId=webforj-archetype-hello-world \
-DarchetypeVersion=LATEST \
-DgroupId=com.webforj.tutorial \
-DartifactId=customer-app \
-Dversion=1.0-SNAPSHOT \
-Dflavor=webforj-spring
mvn -B archetype:generate `
-DarchetypeGroupId="com.webforj" `
-DarchetypeArtifactId="webforj-archetype-hello-world" `
-DarchetypeVersion="LATEST" `
-DgroupId="com.webforj.tutorial" `
-DartifactId="customer-app" `
-Dversion="1.0-SNAPSHOT" `
-Dflavor="webforj-spring"
mvn -B archetype:generate ^
-DarchetypeGroupId="com.webforj" ^
-DarchetypeArtifactId="webforj-archetype-hello-world" ^
-DarchetypeVersion="LATEST" ^
-DgroupId="com.webforj.tutorial" ^
-DartifactId="customer-app" ^
-Dversion="1.0-SNAPSHOT" ^
-Dflavor="webforj-spring"
Konfiguraatiot
Kaksi mainittua tapaa luoda uusi projekti käyttää webforJ archetyyppien avulla, jotka automaattisesti lisäävät tarvittavat konfiguraatiot projektiisi, kuten Spring riippuvuudet POM-tiedostoon ja seuraavat ominaisuudet tiedostoon src/main/resources/application.properties:
spring.application.name=CustomerApplication
server.port=8080
webforj.entry = com.webforj.tutorial.Application
webforj.debug=true
Sovelluksen suorittaminen
Näet sovelluksen toiminnassa edetessäsi oppaan läpi:
-
Siirry halutun vaiheen hakemistoon. Tämän tulisi olla kyseisen vaiheen ylin hakemisto, jossa on
pom.xml. -
Käytä seuraavaa Maven-komentoa suorittaaksesi Spring Boot -sovelluksen paikallisesti:
mvn
Sovelluksen suorittaminen avaa automaattisesti uuden selaimen osoitteessa http://localhost:8080.