Changes for page Basisprojekt

Last modified by Marco Grawunder on 2026/09/08 10:20

From version 65.1
edited by Marco Grawunder
on 2026/08/26 10:13
Change comment: There is no comment for this version
To version 66.1
edited by Marco Grawunder
on 2026/09/08 10:20
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -36,7 +36,6 @@
36 36  == Access Token ==
37 37  
38 38  {{expandable summary="Schritt-für-Schritt: Access Token einrichten"}}
39 -
40 40  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**.
41 41  
42 42  [[image:1757398899497-714.png||height="246" width="278"]]
... ... @@ -55,7 +55,7 @@
55 55  
56 56  {{warning}}
57 57  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.**
58 -{{/warning}}
57 +{{/warning}}
59 59  
60 60  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.
61 61  {{/expandable}}
... ... @@ -108,7 +108,6 @@
108 108  == Logging umstellen ==
109 109  
110 110  {{expandable summary="Schritt-für-Schritt: Logging konfigurieren"}}
111 -
112 112  Wenn man möchte, kann man das Logging umstellen.
113 113  
114 114  [[image:1755246135109-325.png]]
... ... @@ -123,7 +123,6 @@
123 123  == Development-Profil aktivieren ==
124 124  
125 125  {{expandable summary="Schritt-für-Schritt: Development-Profil aktivieren"}}
126 -
127 127  Für lokale Tests existiert das Spring-Profil `dev`. Darin werden automatisch vorbereitete Testnutzer (`user1` bis `user9`) angelegt, sodass nicht für jeden Testlauf neue Konten registriert werden müssen.
128 128  
129 129  Wenn man die Anwendung einmal gestartet hat, kann man dies Configuration anpassen:
... ... @@ -162,7 +162,6 @@
162 162  === Mehrere Instanzen des Clients ermöglichen ===
163 163  
164 164  {{expandable summary="Schritt-für-Schritt: mehrere Client-Instanzen starten"}}
165 -
166 166  Standardmäßig erlaubt IntelliJ nicht das Starten mehrerer Clients. Man könnte nun mehrere Configurations für den Client anlegen. Man kann aber auch in der Konfiguration unter "Modify options" den Haken bei "Allow multiple instances" setzen. Dann kann eine beliebige Anzahl von Clients gestartet werden.
167 167  
168 168  [[image:1755246233218-893.png]]
... ... @@ -198,6 +198,10 @@
198 198  Die grafische OpenAPI-Darstellung hängt von der verwendeten IntelliJ-Edition und den installierten Plugins ab. Falls sie nicht verfügbar ist, kann ein geeignetes OpenAPI-Plugin installiert werden.
199 199  {{/info}}
200 200  
197 +{{info}}
198 +Es gibt (als Beta-Version) ein Plugin für IntelliJ mit dem die Berbeitung, gerade zu Anfang hoffentlich etwas einfacher funktioniert. Zu finden ist das Plugin hier: https://swl.informatik.uni-oldenburg.de/swp/downloads/openapi/ (Achtung! Muss von der Platte installiert werden. Siehe https://www.jetbrains.com/help/idea/managing-plugins.html#install_plugin_from_disk
199 +{{/info}}
200 +
201 201  [[image:1755250026156-269.png]]
202 202  
203 203  [[image:1755250050031-304.png]]
... ... @@ -248,7 +248,6 @@
248 248  = Erweiterung der REST-Schnittstelle =
249 249  
250 250  {{expandable summary="Ausführliches Beispiel: REST-Schnittstelle erweitern"}}
251 -
252 252  In diesem Beispiel wird einmal gezeigt, wie die REST-Schnittstelle des Basisprojektes einfach erweitert werden kann.
253 253  
254 254  In diesem Beispiel soll die aktuelle Schnittstelle um die Möglichkeit erweitert werden, alle Lobbies vom Server zu bekommen.
... ... @@ -416,7 +416,6 @@
416 416  * `/topic/users/loggedIn`: Ein Nutzer hat sich angemeldet.
417 417  * `/topic/users/loggedOut`: Ein Nutzer hat sich ausgeloggt.
418 418  
419 -
420 420  [[image:1756891125969-748.png||height="317" width="726"]]
421 421  
422 422  Topic-Namen sind Strings, sollten aber einem konsistenten fachlichen Namensschema folgen. Für Lobby-Ereignisse bietet sich entsprechend `/topic/lobbies/...` an.
... ... @@ -449,7 +449,6 @@
449 449  == Wie verbindet sich ein Client mit dem Server? ==
450 450  
451 451  {{expandable summary="Technische Details zum Verbindungsaufbau"}}
452 -
453 453  Der `UserService` bietet die Anmeldung an. Im Basisprojekt erfolgt sie beim Aufbau der WebSocket-/STOMP-Verbindung; die Zugangsdaten werden dabei über die bestehende Sicherheitskonfiguration geprüft.
454 454  
455 455  [[image:1756891512330-186.png||height="170" width="820"]]
... ... @@ -483,4 +483,3 @@
483 483  * [[Stichwortverzeichnis>>doc:Main.Index.WebHome]]
484 484  * [[Glossar>>doc:Main.Glossar.WebHome]]
485 485  * [[Basisprojekt FAQ>>doc:Main.Basisprojekt.Basisprojekt FAQ.WebHome]]
486 -