Team Meow Mix Sorter Action

Needed Widgets: These are the widgets we feel are needed to author an mp3 sorter in Fluency.

Import Design

The import functionality allows the user to open an old mp3 database (XML file), add to the database, and create a new database. When a user clicks the import button, two things happen: the FileNameReaderWidget reads in a list of files, and the XMLReaderWidget reads in an XML file (if one exists). Both widgets send a list of filenames to the DiffWidget. The DiffWidget takes the filenames from the FileNameReaderWidget that are not in the XMLReaderWidget, and sends those filenames to the MP3Widget. The MP3Widget finds the mp3 data from the files' ID3 data (or from the names of the files, if no ID3 data exists). This MP3 data is then sent to the XMLWriter, where it is saved to an xml file. Once that is done, the new xml file is read by the XMLReaderWidget, and the data is sent to the Table to be displayed.

Export Design

The export functionality will allow a user of the mp3 sorter to save the changes that they have made to the stored mp3 database (an XML file). It is envoked by a button press, presumably a button labeled export. This button press in turn sends an ExportEvent to the Table Widget. The Table Widget has access to the Swing table which is responsible for displaying mp3 information. Upon receiving the ExportEvent, the Table Widget takes this mp3 information, which will reflect the changes made by the user, and sends it to the XML Writer Widget. Finally, the XML Writer Widget makes the appropriate changes to the mp3 database.

XML Database File

The sorted information for MP3s will be stored in an XML file. Each MP3 will be identified individually by its filename. MP3 attributes, such as artist, song name, and genre, will be in the DOM tree for each MP3 file. The XML database will be generated upon the export event and will grab its information from the TableWidget, which is editable by the user. An example XML file might look like as follows.

<mp3s>
  <mp3 filename="DaftPunk-DigitalLove.mp3">
    <artist>Daft Punk</artist>
    <title>Digital Love</title>
    <album>Discovery</album>
    <genre>Electronic</genre>
    <year>2001</year>
  </mp3>
  <mp3 filename="TranceControl-TheWayHome.mp3">
    <artist>t r a n c e [] c o n t r o l</artist>
    <title>The Way Home</title>
    <album>Beyond 2001: The Resurrection</album>
    <genre>Trance</genre>
    <year>2000</year>
  </mp3>
</mp3s>