Skip to Content

Changes for page Basisprojekt

Last modified by mgrawunder on 2025/09/09 08:42
From version arrow_back 23.1 arrow_forward
edited by Marco Grawunder
on 2025/08/15 10:25
Change comment: There is no comment for this version
To version arrow_back 38.1 arrow_forward
edited by mgrawunder
on 2025/09/03 10:05
Change comment: There is no comment for this version

Summary

Details

insert_drive_file Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.MarcoGrawunder
1 +XWiki.mgrawunder
Content
... ... @@ -1,12 +1,15 @@
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 -Hier folgen Erklärungen des neuen Basisprojekts.
3 +Hier folgen Erklärungen des neuen Basisprojekts. Es wird um die folgenden Themen gehen:
4 4  
5 +{{toc/}}
5 5  
7 +
6 6  = Basisprojekt mit IntelliJ einrichten =
7 7  
8 8  [[image:1755245956916-184.png]]
9 9  
12 +== Clone ==
10 10  
11 11  [[image:1755245971657-468.png]]
12 12  
... ... @@ -17,6 +17,7 @@
17 17  
18 18  [[image:1755245996886-733.png]]
19 19  
23 +== Initialer Build (Generierung) ==
20 20  
21 21  [[image:1755246008466-477.png]]
22 22  
... ... @@ -24,15 +24,22 @@
24 24  [[image:1755246018789-616.png]]
25 25  
26 26  
31 +== Lombok Plugin ==
32 +
27 27  **Lombok Plugin installiert? Wenn nein jetzt machen**
28 28  
29 -**TODO: Zeigen**
35 +[[image:1755248508652-523.png]]
30 30  
37 +**Hinweis: Wenn man schon hier ist, kann man auch das Spring-(Boot)-Plugin **installieren
31 31  
39 +[[image:1756886220468-891.png]]
40 +
41 +== Server laufen lassen ==
42 +
32 32  [[image:1755246035428-328.png]]
33 33  
34 34  
35 -... und aktivieren (Man wird nach dem Start der Anwendung gefragt)
46 +... und ggf. Lombok aktivieren (Man wird nach dem Start der Anwendung gefragt)
36 36  
37 37  [[image:1755246072443-191.png]]
38 38  
... ... @@ -40,7 +40,7 @@
40 40  [[image:1755246118807-452.png]]
41 41  
42 42  
43 -Logging umstellen:
54 +== Logging umstellen ==
44 44  
45 45  [[image:1755246135109-325.png]]
46 46  
... ... @@ -50,14 +50,22 @@
50 50  
51 51  [[image:1755246162330-595.png]]
52 52  
64 +== Development Profil aktivieren ==
53 53  
66 +damit dann user1 - user9 angelegt werden und man nicht jedesmal neu registrieren muss
67 +
54 54  [[image:1755246173415-934.png]]
55 55  
56 56  
57 -**Wenn man IntelliJ nicht in der Pro-Version verwendet, muss kann man ein Spring-Profil über eine Umgebungsvariable in der Konfiguration des Servers setzen: **
71 +**Wenn man IntelliJ nicht in der Pro-Version verwendet bzw. das Spring Boot Plugin nicht installiert hat, muss kann man ein Spring-Profil über eine Umgebungsvariable in der Konfiguration des Servers setzen: **
58 58  
59 59  **SPRING_PROFILES_ACTIVE=dev**
60 60  
75 +[[image:1755248752596-839.png]]
76 +
77 +
78 +== Client starten ==
79 +
61 61  [[image:1755246257400-525.png]]
62 62  
63 63  
... ... @@ -67,9 +67,66 @@
67 67  [[image:1755246223246-834.png]]
68 68  
69 69  
89 +=== Mehrere Instanzen des Clients ermöglichen ===
90 +
70 70  [[image:1755246233218-893.png]]
71 71  
72 72  
94 +Wenn folgendes kommt, ist entweder das "dev" Profil nicht aktiviert, der Nutzer wurde nicht angelegt. Wenn der Server nicht läuft, gibt es eine andere Fehlermeldung.
95 +
73 73  [[image:1755246292057-581.png]]
74 74  
75 -[[image:1755246318433-327.png]]
98 +
99 += Kurzer Blick ins Basisprojekt =
100 +
101 +[[image:1755249096987-249.png]]
102 +
103 +
104 +[[image:1755249136156-419.png]]
105 +
106 +
107 +== Screenshots ==
108 +
109 +[[image:1755249228556-469.png]]
110 +
111 +
112 += Kommunikation Client ~-~-> Server =
113 +
114 +[[image:1755249285866-367.png]]
115 +
116 +Der Server verwendet das REST-Protokoll und als Austauschformat JSON
117 +
118 += OpenAPI =
119 +
120 +(Hinweis: Ich bin nicht sicher, ob IntelliJ diese Darstellung auch hat, wenn man nicht die Ultimate Version verwendet. Ggf. muss man das OpenAPI-Plugin installieren)
121 +
122 +[[image:1755250026156-269.png]]
123 +
124 +[[image:1755250050031-304.png]]
125 +
126 +* **Paths**: Endpunkte der API (z.B. /users, /lobbies).
127 +* **Operations**: Spezifikation von Methoden wie GET, POST.
128 +* **Definitions**: Detaillierte Beschreibung von Eingabe- und Ausgabestrukturen.
129 +* **Security**: Authentifizierungsmechanismen.
130 +
131 +[[image:1755250061990-172.png]]
132 +
133 +Kann JSON oder YAML (Yet Another Markup Language) verwenden YAML ist wie JSON nur mit weniger Klammern
134 +
135 +[[image:1755250157536-746.png]]
136 +
137 +Die aktuelle Version des OpenAPI Dokumentes findet sich im Basisprojekt 2 [[https:~~/~~/gitlab.swl.informatik.uni-oldenburg.de/SPB/SWPBasisprojekt2/-/blob/master/openapi.yaml?ref_type=heads>>https://gitlab.swl.informatik.uni-oldenburg.de/SPB/SWPBasisprojekt2/-/blob/master/openapi.yaml?ref_type=heads]]
138 +
139 +Dort wird die Datei auch grafisch dargestellt.
140 +
141 +
142 += Maven und OpenAPI =
143 +
144 +Die OpenAPI Datei kann verwendet werden, um sich die [[REST-Schnittstellen>>doc:||anchor="hErweiterungderREST-Schnittstelle"]] generieren  zu lassen.
145 +
146 +
147 +
148 +
149 += Erweiterung der REST-Schnittstelle =
150 +
151 +
attach_file 1755248508652-523.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.MarcoGrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +89.8 KB
Content info
attach_file 1755248752596-839.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.MarcoGrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +23.4 KB
Content info
attach_file 1755249096987-249.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.MarcoGrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +470.5 KB
Content info
attach_file 1755249136156-419.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.MarcoGrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +214.2 KB
Content info
attach_file 1755249228556-469.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.MarcoGrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +118.7 KB
Content info
attach_file 1755249285866-367.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.MarcoGrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +65.5 KB
Content info
attach_file 1755250026156-269.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.MarcoGrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +181.0 KB
Content info
attach_file 1755250050031-304.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.MarcoGrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +140.4 KB
Content info
attach_file 1755250061990-172.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.MarcoGrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +64.5 KB
Content info
attach_file 1755250157536-746.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.MarcoGrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +125.7 KB
Content info
attach_file 1756886220468-891.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.mgrawunder
Size
... ... @@ -1,0 +1,1 @@
1 +161.0 KB
Content info