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 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
... ... @@ -1,11 +1,7 @@
1 1  [[image:Main.Organisatorisches.WebHome@softwareprojekt_logo_transparent.png||alt="SoftwareprojektLogo.png" data-xwiki-image-style-alignment="end" height="136" width="309"]]
2 2  
3 3  {{info}}
4 -**Worum geht es auf dieser Seite?**
5 -
6 -Diese Seite erklärt den **Einstieg in das bereitgestellte Basisprojekt** und die darin verwendete Client-Server-Kommunikation. Behandelt werden insbesondere Einrichtung und Build, Spring, REST/OpenAPI, DTOs sowie WebSockets/STOMP.
7 -
8 -Das Basisprojekt verwendet mindestens **Java 21**. Screenshots können sich bei neueren Versionen optisch unterscheiden.
4 +Diese Seite erklärt den Einstieg in das bereitgestellte Basisprojekt und die darin verwendete Client-Server-Kommunikation. Das Basisprojekt verwendet mindestens **Java 21**. Screenshots der IDE oder von GitLab können sich bei neueren Versionen optisch unterscheiden; die beschriebenen Arbeitsschritte bleiben davon in der Regel unberührt.
9 9  {{/info}}
10 10  
11 11  {{toc/}}
... ... @@ -36,6 +36,7 @@
36 36  == Access Token ==
37 37  
38 38  {{expandable summary="Schritt-für-Schritt: Access Token einrichten"}}
35 +
39 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 41  [[image:1757398899497-714.png||height="246" width="278"]]
... ... @@ -54,15 +54,11 @@
54 54  
55 55  {{warning}}
56 56  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.**
57 -{{/warning}}
54 +{{/warning}}
58 58  
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  
62 -== SSH ==
63 -
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 -
66 66  == Nach dem Klonen ==
67 67  
68 68  sollten Sie einen Bildschirm ähnlich zu dem folgenden sehen:
... ... @@ -111,6 +111,7 @@
111 111  == Logging umstellen ==
112 112  
113 113  {{expandable summary="Schritt-für-Schritt: Logging konfigurieren"}}
107 +
114 114  Wenn man möchte, kann man das Logging umstellen.
115 115  
116 116  [[image:1755246135109-325.png]]
... ... @@ -125,6 +125,7 @@
125 125  == Development-Profil aktivieren ==
126 126  
127 127  {{expandable summary="Schritt-für-Schritt: Development-Profil aktivieren"}}
122 +
128 128  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.
129 129  
130 130  Wenn man die Anwendung einmal gestartet hat, kann man dies Configuration anpassen:
... ... @@ -163,6 +163,7 @@
163 163  === Mehrere Instanzen des Clients ermöglichen ===
164 164  
165 165  {{expandable summary="Schritt-für-Schritt: mehrere Client-Instanzen starten"}}
161 +
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,10 +198,6 @@
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  
201 -{{info}}
202 -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
203 -{{/info}}
204 -
205 205  [[image:1755250026156-269.png]]
206 206  
207 207  [[image:1755250050031-304.png]]
... ... @@ -252,6 +252,7 @@
252 252  = Erweiterung der REST-Schnittstelle =
253 253  
254 254  {{expandable summary="Ausführliches Beispiel: REST-Schnittstelle erweitern"}}
247 +
255 255  In diesem Beispiel wird einmal gezeigt, wie die REST-Schnittstelle des Basisprojektes einfach erweitert werden kann.
256 256  
257 257  In diesem Beispiel soll die aktuelle Schnittstelle um die Möglichkeit erweitert werden, alle Lobbies vom Server zu bekommen.
... ... @@ -419,6 +419,7 @@
419 419  * `/topic/users/loggedIn`: Ein Nutzer hat sich angemeldet.
420 420  * `/topic/users/loggedOut`: Ein Nutzer hat sich ausgeloggt.
421 421  
415 +
422 422  [[image:1756891125969-748.png||height="317" width="726"]]
423 423  
424 424  Topic-Namen sind Strings, sollten aber einem konsistenten fachlichen Namensschema folgen. Für Lobby-Ereignisse bietet sich entsprechend `/topic/lobbies/...` an.
... ... @@ -451,6 +451,7 @@
451 451  == Wie verbindet sich ein Client mit dem Server? ==
452 452  
453 453  {{expandable summary="Technische Details zum Verbindungsaufbau"}}
448 +
454 454  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.
455 455  
456 456  [[image:1756891512330-186.png||height="170" width="820"]]
... ... @@ -479,8 +479,4 @@
479 479  4) Jede Serververbindung hat eine Session
480 480  {{/expandable}}
481 481  
482 -= Siehe auch =
483 483  
484 -* [[Stichwortverzeichnis>>doc:Main.Index.WebHome]]
485 -* [[Glossar>>doc:Main.Glossar.WebHome]]
486 -* [[Basisprojekt FAQ>>doc:Main.Basisprojekt.Basisprojekt FAQ.WebHome]]
1792324965203-193.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.mgrawunder
Size
... ... @@ -1,1 +1,0 @@
1 -29.6 KB
Content