Skip to Content

Changes for page Basisprojekt

Last modified by Carl Welsch on 2026/10/23 16:19
From version 66.1
edited by Marco Grawunder
on 2026/09/08 10:20
Change comment: There is no comment for this version
To version 73.2
edited by Carl Welsch
on 2026/10/23 11:44
Change comment: Auto-saved during real-time collaboration

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.mgrawunder
1 +XWiki.cwelsch
Content
... ... @@ -36,10 +36,12 @@
36 36  == Access Token ==
37 37  
38 38  {{expandable summary="Schritt-für-Schritt: Access Token einrichten"}}
39 -Beim ersten Git-Zugriff über HTTPS werden Zugangsdaten benötigt. Statt des normalen Passworts sollte ein persönlicher **Access Token** verwendet werden. Öffnen Sie dazu Ihr Profilbild, wählen Sie **Edit profile** und anschließend **Access tokens**.
39 +Beim ersten Git-Zugriff über HTTPS werden Zugangsdaten benötigt. Statt des normalen Passworts sollte ein persönlicher **Access Token** verwendet werden. Öffnen Sie dazu Ihr Profilbild, wählen Sie **Edit profile** und finden Sie in der Spalte links den Bereich **Access tokens**.
40 40  
41 -[[image:1757398899497-714.png||height="246" width="278"]]
41 +[[image:1792748594897-686.png||height="305" width="258"]] <~-~- Edit Profile
42 42  
43 +[[image:1792748661578-664.png]]
44 +
43 43  Dort können Sie mit [[image:1757398947128-748.png||height="89" width="197"]] ein neues Token anlegen.
44 44  
45 45  Als Namen kann z. B. `IntelliJ` verwendet werden. Access Tokens sind aus Sicherheitsgründen zeitlich begrenzt. Wählen Sie ein Ablaufdatum, das zum Projektzeitraum passt.
... ... @@ -59,6 +59,12 @@
59 59  Beim **Einloggen **(Achtung! Gemeint ist hier, wenn Intellij (bzw. git) nach den Account-Daten beim Clonen fragt. Man kann auch einen Gitlab-Account hinterlegen (der dann aber parallel existiert). Hier für ist es wichtig, dass noch "api" und "read_user" als Recht vergeben wird.) in IntelliJ können Sie dieses Token im Passwort-Feld verwenden. Geben Sie ihren Account bei Name ein.
60 60  {{/expandable}}
61 61  
64 +== SSH ==
65 +
66 +Hinweis: Man kann jetzt auch mit SSH clonen. Da gitlab aber hinter einem Reverseproxy liegt, geht das nur mit der direkten Adresse des Host:  vmisdata07.uni-oldenburg.de. Ist nun auch in Gitlab zu konfiguriert:
67 +
68 +[[image:1792324965203-193.png]]
69 +
62 62  == Nach dem Klonen ==
63 63  
64 64  sollten Sie einen Bildschirm ähnlich zu dem folgenden sehen:
... ... @@ -89,6 +89,29 @@
89 89  
90 90  [[image:1756886220468-891.png]]
91 91  
100 +== Probleme mit Maven oder IntelliJ ==
101 +
102 +Falls IntelliJ nach dem Klonen des Repositories nicht alle Abhängigkeiten oder Klassen erkennt, überprüfen Sie bitte folgende Punkte:
103 +
104 +1. **Java-Version:** Das Basisprojekt benötigt mindestens Java 21. Kontrollieren Sie mit java -version und mvn -version, welche Versionen verwendet werden.
105 +1. **IntelliJ-Projekt:** Öffnen Sie das gesamte Projekt mit der übergeordneten pom.xml, nicht nur das Server- oder Client-Verzeichnis.
106 +1. **Maven-Konfiguration:** Überprüfen Sie unter //Settings → Build Tools → Maven//, ob Maven mit einem passenden JDK ausgeführt wird.
107 +1. **Maven aktualisieren:** Öffnen Sie das Maven-Toolfenster und wählen Sie //Reload All Maven Projects//.
108 +1. (((
109 +**Projekt bauen:** Öffnen Sie ein Terminal im Hauptverzeichnis des Projekts und führen Sie folgenden Befehl aus:
110 +
111 +mvn -U clean install -DskipTests
112 +)))
113 +1. **Generierte Klassen:** Stellen Sie sicher, dass die durch OpenAPI generierten Java-Klassen unter target/generated-sources vorhanden sind und von IntelliJ erkannt werden.
114 +1. **Lombok:** Prüfen Sie, ob das Lombok-Plugin aktiviert ist und Annotation Processing korrekt funktioniert.
115 +1. **Server starten:** Starten Sie die Klasse ServerApp im Server-Modul. Überprüfen Sie bei Problemen die Java-Version und die Startkonfiguration.
116 +
117 +**Hinweis:** Wenn Maven im Terminal erfolgreich durchläuft, IntelliJ aber weiterhin Fehler anzeigt, liegt das Problem häufig an der IntelliJ-Projektkonfiguration und nicht an den Abhängigkeiten selbst.
118 +
119 +Man kann auch versuchen, die Caches von IntelliJ einmal zu löschen: File → Invalidate Caches → Invalidate and Restart
120 +
121 +Falls es immer noch Problem gibt: Es gibt eine erweiterte Checkliste: [[Basisprojekt Checkliste>>doc:.Basisprojekt Checkliste.WebHome]]
122 +
92 92  == Server starten ==
93 93  
94 94  Den Serverbereich aufklappen und dort auf die Datei ServerApp mit der rechten Maustaste klicken.
... ... @@ -480,3 +480,6 @@
480 480  * [[Stichwortverzeichnis>>doc:Main.Index.WebHome]]
481 481  * [[Glossar>>doc:Main.Glossar.WebHome]]
482 482  * [[Basisprojekt FAQ>>doc:Main.Basisprojekt.Basisprojekt FAQ.WebHome]]
514 +* (((
515 +[[Basisprojekt Checkliste>>doc:.Basisprojekt Checkliste.WebHome]]
516 +)))
1792324965203-193.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.mgrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +29.6 KB
Content
1792748594897-686.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.cwelsch
Size
... ... @@ -1,0 +1,1 @@
1 +44.4 KB
Content
1792748661578-664.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.cwelsch
Size
... ... @@ -1,0 +1,1 @@
1 +92.0 KB
Content