Getting Started

Avaa ChatGPT:ssä

Tämä artikkeli kuvaa vaiheet uuden webforJ-sovelluksen luomiseksi käyttäen webforJ archetypes. Archetypes tarjoavat valmiiksi konfiguroituja projektirakenteita ja aloituskoodia, jotta voit saada projektin nopeasti käyntiin. Uuden webforJ-sovelluksen luomiseksi archetypesta voit käyttää startforJ tai komentoriviltä.

Esivaatimukset

Ennen kuin aloitat, tarkista tarvittavat esivaatimukset webforJ:n asentamiselle ja käytölle.

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 vaaditut riippuvuudet, konfigurointitiedostot ja valmiin asettelun, joten voit aloittaa rakentamisen heti.

Mukauttaminen startforJ:n avulla

Kun luot sovelluksen startforJ:n avulla, voit mukauttaa sitä antamalla seuraavat tiedot:

• Perusprojektin metatiedot (Sovelluksen nimi, Ryhmätunnus, Artefaktitunnus)
• webforJ-versio ja Java-versio
• Teeman väri ja kuvake
• Archetype
• Flavor

Valittavana on kaksi makuvalintaa, joista "webforJ Only" on oletus:

• webforJ Only: Tavanomainen webforJ-sovellus
• webforJ + Spring Boot: webforJ-sovellus Spring Boot -tuen kanssa

Spring Boot -tuki

Spring Boot -maku on saatavilla vain webforJ-versiossa 25.02 ja korkeammissa. Jos valitset tämän vaihtoehdon, varmista, että valitset yhteensopivan version.

Saatavilla olevat Archetypes

webforJ sisältää useita ennalta määriteltyjä archetypeja, jotka auttavat sinua pääsemään nopeasti alkuun. Saat täydellisen luettelon saatavilla olevista archetypeista, katso archetypes-luettelo.

Käyttäen näitä tietoja, startforJ luo perustason projektin valitsemastasi archetypesta tehdyillä mukautuksilla. Voit valita projektisi lataamisen ZIP-tiedostona tai julkaista sen suoraan GitHubiin.

Kun olet ladannut projektisi, avaa projektikansio IDE:ssäsi ja siirry vaiheeseen sovelluksen suorittaminen.

Käyttäen komentoriviä

Jos suosittelet komentorivin käyttöä, voit luoda projektin suoraan käyttäen Maven archetypea:

Luodaksesi ja rakentaaksesi uuden hello-world-projektin, seuraa näitä vaiheita:

1. Siirry oikeaan hakemistoon: Avaa terminaali ja siirry kansioon, johon haluat luoda uuden projektisi.
2. Suorita archetype:generate-komento: Käytä alla olevaa Maven-komentoa ja mukauta groupId, artifactId ja version projektisi tarpeiden mukaan.

Bash/Zsh

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

PowerShell

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"

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"

Argumentti	Selitys
archetypeGroupId	Arkityypin ryhmätunnus: com.webforJ
archetypeArtifactId	Määrittää käytettävän arkkityypin nimen.
archetypeVersion	Määritä arkkityypin versio. LATEST valitsee uusimman version.
groupId	Edustaa luodun projektin nimiavaruutta. Tyypillisesti rakennettu Java-paketin tapaan, kuten org.example, ja sitä käytetään organisaatiosi tai projektialueesi yksilölliseen tunnistamiseen.
artifactId	Määrittää luodun projektin nimen. Tästä tulee tuloksena olevan artefaktin ja projektikansion nimi.
version	Määritä versionumero (MAJOR.MIINOR-SNAPSHOT, esim. 1.0-SNAPSHOT).
flavor	Valitsee projektin variantin: webforj - Vakio webforJ-sovellus. webforj-spring - webforJ-sovellus Spring Boot -tuella (vaatii webforJ 25.02 tai uudemman).
appName	Valinnainen parametri, jota voidaan käyttää luodun projektin POM-tiedostossa. Käytetyn webforJ-arkkityypin mukaan sitä voidaan käyttää sovelluksen oletusotsikkona.

Komennon suorittamisen jälkeen Maven luo projektin suorittamiseen tarvittavat projektitiedostot.

Sovelluksen suorittaminen

Ennen kuin suoritat sovelluksesi, asenna esivaatimukset, jos et ole vielä tehnyt niin. Siirry sitten projektin juurikansioon ja suorita seuraava komento:

# tavanomaiselle webforj-sovellukselle
mvn jetty:run

# webforj + Spring Boot -sovellukselle
mvn spring-boot:run

Kun palvelin on käynnissä, avaa selain ja siirry osoitteeseen http://localhost:8080 nähdäksesi sovelluksen.

Lisensointi ja vesileima

Tietoa käyttämättömissä projekteissa olevasta vesileimasta, katso Lisensointi ja vesileima.