Projectconfiguratie
Om deze tutorial te beginnen, heeft u een locatie nodig voor uw project waar u uw klassen en bronnen kunt beheren. De volgende secties beschrijven de verschillende manieren waarop u uw webforJ-project voor deze tutorial kunt maken.
Gebruik van de broncode
De eenvoudigste manier om deze tutorial te volgen, is door naar de broncode te verwijzen. U kunt het gehele 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. Door deze stappen te volgen, kunt u zien hoe de app evolueert van een basisopstelling naar een volledig functioneel klantenbeheersysteem.
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 van startforJ
Als u liever een nieuw project maakt, kunt u startforJ gebruiken om een minimaal startproject te genereren. Zie Aan de slag voor meer gedetailleerde informatie over het gebruik van startforJ.
- Kies in de dropdown webforJ versie de versie 26.01 of hoger.
- Kies onder Runs on voor Spring Boot.
Gebruik van de opdrachtregel
U 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 creëren, maken gebruik van webforJ archetypes, die automatisch de benodigde configuraties aan uw project toevoegen. Dit omvat Spring afhankelijkheden, de webforJ Maven-plugin die de frontendbronnen bouwt en in de gaten houdt, 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 u door de tutorial vordert:
-
Navigeer naar de directory voor de gewenste stap. Dit moet de bovenste directory voor die stap zijn, die de
pom.xmlbevat. -
Gebruik de volgende Maven-opdracht om de Spring Boot-app lokaal uit te voeren:
mvnDe gegenereerde POM configureert deze standaardopdracht om de app te compileren, de webforJ frontend-watcher te starten en Spring Boot uit te voeren.
Running the app automatically opens a new browser at http://localhost:8080.
Blijf leren
ArtikelCursor Spring Boot UI: Let the Assistant Write Your Screens in Java
ArtikelStarting a New Java Project: The Decisions That Shape the Stack
ArtikelHow to build a web app in Java, step by step
ArtikelMCP server for Java developers: webforJ setup guide
ArtikelJava web app tutorial for beginners: build your first app