Skip to Content

Changes for page Basisprojekt

Last modified by Carl Welsch on 2026/10/23 16:19
From version 80.2
edited by Carl Welsch
on 2026/10/23 16:19
Change comment: Auto-saved during real-time collaboration
To version 66.2
edited by Marco Grawunder
on 2026/10/18 14:02
Change comment: Auto-saved during real-time collaboration

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.cwelsch
1 +XWiki.mgrawunder
Content
... ... @@ -36,34 +36,22 @@
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 finden Sie in der Spalte links den Bereich **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 anschließend **Access tokens**.
40 40  
41 -[[image:1792748594897-686.png||height="305" width="258"]]
41 +[[image:1757398899497-714.png||height="246" width="278"]]
42 42  
43 -Unter dem Bereich **Access** finden Sie den Unterbereich **Personal access token**.
43 +Dort können Sie mit [[image:1757398947128-748.png||height="89" width="197"]] ein neues Token anlegen.
44 44  
45 -[[image:1792748661578-664.png||height="594" width="259"]]
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.
46 46  
47 -Dort können Sie mit **Generate token** ein neues Token anlegen. Wählen Sie hier** Legacy token **aus.
47 +[[image:1757399088336-273.png||height="92" width="547"]]
48 48  
49 -[[image:1792749012547-899.png||height="77" width="637"]]
49 +Bei den Scopes sollten die beiden Rechte "read_repository" und "write_repository" gewählt werden.
50 50  
51 -Als Namen für den Token kann z. B. `IntelliJ` verwendet werden. Access Tokens sind aus Sicherheitsgründen zeitlich begrenzt. Wählen Sie ein Ablaufdatum, das zum Projektzeitraum passt. Anschließend wählen Sie unter **Select Scopes **die Punkte read_user
51 +Danach wird das Access Token generiert
52 52  
53 -[[image:1792765084514-108.png||height="593" width="728"]]
53 +[[image:1757399184270-348.png||height="99" width="978"]]
54 54  
55 -Bei **Resource access** sollten unter **Repository** "Code" und "Repository" gewählt werden.
56 -
57 -[[image:1792751165237-439.png||height="568" width="369"]]
58 -
59 -Anschließend müssen Sie bei den Permissions setzen. Dafür wählen Sie bei Code "Download", "Push" und "Read". Für Repository wählen Sie "Create", "Delete", "Read" und "Update".
60 -
61 -[[image:1792751732971-755.png||height="471" width="610"]]
62 -
63 -Danach wird das Access Token generiert.
64 -
65 -[[image:1792751982493-740.png||height="153" width="779"]]
66 -
67 67  {{warning}}
68 68  Kopieren und speichern Sie das erzeugte Token unmittelbar. Es wird nach der Erstellung nicht erneut vollständig angezeigt. **Tokens dürfen niemals in das Repository eingecheckt werden.**
69 69  {{/warning}}
... ... @@ -75,8 +75,6 @@
75 75  
76 76  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:
77 77  
78 -[[image:1792324965203-193.png]]
79 -
80 80  == Nach dem Klonen ==
81 81  
82 82  sollten Sie einen Bildschirm ähnlich zu dem folgenden sehen:
... ... @@ -107,29 +107,6 @@
107 107  
108 108  [[image:1756886220468-891.png]]
109 109  
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 -
133 133  == Server starten ==
134 134  
135 135  Den Serverbereich aufklappen und dort auf die Datei ServerApp mit der rechten Maustaste klicken.
... ... @@ -521,6 +521,3 @@
521 521  * [[Stichwortverzeichnis>>doc:Main.Index.WebHome]]
522 522  * [[Glossar>>doc:Main.Glossar.WebHome]]
523 523  * [[Basisprojekt FAQ>>doc:Main.Basisprojekt.Basisprojekt FAQ.WebHome]]
524 -* (((
525 -[[Basisprojekt Checkliste>>doc:.Basisprojekt Checkliste.WebHome]]
526 -)))
1792324965203-193.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.mgrawunder
Size
... ... @@ -1,1 +1,0 @@
1 -29.6 KB
Content
1792748594897-686.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.cwelsch
Size
... ... @@ -1,1 +1,0 @@
1 -44.4 KB
Content
1792748661578-664.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.cwelsch
Size
... ... @@ -1,1 +1,0 @@
1 -92.0 KB
Content
1792749012547-899.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.cwelsch
Size
... ... @@ -1,1 +1,0 @@
1 -46.3 KB
Content
1792750917132-904.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.cwelsch
Size
... ... @@ -1,1 +1,0 @@
1 -232.1 KB
Content
1792751165237-439.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.cwelsch
Size
... ... @@ -1,1 +1,0 @@
1 -164.3 KB
Content
1792751550136-821.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.cwelsch
Size
... ... @@ -1,1 +1,0 @@
1 -241.6 KB
Content
1792751732971-755.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.cwelsch
Size
... ... @@ -1,1 +1,0 @@
1 -144.2 KB
Content
1792751982493-740.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.cwelsch
Size
... ... @@ -1,1 +1,0 @@
1 -72.0 KB
Content
1792765084514-108.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.cwelsch
Size
... ... @@ -1,1 +1,0 @@
1 -492.9 KB
Content