i2bpro.playlist.M3U Klassenreferenz

Klassendiagramm für i2bpro.playlist.M3U:

Zusammengehörigkeiten von i2bpro.playlist.M3U:

Aufstellung aller Elemente

Öffentliche Methoden
void	SavePlayList (String filename, String type, HashMap< Integer, HashMap< String, String >> list) throws IOException
void	InsertMedia (File[] selectedFiles) throws CannotReadException, IOException, TagException, ReadOnlyFileException, InvalidAudioFrameException
Geschützte Methoden
void	writeToPlayList (String line, String extm3u) throws CannotReadException, IOException, TagException, ReadOnlyFileException, InvalidAudioFrameException
Paketfunktionen
	M3U (String filename) throws FileNotFoundException, IOException, CannotReadException, TagException, ReadOnlyFileException, InvalidAudioFrameException

---

Ausführliche Beschreibung

Projektarbeit Informatik IIb - Audioplayer
Klasse: M3U

Die Klasse M3U ist eine von basePlayList abgeleitete Klasse und dient dem auslesen von M3U - Wiedergabelisten, sowie dem bearbeiten dieser.

Version:

1.0.0

Datum:

22.11.2010

Autor:

Jürgen Döffinger

Definiert in Zeile 40 der Datei M3U.java.

---

Beschreibung der Konstruktoren und Destruktoren

i2bpro.playlist.M3U.M3U

(

String

filename )

throws FileNotFoundException, IOException, CannotReadException, TagException, ReadOnlyFileException, InvalidAudioFrameException [package]

Der erste nicht Standart-Konstruktor erwartet als Parameter eine Pfadangabe. Mit dieser wird die Wiedergabeliste aus der entsprechenden Datei ausgelesen. Dabei wird zwischen einfacher und erweiterter m3u-Wiedergabeliste unterschieden.

Parameter:

filename

Pfadangabe zur Wiedergabeliste

Definiert in Zeile 52 der Datei M3U.java.

---

Dokumentation der Elementfunktionen

void i2bpro.playlist.M3U.InsertMedia

(

File[]

selectedFiles )

throws CannotReadException, IOException, TagException, ReadOnlyFileException, InvalidAudioFrameException

Mit der MEthode InsertMedia können Audiodateien der Wiedergabeliste hinzugefügt werden. Dazu ist der Methode eine Liste mit Pfadangaben zu den Dateien zu übergeben.

Parameter:

selectedFiles

Liste mit Pfadangaben zu den hinzuzufügenden Audiodateien

Ausnahmebehandlung:

CannotReadException
IOException
TagException
ReadOnlyFileException
InvalidAudioFrameException

Definiert in Zeile 198 der Datei M3U.java.

void i2bpro.playlist.M3U.SavePlayList	(	String	filename,
		String	type,
		HashMap< Integer, HashMap< String, String >>	list
	)		throws IOException

Die Methode SavePlayList speichert nicht nur die Änderungen der Wiedergabeliste (playlist), sondern auch die Metadaten der Audiotitel in den entsprechenden Audiodateien.

Parameter:

filename	Pfadangabe zur Wiedergabeliste
type	Typ der Wiedergabeliste (m3u, cue usw.)
list	Wiedergabeliste in Form einer HashMap die gespeichert werden soll

Ausnahmebehandlung:

IOException

Noch zu erledigen:

Es ist der bereich der Speicherung der Metadaten zu überarbeiten, da wav-Dateien nicht berücksichtigt werden. Des Weiteren kommt es bei erweiterten m3u-Wiedergabelisten zu einem Fehler, beim Versuch die Daten für die erweiterte Zeile aus einer wav-Datei zu ermitteln.

Fehler:

Bei Audiodateien im Format WAVE werden Metadaten nicht gespeichert, da diese von Audiotagger nicht ausgelesen werden können bzw. Metadaten damit nicht gespeichert werden können und die Klasse WavTag dies noch nicht vorsieht. Des Weiteren kommt es bei erweiterten m3u-Wiedergabelisten beim erstellen der erweiterten Zeile zu einem Fehler, wenn versucht wird die Daten einer wav-Datei zu ermitteln.

Definiert in Zeile 114 der Datei M3U.java.

void i2bpro.playlist.M3U.writeToPlayList	(	String	line,
		String	extm3u
	)		throws CannotReadException, IOException, TagException, ReadOnlyFileException, InvalidAudioFrameException [protected]

Mit der MEthode writeToPlayList werden die in line und extm3u übergebenen Werte in die Wiedergabeliste (playlist) gespeichert.

Parameter:

line	Zeile mit der Pfadangabe zur Audiodatei
extm3u	erweiterte Zeile einer m3u-Wiedergabeliste

Ausnahmebehandlung:

CannotReadException
IOException
TagException
ReadOnlyFileException
InvalidAudioFrameException

Noch zu erledigen:

In der Methode wird noch keine Rücksicht auf cue-Wiedergabelisten genommen. Dies ist noch umzusetzen.

Definiert in Zeile 262 der Datei M3U.java.

---

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei:

• C:/Projekte/I2BPro/src/i2bpro/playlist/M3U.java