Skip to Content

Changes for page Basisprojekt

Last modified by Carl Welsch on 2026/10/23 16:19
From version 67.1
edited by Marco Grawunder
on 2026/10/18 14:02
Change comment: Uploaded new attachment "1792324965203-193.png", version {1}
To version 78.2
edited by Carl Welsch
on 2026/10/23 12:36
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,18 +36,30 @@
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"]]
42 42  
43 -Dort können Sie mit [[image:1757398947128-748.png||height="89" width="197"]] ein neues Token anlegen.
43 +Unter dem Bereich **Access** finden Sie den Unterbereich **Personal access token**.
44 44  
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.
45 +[[image:1792748661578-664.png||height="594" width="259"]]
46 46  
47 -[[image:1757399088336-273.png||height="92" width="547"]]
47 +Dort können Sie mit **Generate token** ein neues Token anlegen. Wählen Sie hier **Generate fine-grained token **aus.
48 48  
49 -Bei den Scopes sollten die beiden Rechte "read_repository" und "write_repository" gewählt werden.
49 +[[image:1792749012547-899.png||height="77" width="637"]]
50 50  
51 +Als Namen für den Token kann z. B. `IntelliJ` verwendet werden. Außerdem muss eine Beschreibung für den Token angelegt werden, wie bspw. "SWP Laptop Verbindung", welcher später zur Identifizierung des Tokes dient. Access Tokens sind aus Sicherheitsgründen zeitlich begrenzt. Wählen Sie ein Ablaufdatum, das zum Projektzeitraum passt. Anschließend wählen Sie unter **Group and project access **den Punkt **Only specific groups or projects I have access to** und wählen Ihre SWP-Gruppe aus.
52 +
53 +[[image:1792751550136-821.png||height="567" width="638"]]
54 +
55 +Bei **Resource Access** sollten die beiden Rechte "Code" und "Repository" gewählt werden.
56 +
57 +[[image:1792751165237-439.png||height="568" width="369"]]
58 +
59 +Anschließend müssen Sie
60 +
61 +[[image:1792751732971-755.png||height="471" width="610"]]
62 +
51 51  Danach wird das Access Token generiert
52 52  
53 53  [[image:1757399184270-348.png||height="99" width="978"]]
... ... @@ -63,6 +63,8 @@
63 63  
64 64  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:
65 65  
78 +[[image:1792324965203-193.png]]
79 +
66 66  == Nach dem Klonen ==
67 67  
68 68  sollten Sie einen Bildschirm ähnlich zu dem folgenden sehen:
... ... @@ -93,6 +93,29 @@
93 93  
94 94  [[image:1756886220468-891.png]]
95 95  
110 +== Probleme mit Maven oder IntelliJ ==
111 +
112 +Falls IntelliJ nach dem Klonen des Repositories nicht alle Abhängigkeiten oder Klassen erkennt, überprüfen Sie bitte folgende Punkte:
113 +
114 +1. **Java-Version:** Das Basisprojekt benötigt mindestens Java 21. Kontrollieren Sie mit java -version und mvn -version, welche Versionen verwendet werden.
115 +1. **IntelliJ-Projekt:** Öffnen Sie das gesamte Projekt mit der übergeordneten pom.xml, nicht nur das Server- oder Client-Verzeichnis.
116 +1. **Maven-Konfiguration:** Überprüfen Sie unter //Settings → Build Tools → Maven//, ob Maven mit einem passenden JDK ausgeführt wird.
117 +1. **Maven aktualisieren:** Öffnen Sie das Maven-Toolfenster und wählen Sie //Reload All Maven Projects//.
118 +1. (((
119 +**Projekt bauen:** Öffnen Sie ein Terminal im Hauptverzeichnis des Projekts und führen Sie folgenden Befehl aus:
120 +
121 +mvn -U clean install -DskipTests
122 +)))
123 +1. **Generierte Klassen:** Stellen Sie sicher, dass die durch OpenAPI generierten Java-Klassen unter target/generated-sources vorhanden sind und von IntelliJ erkannt werden.
124 +1. **Lombok:** Prüfen Sie, ob das Lombok-Plugin aktiviert ist und Annotation Processing korrekt funktioniert.
125 +1. **Server starten:** Starten Sie die Klasse ServerApp im Server-Modul. Überprüfen Sie bei Problemen die Java-Version und die Startkonfiguration.
126 +
127 +**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.
128 +
129 +Man kann auch versuchen, die Caches von IntelliJ einmal zu löschen: File → Invalidate Caches → Invalidate and Restart
130 +
131 +Falls es immer noch Problem gibt: Es gibt eine erweiterte Checkliste: [[Basisprojekt Checkliste>>doc:.Basisprojekt Checkliste.WebHome]]
132 +
96 96  == Server starten ==
97 97  
98 98  Den Serverbereich aufklappen und dort auf die Datei ServerApp mit der rechten Maustaste klicken.
... ... @@ -484,3 +484,6 @@
484 484  * [[Stichwortverzeichnis>>doc:Main.Index.WebHome]]
485 485  * [[Glossar>>doc:Main.Glossar.WebHome]]
486 486  * [[Basisprojekt FAQ>>doc:Main.Basisprojekt.Basisprojekt FAQ.WebHome]]
524 +* (((
525 +[[Basisprojekt Checkliste>>doc:.Basisprojekt Checkliste.WebHome]]
526 +)))
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
1792749012547-899.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.cwelsch
Size
... ... @@ -1,0 +1,1 @@
1 +46.3 KB
Content
1792750917132-904.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.cwelsch
Size
... ... @@ -1,0 +1,1 @@
1 +232.1 KB
Content
1792751165237-439.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.cwelsch
Size
... ... @@ -1,0 +1,1 @@
1 +164.3 KB
Content
1792751550136-821.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.cwelsch
Size
... ... @@ -1,0 +1,1 @@
1 +241.6 KB
Content
1792751732971-755.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.cwelsch
Size
... ... @@ -1,0 +1,1 @@
1 +144.2 KB
Content