Project Setup
Om met deze tutorial te beginnen, heb je een locatie voor je project nodig waar je je klassen en middelen kunt beheren. De volgende secties beschrijven de verschillende manieren waarop je je webforJ-project voor deze tutorial kunt maken.
Gebruik de broncode
De eenvoudigste manier om deze tutorial te volgen, is door naar de broncode te verwijzen. Je kunt het hele project downloaden of het van GitHub klonen:
- Download ZIP: webforj-tutorial.zip
- GitHub Repository: Clone het project direct van GitHub
git clone https://github.com/webforj/webforj-tutorial.git
Projectstructuur
Het project heeft zes subdirectories, één voor elke stap van de tutorial, en elke bevat een uitvoerbare app. Volg along om te zien hoe de app vordert van een basisconfiguratie naar een volledig functioneel klantbeheersysteem.
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
Gebruik startforJ
Als je liever een nieuw project wilt maken, kun je startforJ gebruiken om een minimalistisch starterproject te genereren. Zie Aan de slag voor meer gedetailleerde informatie over het gebruik van startforJ.
- Kies in de dropdown webforJ versie de webforJ versie 26.00 of hoger.
- Kies in de dropdown Flavor voor webforJ + Spring Boot.
Gebruik de opdrachtregel
Je kunt ook een nieuw project genereren met de volgende opdracht:
- Bash/Zsh
- PowerShell
- Opdrachtprompt
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"
Configuraties
De twee genoemde manieren om een nieuw project te maken, gebruiken webforJ archetypes, die automatisch de benodigde configuraties aan je project toevoegen, zoals Spring afhankelijkheden aan je POM en de volgende eigenschappen in src/main/resources/application.properties:
spring.application.name=CustomerApplication
server.port=8080
webforj.entry = com.webforj.tutorial.Application
webforj.debug=true
De app uitvoeren
Om de app in actie te zien terwijl je de tutorial doorloopt:
-
Navigeer naar de directory voor de gewenste stap. Dit moet de bovenste level directory voor die stap zijn, waarin het
pom.xml-bestand zich bevindt. -
Gebruik de volgende Maven-opdracht om de Spring Boot-app lokaal uit te voeren:
mvn
De app uitvoeren opent automatisch een nieuwe browser op http://localhost:8080.