Lokale Installatie

Openen in ChatGPT

Verouderd en zal worden verwijderd

De webforJ-plugin van de BBj Plugin Manager die op deze pagina wordt beschreven, is verouderd en zal in een toekomstige release worden verwijderd. Begin geen nieuwe projecten met deze plugin. Verplaats bestaande projecten naar BBjShip, dat webforJ-apps installeert, implementeert en uitvoert in BBjServices. Bestaande projecten vermeldt de wijzigingen die een project moet ondergaan.

Dit sectie van de documentatie behandelt de stappen die alleen vereist zijn voor gebruikers die webforJ willen gebruiken voor web- en/of app-ontwikkeling met een lokale BBj-instantie op hun machine. Deze installatie maakt het gebruikers niet mogelijk om bij te dragen aan de webforJ-fondscode zelf.

info

Deze handleiding behandelt de installatie op een Windows-systeem - de installatie stappen kunnen variëren voor Mac/Linux OS-apparaten.

De installatie zal worden onderverdeeld in de volgende stappen:

1. BBj downloaden en installeren
2. Gebruik maken van de BBj Plugin Manager om uw app te creëren
3. Uw app starten

Vereisten

Voordat u begint, zorg ervoor dat u de nodige vereisten hebt doorgenomen voor het instellen en gebruiken van webforJ. Dit zorgt ervoor dat u alle vereiste tools en configuraties hebt voordat u met uw project begint.

1. BBj downloaden en installeren

Wanneer u deze stap volgt, zorg ervoor dat u de BBj-versie installeert die overeenkomt met dezelfde webforJ-versie.

Deze video kan helpen bij de installatie van BBj als u hulp nodig heeft bij de setup. Het installatiegedeelte van de BASIS-website is te vinden via deze link

tip

Het wordt aanbevolen om de nieuwste stabiele revisie van BBj te gebruiken en "BBj" te selecteren uit de lijst met opties, zonder Barista of Addon.

2. Installeer en configureer de webforJ-plugin

Zodra BBj is geïnstalleerd, kan de Plugin Manager worden geopend om tools te installeren die nodig zijn om webforJ te configureren. Typ om te beginnen "Plugin Manager" in het startmenu of Finder.

Nadat de pluginmanager is geopend, navigeert u naar het tabblad "Beschikbare Plugins" bovenaan.

Selecteer in dit gedeelte het selectievakje "Toon versies onder ontwikkeling"

De DWCJ-invoer zou nu zichtbaar moeten zijn in de lijst met beschikbare plugins voor download. Klik op deze invoer in de lijst om deze te selecteren.

Met de DWCJ-invoer geselecteerd, klikt u op de knop "Installeren".

Zodra de plugin is geïnstalleerd, klikt u op het tabblad "Geïnstalleerde Plugins" bovenaan.

Dit tabblad toont de geïnstalleerde plugins, die nu de DWCJ-invoer moeten bevatten. Klik op de invoer binnen de lijst.

Met de DWCJ-invoer geselecteerd, klikt u op de knop "Configureer".

In het geopende venster, klikt u op de knop "Remote Install Maven inschakelen" linksonder in het venster.

tip

U kunt ook navigeren naar de bin map binnen uw bbx map en de volgende opdracht uitvoeren:

./bbj -tIO DWCJ/cli.bbj - enable_remote_install

Een dialoogvenster moet verschijnen waarin staat dat de externe installatie is ingeschakeld. Klik op "OK" om dit dialoogvenster te sluiten.

3. Gebruik het starterproject

Zodra BBj en de vereiste webforJ-plugin zijn geïnstalleerd en geconfigureerd, kunt u een nieuw, gestructureerd project maken vanuit de opdrachtregel. Dit project wordt geleverd met de nodige tools om uw eerste webforJ-programma uit te voeren.

Om een nieuw bbj-hello-world project te creëren en te scaffolden, volg deze stappen:

1. Navigeer naar de juiste map: Open een terminal en ga naar de map waar je je nieuwe project wilt maken.
2. 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

mvn -B archetype:generate \
-DarchetypeGroupId=com.webforj \
-DarchetypeArtifactId=webforj-archetype-bbj-hello-world \
-DarchetypeVersion=LATEST \
-DgroupId=org.example \
-DartifactId=my-app \
-Dversion=1.0-SNAPSHOT \
-DappName=MyApp

PowerShell

mvn -B archetype:generate `
-DarchetypeGroupId="com.webforj" `
-DarchetypeArtifactId="webforj-archetype-bbj-hello-world" `
-DarchetypeVersion="LATEST" `
-DgroupId="org.example" `
-DartifactId="my-app" `
-Dversion="1.0-SNAPSHOT" `
-DappName="MyApp"

Command Prompt

mvn -B archetype:generate ^
-DarchetypeGroupId="com.webforj" ^
-DarchetypeArtifactId="webforj-archetype-bbj-hello-world" ^
-DarchetypeVersion="LATEST" ^
-DgroupId="org.example" ^
-DartifactId="my-app" ^
-Dversion="1.0-SNAPSHOT" ^
-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.
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.

4. De app starten

Zodra dit is gedaan, voert u een mvn install uit in uw projectdirectory. Dit zal de webforJ-installatieplugin uitvoeren en u in staat stellen om toegang te krijgen tot uw app. Om de app te zien, gaat u naar de volgende URL:

http://localhost:YourHostPort/webapp/YourPublishName

Vervang YourHostPort door de Host-poort die u met Docker heeft geconfigureerd, en YourPublishName wordt vervangen door de tekst binnen het <publishname>-tag van de POM. Als het correct is gedaan, zou u uw app moeten zien renderen.