HelloWorld archetype
Dit archetype maakt een eenvoudige hello world-app om de basisprincipes van het bouwen van een UI met webforJ te demonstreren. Deze sjabloon is geweldig voor beginners om snel aan de slag te gaan. Het biedt een eenvoudig voorbeeld van hoe je een basis webforJ-app kunt opzetten en uitvoeren, waardoor het een uitstekend startpunt is voor nieuwe ontwikkelaars.
Dit archetype creëert een minimalistische app met een paar componenten en wat styling. Voor ontwikkelaars die een project met minimale scaffolding willen maken, zie het blank archetype.
Voor meer controle over aanpassingen en configuratie kun je startforJ gebruiken om je project te maken - selecteer eenvoudig het HelloWorld archetype bij het kiezen van configuratieopties.
Using the hello-world archetype
Om een nieuw hello-world project te creëren en te scaffolden, volg deze stappen:
- Navigeer naar de juiste map: Open een terminal en ga naar de map waar je je nieuwe project wilt maken.
- Voer het archetype:generate commando uit: Gebruik de onderstaande Maven-opdracht en pas groupId, artifactId en versie aan zoals nodig voor jouw project.
- 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"
| Argumenten | Uitleg |
|---|---|
archetypeGroupId | De groeps-ID van de archetype is com.webforj voor webforJ archetypes. |
archetypeArtifactId | Geeft de naam van het te gebruiken archetype op. |
archetypeVersion | Geeft de versie van de archetype op die gebruikt moet worden. Dit zorgt ervoor dat het gegenereerde project compatibel is met een specifieke versie van de archetype. Het gebruik van LATEST selecteert de meest recente beschikbare versie. |
groupId | Geeft de naamruimte voor het gegenereerde project weer. Typisch gestructureerd als een Java-pakket, zoals org.example, en wordt gebruikt om uw organisatie of projectdomein uniek te identificeren. |
artifactId | Geeft de naam op van het gegenereerde project. Dit zal de naam zijn van het resulterende artifact en de projectmap. |
version | Definieert de versie van het gegenereerde project. Een gangbare conventie is MAJOR.MINOR-SNAPSHOT, zoals 1.0-SNAPSHOT, waarbij SNAPSHOT aangeeft dat het project nog in ontwikkeling is. |
flavor | Selecteer een projectvariant:
|
appName | Een optionele parameter die kan worden gebruikt in het POM-bestand van het gegenereerde project. Afhankelijk van de gebruikte webforJ-archetype kan het worden gebruikt als een standaardtitel voor de applicatie. |
Na het uitvoeren van de opdracht genereert Maven de projectbestanden die nodig zijn om het project uit te voeren.
Running the app
Before running your app, install the prerequisites if you haven't yet. Then, navigate to the project's root directory and run the following command:
mvn
The shorthand mvn command works because the archetype's POM file includes a <defaultGoal> configuration that automatically runs the appropriate goal for your project type. If your project doesn't have <defaultGoal>, run the following:
# for a standard webforJ app
mvn jetty:run
# for a webforJ + Spring Boot app
mvn spring-boot:run
Once the server is running, open your browser and go to http://localhost:8080 to view the app.