Skip to Content

Changes for page Basisprojekt

Last modified by Marco Grawunder on 2026/09/08 10:20
From version 63.1
edited by Marco Grawunder
on 2026/08/25 15:36
Change comment: There is no comment for this version
To version 64.1
edited by Marco Grawunder
on 2026/08/25 16:31
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -31,6 +31,8 @@
31 31  
32 32  == Access Token ==
33 33  
34 +{{expandable summary="Schritt-für-Schritt: Access Token einrichten"}}
35 +
34 34  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**.
35 35  
36 36  [[image:1757398899497-714.png||height="246" width="278"]]
... ... @@ -51,9 +51,9 @@
51 51  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.**
52 52  {{/warning}}
53 53  
54 -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.
56 +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.
57 +{{/expandable}}
55 55  
56 -
57 57  == Nach dem Klonen ==
58 58  
59 59  sollten Sie einen Bildschirm ähnlich zu dem folgenden sehen:
... ... @@ -101,6 +101,8 @@
101 101  
102 102  == Logging umstellen ==
103 103  
106 +{{expandable summary="Schritt-für-Schritt: Logging konfigurieren"}}
107 +
104 104  Wenn man möchte, kann man das Logging umstellen.
105 105  
106 106  [[image:1755246135109-325.png]]
... ... @@ -110,9 +110,12 @@
110 110  
111 111  
112 112  [[image:1755246162330-595.png]]
117 +{{/expandable}}
113 113  
114 114  == Development-Profil aktivieren ==
115 115  
121 +{{expandable summary="Schritt-für-Schritt: Development-Profil aktivieren"}}
122 +
116 116  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.
117 117  
118 118  Wenn man die Anwendung einmal gestartet hat, kann man dies Configuration anpassen:
... ... @@ -129,6 +129,7 @@
129 129  [[image:1755248752596-839.png]]
130 130  
131 131  Danach muss man den Server neu starten!
139 +{{/expandable}}
132 132  
133 133  == Client starten ==
134 134  
... ... @@ -149,6 +149,8 @@
149 149  
150 150  === Mehrere Instanzen des Clients ermöglichen ===
151 151  
160 +{{expandable summary="Schritt-für-Schritt: mehrere Client-Instanzen starten"}}
161 +
152 152  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.
153 153  
154 154  [[image:1755246233218-893.png]]
... ... @@ -157,8 +157,8 @@
157 157  Falls die Anmeldung eines vorbereiteten Testnutzers fehlschlägt, prüfen Sie insbesondere, ob das `dev`-Profil aktiv ist und der Benutzer angelegt wurde. Läuft der Server nicht, erscheint in der Regel eine andere Fehlermeldung.
158 158  
159 159  [[image:1755246292057-581.png]]
170 +{{/expandable}}
160 160  
161 -
162 162  = Überblick über das Basisprojekt =
163 163  
164 164  [[image:1755249096987-249.png]]
... ... @@ -233,6 +233,8 @@
233 233  
234 234  = Erweiterung der REST-Schnittstelle =
235 235  
246 +{{expandable summary="Ausführliches Beispiel: REST-Schnittstelle erweitern"}}
247 +
236 236  In diesem Beispiel wird einmal gezeigt, wie die REST-Schnittstelle des Basisprojektes einfach erweitert werden kann.
237 237  
238 238  In diesem Beispiel soll die aktuelle Schnittstelle um die Möglichkeit erweitert werden, alle Lobbies vom Server zu bekommen.
... ... @@ -352,8 +352,8 @@
352 352  [[image:1756890010118-149.png||height="116" width="972"]]
353 353  
354 354  Anmerkung: Obwohl DefaultApi alle Funktionen zum Server kapselt, sollte man im Client spezifische Services für bestimmte Bereich haben, die diese Klasse verwenden.  Das führt zu einer besseren Trennung von Funktionalitäten im Code.
367 +{{/expandable}}
355 355  
356 -
357 357  = Asynchrone Kommunikation zum Client: WebSockets =
358 358  
359 359  [[image:1756890800817-370.png||height="604" width="1121"]]
... ... @@ -432,6 +432,8 @@
432 432  
433 433  == Wie verbindet sich ein Client mit dem Server? ==
434 434  
447 +{{expandable summary="Technische Details zum Verbindungsaufbau"}}
448 +
435 435  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.
436 436  
437 437  [[image:1756891512330-186.png||height="170" width="820"]]
... ... @@ -458,3 +458,6 @@
458 458  3) Über den Kontext ein Event pushen LoggedInEvent
459 459  
460 460  4) Jede Serververbindung hat eine Session
475 +{{/expandable}}
476 +
477 +