Overslaan naar hoofdinhoud

Project Setup

Openen in ChatGPT

Om deze tutorial te beginnen, hebt u een locatie voor uw project nodig waar u uw klassen en middelen kunt beheren. De volgende secties beschrijven de verschillende manieren waarop u uw webforJ-project voor deze tutorial kunt aanmaken.

Gebruik van de broncode​

De eenvoudigste manier om deze tutorial te volgen, is door te verwijzen naar de broncode. U kunt het hele project downloaden of het clonen vanuit GitHub:

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

Projectstructuur​

Het project heeft vijf subdirectory's, één voor elke stap van de tutorial, en elke bevat een uitvoerbare app. Door mee 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

Gebruik van startforJ​

Als u liever een nieuw project wilt aanmaken, kunt u startforJ gebruiken om een minimale starterproject te genereren. Zie Aan de slag voor meer gedetailleerde informatie over het gebruik van startforJ.

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

Gebruik van de opdrachtregel​

U 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 uw project toevoegen, zoals Spring afhankelijkheden aan uw 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 u door de tutorial voortschrijdt:

  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 app uitvoeren opent automatisch een nieuwe browser op http://localhost:8080.