Fachgebiet Informationssysteme Prof. Dr.-Ing. N. Fuhr. Programmierung Prof. Dr.-Ing. Nobert Fuhr. Programmierprojekt

Transkript

1 Gudrun Fischer Sascha Kriewel Abgabe: 10. Februar, 23:59 Programmierprojekt Formalia Das Projekt zur Vorlesung ist eine praktische Programmieraufgabe, die einzeln bearbeitet werden soll. Gruppenabgaben werden nicht berücksichtigt. Für die Bearbeitung des Projektes sind insgesamt bis zu 40 Punkte zu erreichen. In der Woche vom 21. bis zum 25. Februar werden die Projekte dann einzeln abgenommen. Bei der Projektabnahme solltest du deinen Code erklären können, um die erreichten Punkte zu halten. Bei sehr gutem Resultat der Abnahme kann die erreichte Punktzahl auch verbessert werden. Einen genauen Termin für die Abnahme erhältst du von uns per und Aushang. Ohne Abnahme wird das Projekt mit 0 Punkten bewertet! Prüfe deswegen jetzt schon, ob du in der angegebenen Woche Terminprobleme haben könntest, und melde dich bei Problemen bei programmierung@is.informatik.uni-duisburg.de Die Punkte aus dem Projekt ergeben zusammen mit den Klausurpunkten und etwaigen Bonuspunkten aus den Testaten die Gesamtpunktzahl, aus der sich die Note errechnet. Bitte beachte in jedem Fall die folgenden Dinge bei deiner Abgabe: Eine Abgabe, deren Quellcode nicht kompiliert, wird grundsätzlich mit 0 Punkten bewertet. Gib also keinen ungetesteten Quellcode ab. Halte dich an die Code Konventionen, wie sie in der Vorlesung vorgestellt wurden. Für nicht eingehaltene Code Konventionen werden bis zu 10 Punkte abgezogen. Achte auf eine sinnvolle Fehlerbehandlung. Das Programm soll robust laufen, und in Fehlersituationen soll der Anwender erfahren, wo das Problem liegt, ohne dass das Programm abstürzt. Für eine ungenügende Fehlerbehandlung werden Punkte abgezogen. Kommentiere dein Programm im javadoc Format und erstelle daraus eine entsprechende javadoc Dokumentation. Jede Klasse, jede Instanz und Klassenvariable, und jede Methode gehört einzeln kommentiert. Außerdem solltest du innerhalb des Codes die wesentlichen Stellen so kommentieren, Seite 1 von 6

2 dass wir nachvollziehen können, was der Code wo tut. Für fehlende Kommentare gibt es einen Abzug von bis zu 20 Punkten. Packe den Quellcode, die kompilierten Klassen und die javadoc Dokumentation in eine ausführbare jar Datei mit dem Namen projekt<matrikelnummer>.jar. Das bedeutet u.a., dass man dein Programm durch den Aufruf java -jar projekt<matrikelnummer>.jar ausführen können soll. Schicke die jar Datei als Anhang an die Adresse Schreibe in den Betreff der Projekt und deine Matrikelnummer. Bitte pro Abgabe nur eine . In die , sowie als Kommentar in jede Quelldatei gehören dein Name, deine Matrikelnummer und deine -Adresse. Bitte denke unbedingt daran, da wir sonst die Abgabe nicht zuordnen können. Ohne Matrikelnummern im Programmkommentar gibt es keine Punkte. Abgabeschluss ist am 10. Februar 2005 um 23:59. Es zählt der Zeitpunkt des Eingangs. Seite 2 von 6

3 Ein einfacher MP3 Spieler In diesem Projekt soll ein MP3 Spieler mit grafischer Oberfläche und Filterfunktion entwickelt werden. Teil 1: GUI (8 Punkte) Die grafische Benutzeroberfläche soll auf dem Playlist Betrachter aus dem zweiten Testat aufbauen. Als Ausgangspunkt für deine Projektlösung kannst du deine eigene Lösung aus Testat 2 verwenden, oder die entsprechende Musterlösung, oder etwas eigenes entwickeln. (Dafür gibt es allerdings noch keine Punkte.) Zusätzlich zu den Funktionen aus dem zweiten Testat soll die grafische Benutzeroberfläche noch Folgendes bieten: Einen Menüeintrag (bei den anderen Sortierungsoptionen) zur Neuordnung der aktuellen Playlist in zufälliger Reihenfolge. Funktionalität: Wählt der Benutzer diesen Menüeintrag aus, so soll die Methode randomize (siehe Teil 2) der aktuellen Playlist aufgerufen und danach die Anzeige aktualisiert werden. Behelf: Wenn du die Methode randomize nicht implementiert hast, so gib wenigstens eine Meldung über System.err aus, dass nun randomize aufgerufen würde. Ein Texteingabefeld oberhalb der Listendarstellung (also direkt unterhalb des Menüs), um eine Filterbedingung einzugeben. Funktionalität: Gibt der Benutzer in diesem Feld eine Filterbedingung ein, so soll die aktuelle Playlist anhand dieser Bedingung gefiltert dargestellt werden. Die aktuelle Sortierung soll dabei beibehalten werden. Verwende zum Filtern die Methode evaluate aus Teil 3. Wenn der Filter aus dem Textfeld gelöscht wird, so soll wieder die ungefilterte Liste erscheinen. Wird eine Liste gefiltert angezeigt, und wählt der Benutzer dann Abspeichern, so soll die gefilterte Liste abgespeichert und zur aktuellen Liste werden. Immer, wenn eine neue Liste angezeigt wird (also nach Laden oder Abspeichern), soll die Filterbedingung zunächst leer sein. Behelf: Falls du die Methode evaluate aus Teil 3 nicht implementiert hast, so gib wenigstens eine Meldung über System.err aus, wann immer evaluate aufgerufen würde (und mit welchen Parametern es aufgerufen würde). In dem Fall schreibe bitte auch eine Meldung an System.err, sobald die Seite 3 von 6

4 Liste wieder ungefiltert angezeigt würde. Außerdem sollen drei Knöpfe mit folgender Funktionalität in die Oberfläche integriert werden: Abspielen der aktuellen Playlist Überspringen des aktuell gespielten Titels (Nächster Titel) Abspielen beenden Funktionalität: Hier sollen die Methoden play, skip und stopplayback aus Teil 4 aufgerufen werden. Behelf: Wenn du die Funktionen aus Teil 4 nicht implementiert hast, dann schreibe wenigstens bei jedem Knopfdruck eine möglichst aussagekräftige Meldung nach System.err. Teil 2: Operationen auf MP3 Playlists 14 Punkte In der aktuellen Musterlösung zu Testat 2 modelliert die Klasse Playlist eine Playlist, die aus einer M3U Datei eingelesen werden kann und Informationen über MP3 Dateien enthält. Leite von dieser Klasse Playlist eine Klasse MP3List ab (Vererbung), die zusätzlich die folgenden Methoden besitzt: public MP3List randomize() Gibt eine neue MP3List zurück, die dieselben Einträge wie die aktuelle MP3List enthält, jedoch in einer zufälligen neuen Reihenfolge. public MP3List findtext(string text) Gibt eine neue MP3List zurück, die genau die MP3File Objekte aus dem aktuellen Objekt enthält, wo in Interpret, Titel oder Dateiname die Zeichenkette text auftaucht. public MP3List subtract(mp3list other) Gibt eine neue MP3List zurück, die genau diejenigen Einträge aus dem aktuellen Objekt enthält, die nicht in der Vergleichsliste other enthalten sind. public MP3List merge(mp3list other) Gibt eine neue MP3List zurück, die alle Einträge aus der aktuellen Liste und zusätzlich die Einträge aus other enthält. Die neue Liste soll keine Duplikate enthalten. public MP3List intersect(mp3list other) Gibt eine neue MP3List zurück, die alle Einträge enthält, die sowohl in der aktuellen Liste, als auch in der Vergleichsliste other enthalten sind. Verwende für Playlist die Implementierung aus der Musterlösung zu Testat 2 und verändere sie nicht. Im Gesamtwerkzeug soll nun anstelle von Playlist die Klasse MP3List zum Einsatz kommen. Seite 4 von 6

5 Teil 3: Suchanfragen für MP3 Playlists 10 Punkte Erstelle eine Klasse MP3Query zum rekursiven Aufbauen eines Anfragebaums aus einer Zeichenkette. Eine Anfrage soll dabei durch einen Baum aus MP3Query Objekten repräsentiert werden, so wie eine Anfrage im ersten Testat durch einen Baum aus QueryNode Objekten repräsentiert wurde. Die Regeln für die Anfrage sollen dabei ebenfalls dieselben sein wie im ersten Testat. Du kannst deine Klasse MP3Query von QueryNode erben lassen, oder dich bei der Implementierung an QueryNode orientieren. (Für die Funktionalität von QueryNode alleine gibt es noch keine Punkte!) Zusätzlich soll MP3Query eine öffentlich sichtbare Methode MP3List evaluate(mp3list list) besitzen, die eine MP3List namens list nimmt und eine neue MP3List zurückliefert, welche genau diejenigen Einträge aus list enthält, welche der aktuellen Anfrage entsprechen. Zur Verdeutlichung: Interpretiere die in Teil 2 implementierten Methoden auf MP3List wie folgt: Wenn man eine Anfrage q nach einem Term t und eine MP3List l hat, dann entspricht die Auswertung von q auf l dem Aufruf von l.findtext(t). Entsprechend liefert subtract die Verneinung einer Anfrage. Schliesslich können merge und intersect benutzt werden, um OR und AND auszuwerten. Die Auswertung komplexerer Anfragen ergibt sich durch Rekursion. Falls du dabei MP3Query von QueryNode ableiten möchtest, verwende dazu die Implementierung aus der Musterlösung des ersten Testats und verändere sie nicht. Teil 4: Abspielen von Playlists 8 Punkte Sobald eine Playlist geladen ist, gibt es ein aktuelles Lied. Am Anfang sei dies das erste Stück auf der Liste. Mit diesem Hintergrund soll nun folgende Funktionalität umgesetzt werden: Wird Abspielen gedrückt, so wird das aktuelle Lied abgespielt, danach wird automatisch das nächste Lied der Liste zum aktuellen Lied, dieses wird ebenfalls abgespielt, usw. Schreibe eine Methode protected void play() die das leistet. Der Abspielen beenden Knopf beendet das Abspielen des aktuellen Liedes sofort, egal an welcher Stelle des Stückes man gerade ist. Schreibe für diese Funktionalität eine Methode protected void stopplayback() Der Überspringen Knopf schließlich beendet das Abspielen des aktuellen Liedes ebenfalls sofort, macht aber zusätzlich den nächsten Eintrag zum aktuellen Lied und spielt dieses ab. Vom letzten Eintrag der Liste aus springt man dabei wieder zum ersten Lied. Schreibe eine entsprechende Seite 5 von 6

6 Methode protected void skip() Außerdem soll immer dann, wenn es ein aktuelles Lied gibt, der Titel des aktuellen Liedes im Fenstertitel der GUI erscheinen. Verwende die Bibliothek javazoom.jl.*, um die Abspielfunktionalität umzusetzen. Die entsprechende Jar Datei findest du als Material zur Projektaufgabe auf der Webseite unserer Vorlesung, ebenso ein einfaches Verwendungsbeispiel (MP3Player.java). Die API Dokumentation zu javazoom.jl.* findest du unter folgender Adresse: Achte darauf, dass das Abspielen in einem gesonderten Thread passiert, so dass die Benutzeroberfläche weiterhin auf Aktionen reagieren kann, während Musik abgespielt wird. Tipp: Die Klasse JList enthält u.a. Funktionalität zum Verwalten eines aktuellen Listeneintrags (siehe API). Zum Testen des Programms wirst du dir wahrscheinlich eine eigene Playliste nach der vorgegebenen Syntax erstellen müssen (ggf. von Hand), die auf tatsächlich vorhandene MP3 Dateien verweist, welche dann auch abgespielt werden können. Wenn du über keine MP3 Dateien verfügst, kannst du auf legal und kostenlos einige Dateien herunterladen. Viel Erfolg! Seite 6 von 6