Projektarbeit der Gruppe E zur Veranstaltung Client-Server Programmierung
von: Kajsa Heuer, Pascal Friedrichsen, Dominik Heckner, Fabian Petersen, Cedrik Hoffmann
Aus dem Projekt erfolgt ein Forum, wo ein User Beiträge erstellen und benatworten kann. Das Forum besitzt verschiedene Kategorien, in welche die Beitrage eingefügt werden. Der User kann einen Beitrag beantworten bzw. auch zu einer Antwort zu einem Beitrag einen Kommentar verfassen. Die Resgistrierung / Login erfolgt über eine Eingabemaske und ist der erste Anhaltspunkt, welche der User beim Aufruf der Seite sieht.
Ein Pflichtenheft wurde erstellt, welches die Anforderungen und weitere Informationen beinhaltet. siehe Pflichtenheft
Im folgenden werden die erforderlichen Schritte erläutert, um das Projekt erfolgreich zu testen. Dazu gehört eine auflistung der benötigten Komponenten, die erstellung der Datenbank, sowie das einspielen der Dummydaten.
Die Datei database.dmp ist ein Export unserer PostgreSQL Datenbank. Diese Datei enthält alle erforderlichen Tabellen und Einträge um das System zu testen.
Das Projekt wurde in IntelliJ entwickelt, daher folgt eine kurze einführung in IntelliJ, um das Projekt starten zu können.
Um das Projekt zum laufen zu bringen, müssen folgende Komponente auf dem Zielsystem vorhanden sein.
-
Application Server:
GlassFish 5.1.0 -
Datenbank:
PostgreSQL 14
Damit die Dump Datei mit den Dummydaten des Projektes erfolgreich eingespielt werden kann, muss zuerst die Datenbank erstellt werden. Damit die Angaben der persistence.xml zur Datenbank passen, ist es sinnvoll, die Datenbank wie folgt anzulegen:
CREATE DATABASE javaee_forum;
\connect javaee_forum;
create user javaee_forum_admin with password 'ultra_mega_secret_secure_password';
grant all on schema public to javaee_forum_admin;
alter schema public owner to javaee_forum_admin;Um die Datenbank zu befüllen, wird das von Postgres mitgelieferte Tool pg_restore benötigt. Die Datei kann nun wie folgt eingespielt werden:
pg_restore --host=localhost --dbname=javaee_forum --no-owner --role=javaee_forum_admin -U javaee_forum_admin ./database.dmp
NOTE: Unter Windows meistens unter C:\Program Files\PostgreSQL\14\bin\pg_restore.exe zu erreichen
Wird das Projekt zum ersten mal geöffnet, muss die Konfiguration für Glassfish noch erstellt werden.
Unter Settings → Build, Execute, Deployment → Application Servers wird der Glassfish hinzugefügt.
Eventuell muss die SDK angepasst werden. Dies kann unter File → Project Structure → Project Settings → Project SDK überprüft werden. Standard ist hier temurin-1.8
NOTE: Die SDK zwischen dem Projekt und Gradle muss die selbe sein. Gradle SDK kann wie folgt angepasst werden Settings → Build, Execute, Deployment → Build Tools → Gradle → Gradle JVM
-
Datenbank Dokumentation
-
REST Schnittstelle Dokumentation
-
Frontend Dokumentation