Der Worttrainer ist eine Anwendung für Volksschulkinder, die das richtige Schreiben von Wörtern anhand von Bildern üben können. Zu einem angezeigten Bild (über eine URL eingebunden) wird das entsprechende Wort geraten. Die Eingabe wird dann mit der korrekten Schreibweise verglichen und eine Erfolgsmeldung wird angezeigt.
- Speichern von Wort-Bild-Paaren (über URLs verknüpfte Bilder)
- Zufällige Auswahl eines Wort-Bild-Paars zum Üben
- Benutzer gibt das entsprechende Wort ein, das mit der richtigen Schreibweise verglichen wird
- Statistiken über die Anzahl der Versuche und richtig/falsch beantwortete Wörter
- Grafische Oberfläche mit
JOptionPane
zur Anzeige von Bildern, Statistik und Eingabeaufforderung - Persistierung der Worttrainer-Session (Wort-Bild-Paare, aktuelle Statistik) in einer JSON-Datei
Die Entwicklung wurde vollständig in einem Git-Repository dokumentiert und mit Gradle als Build-System durchgeführt. Der Entwicklungsprozess folgte einem Feature-basierten Ansatz:
- Entwurf: Zu jedem Feature wurde zuerst das UML-Diagramm angepasst.
- Implementierung: Jedes Feature wurde nacheinander implementiert.
- Tests: Automatisierte Tests wurden mit JUnit geschrieben, um die Funktionalität der Anwendung sicherzustellen.
- Dokumentation: Der Code wurde ausführlich mit Javadoc kommentiert.
- Java: Die gesamte Anwendung wurde in Java entwickelt.
- Gradle: Als Build-System und für die Abhängigkeiten.
- JUnit: Für Unit-Tests zur Überprüfung der Code-Funktionalität.
- Gson: Für die JSON-Persistierung und -Deserialisierung von Wort-Bild-Paaren.
- JOptionPane: Für die grafische Oberfläche (Dialoge für Eingabe und Anzeige von Bildern/Statistiken).
src/main/java
: Enthält den Java-Code der Anwendungsrc/test/java
: Enthält Unit-Tests für den Worttrainerbuild.gradle
: Gradle-Build-Datei mit allen AbhängigkeitenREADME.md
: Diese Dokumentation
-
Projekt klonen: Klone das Repository auf dein lokales System.
git clone https://github.com/TGM-HIT/sew9-2425-worttrainer-<github-username>
-
Gradle-Build ausführen: Verwende Gradle, um das Projekt zu bauen und Tests auszuführen.
./gradlew build
-
Programm starten: Führe die Anwendung aus, indem du die
Main
-Klasse startest. Das Programm lädt entweder die persistierten Daten oder startet eine neue Sitzung mit einigen vorgegebenen Wort-Bild-Paaren. -
Testen: Um die Unit-Tests auszuführen, verwende:
./gradlew test