bic_summenrechner

1 Anlegen des Projektes

1.1 Neu in IntelliJ erstellen

1.1.1 Neues Projekt anlegen
1.1.2 Auswahl Spring Boot und einstellen der gewünschten Parameter (Java Version, JDK, etc.)
1.1.3 Hinzufügen der gewünschten Dependencies (z.B. Spring Boot Web)
1.1.4 Weiter klicken, etwaige Meldungen akzeptieren und das Project builden und ausführen

1.2 In IntelliJ importieren

1.2.1 Neues Prokt von existierenden Quellen erstellen
1.2.2 Richtiges Buildtool auswählen (in unserem Fall Maven)
1.2.3 Projekt importieren, Meldungen akzeptieren
1.2.4 Neuen "Run/Debug" Schritt hinzufügen

1.2.5 Spring Boot Konfiguration hinzufügen
1.2.5.1 Richtige Java Version einstellen
1.2.5.2 Klasse mit der main Methode auswählen
1.2.6 Speichern und die Konfiguration mit dem grünen Pfeil starten
1.2.7 Spring Boot Application sollte jetzt starten

1.3 Projekt mittels Spring Initilizr erstellen

1.3.1 Projekt mit gewünschten Eigenschaften und Abhängigen via Spring Initilizr erstellen und herunterladen
1.3.2 Wie in [Abschnitt 1.2](#1.2 In IntelliJ importieren) beschrieben ein neues Projekt aus den Source Files erstellen

2 Summenrechner Klasse erstellen

2.0.1 Im src Ordner eine neue Klasse für den Summenrechner erstellen
2.0.2 Klasse implementieren

2.1 Tests hinzufügen

2.1.1 Im test Ordner eine neue Klasse für die Summenrechnertest erstellen 2.1.2 Tests hinzufügen

Tipps zur Namenskonvetion von Testfällen
Tests mehrmal mit verschiedenen Parametern durchführen

2.2 Tests ausführen

2.2.1 Maven Menü öffnen
2.2.2 Doppelklick auf test unter Lifecycle

3.1 SummenrechnerController Klasse erstellen

3.1.1 Im src Ordner eine neue Klasse erstellen
3.1.2 Klasse implementieren

3.2 Tests hinzufügen

3.2.1 Im test Ordner eine neue Klasse erstellen
3.2.2 Tests implementieren
3.2.3 Tests ausführen

4 API via Insomnia testen

Um APIs lokal zu testen gibt es diverse Programme, die dazu dienen können. Das bekannteste ist wohl Postman. Im Rahmen der Lehrveranstaltung wurde Insomnia verwendet.

Bitte verwendet in der Zukunft ein Tool, dass euren Anforderungen gerecht wird. Es hat alles seine Vor- und Nachteile.

4.1 Spring Boot Project starten
4.2 Schnittstelle mithilfe des Programms testen

5 Projekt auf Github pushen

5.1 Upstream Reposity einstellen

git remote add origin UrlZumGitubRepository.git

git push -u -f origin main

5.2 Mergen Feature -> Development -> Release -> Main

5.2.1 Letzte Änderungen auf dem Feature Branch committen

git commit -m "Finished basic summenrechner feature" 

Siehe Tipps fuer commit Messages

5.2.2 Den Feature auf den development branch mergen

git checkout development

5.2.3 Einen Release Branch erstellen

git checkout -b release/basic_summenrechner

5.2.4 Auf Main Branch mergen

git checkout main

git merge release/basic_summenrechner

5.2.5 Release taggen

git tag -a v1.0.0 -m "bic_summenrechner v1.0.0"

5.2.6 Änderungen pushen

git push origin

git push origin --tags