Overslaan naar hoofdinhoud

Project Setup

Openen in ChatGPT

Om 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 van de source code​

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:

git clone https://github.com/webforj/webforj-tutorial.git

Projectstructuur​

Het project heeft zes subdirectories, één voor elke stap van de tutorial, en elke map bevat een uitvoerbare app. Door mee te volgen, kun je zien hoe de app zich ontwikkelt van een basisopstelling 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 van startforJ​

Als je liever een nieuw project wilt maken, kun je startforJ gebruiken om een minimaal starterproject te genereren. Zie Aan de slag voor meer gedetailleerde informatie over het gebruik van startforJ.

Vereiste instellingen
  • Kies in de dropdown voor webforJ versie de webforJ versie 26.01 of hoger.
  • Kies in de dropdown voor Flavor webforJ + Spring Boot.

Gebruik van de commandoregel​

Je kunt ook een nieuw project genereren met de volgende opdracht:

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. Dit omvat Spring dependencies, de webforJ Maven-plugin die frontendbronnen bouwt en bewaakt, 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 door de tutorial vordert:

  1. Navigeer naar de directory voor de gewenste stap. Dit moet de bovenliggende directory voor die stap zijn, met de pom.xml.

  2. Gebruik de volgende Maven-opdracht om de Spring Boot-app lokaal uit te voeren:

    mvn

    De 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.