Aloittaminen

Avaa ChatGPT:ssä

Tässä artikkelissa kuvataan vaiheet uuden webforJ-sovelluksen luomiseksi käyttämällä webforJ archetypeja. Archetypet tarjoavat valmiiksi määritettyjä projektirakenteita ja aloituskoodia, jotta voit saada projektin nopeasti käyntiin. Voit luoda uuden webforJ-sovelluksen archetypesta käyttämällä startforJ tai komentoriviä.

Edellytykset

Ennen aloitusta 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 valitsemallesi webforJ archetypelle. Tämä aloitusprojekti sisältää kaikki tarvittavat riippuvuudet, konfiguraatiotiedostot ja valmiin asettelun, jolloin voit alkaa rakentaa sen päälle heti.

Mukauttaminen startforJ:llä

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

Perusprojektin metadata (Sovelluksen nimi, Ryhmän ID, Artifact ID)
webforJ-versio ja Java-versio
Teeman väri ja ikoni
Archetype
Käyttöympäristö

Käyttöympäristö -valinta päättää, missä sovellus toimii, oletuksena Servlet-kontti:

Servlet-kontti: WAR Jettylle, Tomcatille tai muulle servlet-kontille
Spring Boot: suoritettavan JAR-tiedosto, jossa on upotettu palvelin
BBjServices: sovellus, joka toimii BBjServicesin kautta BBjShip

Saatavilla olevat archetypet

webforJ:ssa on useita ennalta määriteltyjä archetypeja, jotka auttavat sinua pääsemään nopeasti alkuun. Katso täydellinen luettelo saatavilla olevista archetypeista archetypet-katalogista.

Tämän tiedon avulla startforJ luo perusprojektin valitsemastasi archetypestä valitsemillasi mukautuksilla. Voit valita ladata projektisi ZIP-tiedostona tai julkaista 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: `webforj` - Vakiomalli webforJ-sovellus. `webforj-spring` 25.02- webforJ-sovellus Spring Boot -tuella. `webforj-bbj` 26.03- webforJ-sovellus, joka toimii BBjServices-palvelussa BBjShip-yhteyden kautta.
`appName`	Valinnainen parametri, jota voidaan käyttää generoituessa projektin POM-tiedostossa. Voidaan käyttää oletustittelinä sovellukselle käytetyn webforJ-archetypen mukaan.