Programmiertechnik 1 - AIN/1
Wintersemester 2025/2026

Übungsaufgabe 6: HTML-Notenspiegel

1. Vorbereitung

   Nach dem Download und dem Entpacken von Aufgabe6.jar ist in Ihrem Arbeitsverzeichnis prog1-uebungen\ neben dieser Aufgabenstellung Aufgabe6.html noch ein Paketverzeichnis aufgabe6\ mit folgende Dateien hinzugekommen:

   aufgabe6\package-info.java	Paketdokumentation
   aufgabe6\HtmlNotenspiegel.java	vorgegebene Main-Klasse
   aufgabe6\Leistung.java	vorgegebene abstrakte Oberklasse
   aufgabe6\LeistungsListe.java	zu vervollständigende Klasse

   Das folgende UML-Diagramm gibt Ihnen einen Überblick über die vorgegebenen und die von Ihnen zu erstellenden Klassen:
   

   Öffnen Sie ein Terminal im Arbeitsverzeichnis prog1-uebungen\ und erweitern Sie Ihre HTML-Dokumentation um das Paket aufgabe6 mit dem Kommando

     ant doc

   Öffnen Sie dann die gewohnten Quellen im Browser:
   doc/aufgabe6/package-summary.html
   https://www-home.htwg-konstanz.de/~drachen/prog1/prog1.html
   https://docs.oracle.com/en/java/javase/21/docs/api/java.base/module-summary.html

   Als Voraussetzung für das Bearbeiten dieser Aufgabe sollten Sie die Vorlesungsunterlagen bis mindestens Seite 5-31 nachbereitet und die zugehörigen Programmbeispiele nachvollzogen haben, insbesondere vererbung\Datum.java, vererbung\Termin.java, vererbung\OrtsTermin.java, vererbung\TerminTest.java, local\IntList.java, local\ListVar.java

2. Programmierung der Klasse aufgabe6.Faecher

   Erstellen Sie im Paket aufgabe6 eine öffentliche Utility-Klasse Faecher mit folgenden Elementen:
   • einer privaten konstanten Klassenvariablen FAECHER vom Typ Array von Strings,
     die alle laut AIN-Studienplan des ersten Semesters erlaubten Fachnamen enthält
   • einer öffentlichen Klassenmethode istZulaessig,
     die prüft, ob ein gegebenes Fach im Studienplan vorgesehen ist.

     Leiten Sie die Signatur aus dem Aufruf der Methode in der vorgegebenen Klasse aufgabe6.Leistung ab.

3. Programmierung der Klasse aufgabe6.UnbenoteteLeistung

   Erstellen Sie im Paket aufgabe6 eine öffentliche instanziierbare Klasse UnbenoteteLeistung für Entitäten als Unterklasse von aufgabe6.Leistung:
   • die Klasse soll eine konstante private Instanzvariable haben, in der gespeichert ist, ob die Leistung bestanden ist oder nicht
   • die Klasse soll einen öffentlichen Konstruktor haben

     Leiten Sie die Signatur aus dem new-Ausdruck in der Klasse aufgabe6.HtmlNotenspiegel ab.

   • die Klasse muss geerbte Methoden überschreiben

     Welche das sind, können Sie der Javadoc-Beschreibung der vorgegebenen Oberklasse aufgabe6.Leistung entnehmen.

4. Programmierung der Klasse aufgabe6.BenoteteLeistung

   Erstellen Sie im Paket aufgabe6 eine öffentliche instanziierbare Klasse BenoteteLeistung für Entitäten als Unterklasse von aufgabe6.Leistung:
   • die Klasse soll eine konstante private Instanzvariable vom Typ aufgabe5.Note zum Speichern der Note haben.
   • die Klasse soll einen öffentlichen Konstruktor haben

     Leiten Sie die Signatur aus dem new-Ausdruck in der Klasse aufgabe6.HtmlNotenspiegel ab.

   • die Klasse muss geerbte Methoden überschreiben

     Welche das sind, können Sie der Javadoc-Beschreibung der vorgegebenen Oberklasse aufgabe6.Leistung entnehmen.

     Verwenden Sie die entsprechende Instanzmethode der Wertklasse aufgabe5.Note, um zu entscheiden, ob die gekapselte Note als bestanden gilt.

     Halten Sie sich außerdem an die folgenden Notennamen der HTWG:

     "sehr gut"	für Noten 1,0 bis 1,5 einschließlich
     "gut"	für Noten 1,6 bis 2,5 einschließlich
     "befriedigend"	für Noten 2,6 bis 3,5 einschließlich
     "ausreichend"	für Noten 3,6 bis 4,0 einschließlich
     "nicht ausreichend"	für Noten ab 4,1

5. Programmierung der Klasse aufgabe6.LeistungsListe

   Erstellen Sie im Paket aufgabe6 eine öffentliche instanziierbare Klasse LeistungsListe für Entitäten:
   • Verwenden Sie das Vorlesungsbeispiel local.IntList aus Teil 5 der Vorlesung als Vorlage. Passen Sie darin den Paket- und Klassennamen an, implementieren Sie die Schnittstelle java.util.Iterator<Leistung> statt java.util.Iterator<Integer> und stellen Sie den Typ der gespeicherten Werte von int auf Leistung um. Das Boxing in der Implementierung der next-Methode kann entfallen.

6. Programmierung der Klasse aufgabe6.HtmlFormat

   Erstellen Sie im Paket aufgabe6 eine öffentliche Utility-Klasse HtmlFormat mit einer öffentlichen Klassenmethode ausgeben:
   • Leiten Sie die Signatur der Klassenmethode aus dem Aufruf in aufgabe6.HtmlNotenspiegel.ausgeben ab.
   • Leiten Sie die Implementierung der Klassenmethode aus der Beispielausgabe in der Datei BennoBeispiel.html ab.

     Klicken Sie auf BennoBeispiel.html, um die formatierte Darstellung der Beispielausgabe zu sehen und wählen Sie im Kontextmenü des Browsers Seitenquelltext anzeigen, um die Beispielausgabe unformatiert zu sehen, so wie Sie vom Programm auszugeben ist.

     Verwenden Sie eine for-each-Schleife zum Ablaufen der übergebenen Leistungsliste und geben Sie den HTML-Text mit printf und println aus.

     Wenn Sie den Inhalt von BennoBeispiel.html etwas tiefer verstehen wollen, sind die folgenden Webseiten eine gute Hilfe:
     https://wiki.selfhtml.org
     https://www.w3schools.com/html/default.asp

7. Test und Qualitätssicherung

   • Übersetzen Sie das Programm:

       ant -Dpackage=aufgabe6 compile
     

     Andere Möglichkeiten zum Aufruf von javac sind bei Aufgabe 5 beschrieben.
   • Testen Sie das Programm mit verschiedenen Eingaben.
     Erstellen Sie dazu wieder Dateien mit Testeingaben im Stil von Aufgabe 3 und 4 (aufgabe6-in1.txt usw.) und betrachten Sie die Ausgabedateien mit dem Browser Firefox:

       java -ea aufgabe6.HtmlNotenspiegel Vorname Nachname
     

     Die Option -ea sorgt dafür, dass die assert-Regeln in Leistung ausgewertet werden.

     Verwenden Sie im Firefox auch rechte Maustaste->Seitenquelltext anzeigen, um Ihre HTML-Ausgabe zu prüfen.

   • Prüfen Sie mit checkstyle, ob Sie Stilregeln verletzt haben. Bessern Sie nach, solange das Werkzeug Fehler meldet.
     Rufen Sie checkstyle im Arbeitsverzeichnis über ant auf:

       ant -Dpackage=aufgabe6 style

   • Erstellen Sie Ihre endgültigen Javadoc-Seiten. Bessern Sie Ihre Javadoc-Kommentare nach, solange javadoc noch Fehler meldet:

       ant doc
     

   • Prüfen Sie mit spotbugs, ob Ihr Programm problematischen Code enthält. Bessern Sie nach, solange das Werkzeug Probleme meldet.
     Rufen Sie spotbugs im Arbeitsverzeichnis über ant auf:

       ant -Dpackage=aufgabe6 clean bugs

     spotbugs schreibt seine Meldungen nicht auf den Bildschirm, sondern in eine Datei bugs.html, die Sie mit einem Webbrowser anschauen müssen.

   Sie sind erst fertig, wenn das Programm funktioniert und die Werkzeuge checkstyle, javadoc und spotbugs keine Fehler mehr melden!

8. Abgabe

   Den spätesten Abgabetermin finden Sie auf der Webseite der Lehrveranstaltung https://www-home.htwg-konstanz.de/~drachen/prog1/prog1.html.
   

   Führen Sie Ihre in Schritt 7 erstellten Testfälle aufgabe6-in1.txt usw. vor und zeigen Sie die Notenspiegel im Browser.
   Zeigen Sie ihre Javadoc-Seiten mit dem verlinkten Quellcode der Klassen.
   Zeigen Sie das ausgefüllte Teilnahmeprotokoll.

Ergänzende Übungen für Schnellprogrammierer
freiwillig, pro Spiegelpunkt 1 Bonuspunkt

• Seit Java 15 gibt es zusätzlich zu den String-Literalen "..." auch Textblöcke in dreifachen Anführungszeichen """...""", die über mehrere Zeilen gehen können. Lesen Sie dazu https://docs.oracle.com/en/java/javase/15/text-blocks/ und nutzen Sie dann in Ihrer Klasse HtmlFormat Textblöcke, um die Ausgabe des HTML-Texts einfacher und übersichtlicher zu gestalten.
• Erstellen Sie eine Utility-Klasse TextFormat analog zu HtmlFormat, die einen Notenspiegel im tabellarischen Format nach dem Vorbild von Aufgabe 5 in einer Datei mit Endung .txt ausgibt. Bauen Sie die Verwendung der Klasse zusätzlich zu HtmlFormat in die Methode aufgabe6.HtmlNotenspiegel.ausgeben ein.
• Sorgen Sie dafür, dass in der verketteten Liste der Fachnoten keine Leistung doppelt vorkommt.

  Ändern Sie dazu LeistungsListe.insert so ab, dass nach dem Einfügen der neuen Leistung am Listenanfang in der restlichen Liste nach einer Leistung gesucht wird, bei der getFach und istBenotet denselben Wert wie bei der neuen Leistung liefern. Wird eine solche Leistung gefunden, soll Sie aus der Liste entfernt und mit return zurückgeliefert werden. Dazu müssen Sie den Rückgabetyp von LeistungsListe.insert auf Leistung ändern.

  An der Aufrufstelle in HtmlNotenspiegel.eingeben soll für jede Leistung, die aus der Liste entfernt wurde, eine Warnung ausgegeben werden.