com.melloware.jukes.gui.tool
Class MainController

java.lang.Object
  com.melloware.jukes.gui.tool.MainController

public final class MainController
extends java.lang.Object

Provides all application-level behavior. Most of the methods in this class will be invoked by AbstractActions as defined in the Actions class.

Copyright (c) 2006 Melloware, Inc.

Version:

4.0

Author:

Emil A. Lefkof III

Constructor Summary

MainController(MainModule mainModule)
Constructs the MainController for the given main module.

Method Summary

void	backupTool(java.awt.event.ActionEvent aEvent) Backs up the database to zip file.
void	checkForOpenTipOfTheDayDialog() Checks if we shall show a tip of the day: asks the TipOfTheDayDialog whether it is enabled, and the SetupManager, if we are not running for the first time.
void	chooseDirectory(java.awt.event.ActionEvent aEvent) Opens the Directory chooser dialog.
void	chooseFile(java.awt.event.ActionEvent aEvent) Chooses a file and puts it in the text component listed.
void	commit(java.awt.event.ActionEvent aEvent) Commits the object to the database and updates tags if necessary.
void	connect(java.awt.event.ActionEvent aEvent) Connects to the database and refreshes the whole application.
void	contactUs(java.awt.event.ActionEvent aEvent) Redirects to the www.melloware.com homepage.
void	delete(java.awt.event.ActionEvent aEvent) Deletes the object and all its descendants but not any files they may point to.
void	differenceTool(java.awt.event.ActionEvent aEvent) Displays the difference tool dialog.
void	discAdd(java.awt.event.ActionEvent aEvent) Adds a single disc to the catalog by making the user select a directory.
void	discAddComments(java.awt.event.ActionEvent aEvent) Updates all of the comments at once.
void	discAddResetFromFilename(java.awt.event.ActionEvent aEvent) Resets all tracks titles based on filename.
void	discAddResetTrackNumbers(java.awt.event.ActionEvent aEvent) Resets all track numbers in a disc if they are really screwed up.
void	discAddTitleCase(java.awt.event.ActionEvent aEvent) Title cases all tracks in a disc.
void	discCoverImage(java.awt.event.ActionEvent aEvent) Uses a file chooser to let the user select another cover image.
void	discFinder(java.awt.event.ActionEvent aEvent) Opens the Disc Finder dialog.
void	discRemover(java.awt.event.ActionEvent aEvent) Opens the Disc Remover dialog.
void	discWebSearch(java.awt.event.ActionEvent aEvent) Uses the Amazon.com web service to find album information and covers.
void	donate() Launches a browser and send to the PayPal website
void	exportCatalog(java.awt.event.ActionEvent aEvent) Exports a catalog to a text file the user selects with a chooser.
void	fileRename(java.awt.event.ActionEvent aEvent) Renames the file to track number - title.mp3.
void	filter(java.awt.event.ActionEvent aEvent) Applies the current filter to the tree.
void	filterClear(java.awt.event.ActionEvent aEvent) Clears the current filter.
void	filterClose(java.awt.event.ActionEvent aEvent) Closes the filter window.
void	filterDisplay(java.awt.event.ActionEvent aEvent) Displays or hides the filter window.
void	forums() Launches the browser to the forums website.
void	hideMainWindow() Hides the main window.
void	language(java.awt.event.ActionEvent aEvent, java.lang.String aLanguage) Updates the language of the application to aLanguage.
void	locationTool(java.awt.event.ActionEvent aEvent) Opens the global location change tool.
void	memory(java.awt.event.ActionEvent aEvent) Displays the memory usage and provide garbage collection.
void	playerNext(java.awt.event.ActionEvent aEvent) Plays the next track in the playlist.
void	playerPause(java.awt.event.ActionEvent aEvent) Pauses the media player.
void	playerPlay(java.awt.event.ActionEvent aEvent) Plays the media player.
void	playerPrevious(java.awt.event.ActionEvent aEvent) Plays the previous track in the playlist.
void	playerStop(java.awt.event.ActionEvent aEvent) Stops the media player.
void	playImmediately(java.awt.event.ActionEvent aEvent) Plays the selected track immediately.
void	playlistClear(java.awt.event.ActionEvent aEvent) Clears all tracks from the playlist.
void	playlistClose(java.awt.event.ActionEvent aEvent) Closes the playlist.
void	playlistDisplay(java.awt.event.ActionEvent aEvent) Shows or hides the playlist.
void	playlistGoto(java.awt.event.ActionEvent aEvent) Go to the track in the navigator.
void	playlistLoad(java.awt.event.ActionEvent aEvent) Loads a playlist from a file.
void	playlistMoveDown(java.awt.event.ActionEvent aEvent) Moves a track down on the playlist.
void	playlistMoveOver(java.awt.event.ActionEvent aEvent) Moves the selected tracks over to the other list.
void	playlistMoveUp(java.awt.event.ActionEvent aEvent) Moves a track up on the playlist.
void	playlistRemoveTracks(java.awt.event.ActionEvent aEvent) Removes tracks from the playlist.
void	playlistSave(java.awt.event.ActionEvent aEvent) Saves a playlist to disk.
void	playlistShuffleCatalog(java.awt.event.ActionEvent aEvent) Toggles between shuffling the catalog or not.
void	playlistShuffleList(java.awt.event.ActionEvent aEvent) Toggles between shuffling the playlist or not.
void	playlistToggle(java.awt.event.ActionEvent aEvent) Toggles between history and current playlist.
void	preferencesExport(java.awt.event.ActionEvent aEvent) Export preferences to an XML file.
void	preferencesImport(java.awt.event.ActionEvent aEvent) Import preferences from an XML file.
void	queue(java.awt.event.ActionEvent aEvent) Adds track(s) to the bottom of the queue.
void	queueNext(java.awt.event.ActionEvent aEvent) Adds track(s) to the top of the queue.
void	refresh(java.awt.event.ActionEvent aEvent) Refreshes the data from the database and reloads the tree
void	reportBitrate(java.awt.event.ActionEvent aEvent) Displays a report to display all bitrates and lower.
void	reportCatalog(java.awt.event.ActionEvent aEvent) Displays a report with the entire catalog in alphabetical order.
void	reportNoCoverArt(java.awt.event.ActionEvent aEvent) Displays a report with all albums without cover artwork.
void	rollback(java.awt.event.ActionEvent aEvent) Rolls changes back to orginal form.
void	search(java.awt.event.ActionEvent aEvent) Searches the database.
void	showMainWindow() Shows the main window.
void	statistics(java.awt.event.ActionEvent aEvent) Displays the statistics dialog.
void	titleCase(java.awt.event.ActionEvent aEvent) Converts the associated TextComponent to title case.
void	unlock(java.awt.event.ActionEvent aEvent) Unlocks the current editor for editing.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MainController

public MainController(MainModule mainModule)

Constructs the MainController for the given main module. Many methods require that the default parent frame is set once it is available.

Parameters:

mainModule - provides bound properties and high-level models

See Also:

#setDefaultParentFrame(Frame)

Method Detail

backupTool

public void backupTool(java.awt.event.ActionEvent aEvent)

Backs up the database to zip file.

Parameters:

aEvent - the Actionevent fired

checkForOpenTipOfTheDayDialog

public void checkForOpenTipOfTheDayDialog()

Checks if we shall show a tip of the day: asks the TipOfTheDayDialog whether it is enabled, and the SetupManager, if we are not running for the first time. We don't want to disturb the user the first time, where we already have opened some extra panels from the setup process.

Opens the tip of the day dialog in the event dispatch thread.

chooseDirectory

public void chooseDirectory(java.awt.event.ActionEvent aEvent)

Opens the Directory chooser dialog.

Parameters:

aEvent - the Action Event fired for this button

chooseFile

public void chooseFile(java.awt.event.ActionEvent aEvent)

Chooses a file and puts it in the text component listed.

Parameters:

aEvent - the Action Event fired for this button

commit

public void commit(java.awt.event.ActionEvent aEvent)

Commits the object to the database and updates tags if necessary.

Parameters:

aEvent - the Action Event fired for this button

connect

public void connect(java.awt.event.ActionEvent aEvent)

Connects to the database and refreshes the whole application.

Parameters:

aEvent - the Action Event fired for this button

contactUs

public void contactUs(java.awt.event.ActionEvent aEvent)

Redirects to the www.melloware.com homepage.

Parameters:

aEvent - the Action Event fired for this button

delete

public void delete(java.awt.event.ActionEvent aEvent)

Deletes the object and all its descendants but not any files they may point to.

Parameters:

aEvent - the Action Event fired for this button

differenceTool

public void differenceTool(java.awt.event.ActionEvent aEvent)

Displays the difference tool dialog.

Parameters:

aEvent - the Action Event fired for this button

discAdd

public void discAdd(java.awt.event.ActionEvent aEvent)

Adds a single disc to the catalog by making the user select a directory.

Parameters:

aEvent - the Action Event fired for this button

discAddComments

public void discAddComments(java.awt.event.ActionEvent aEvent)

Updates all of the comments at once.

Parameters:

aEvent - the ActionEvent fired

discAddResetFromFilename

public void discAddResetFromFilename(java.awt.event.ActionEvent aEvent)

Resets all tracks titles based on filename.

Parameters:

aEvent - the ActionEvent fired

discAddResetTrackNumbers

public void discAddResetTrackNumbers(java.awt.event.ActionEvent aEvent)

Resets all track numbers in a disc if they are really screwed up.

Parameters:

aEvent - the ActionEvent fired

discAddTitleCase

public void discAddTitleCase(java.awt.event.ActionEvent aEvent)

Title cases all tracks in a disc.

Parameters:

aEvent - the ActionEvent fired

discCoverImage

public void discCoverImage(java.awt.event.ActionEvent aEvent)

Uses a file chooser to let the user select another cover image.

Parameters:

aEvent - the Action Event fired for this button

discFinder

public void discFinder(java.awt.event.ActionEvent aEvent)

Opens the Disc Finder dialog.

Parameters:

aEvent - the Action Event fired for this button

discRemover

public void discRemover(java.awt.event.ActionEvent aEvent)

Opens the Disc Remover dialog.

Parameters:

aEvent - the Action Event fired for this button

discWebSearch

public void discWebSearch(java.awt.event.ActionEvent aEvent)

Uses the Amazon.com web service to find album information and covers.

Parameters:

aEvent - the Action Event fired for this button

donate

public void donate()

Launches a browser and send to the PayPal website

exportCatalog

public void exportCatalog(java.awt.event.ActionEvent aEvent)

Exports a catalog to a text file the user selects with a chooser.

Parameters:

aEvent - the Action Event fired for this button

fileRename

public void fileRename(java.awt.event.ActionEvent aEvent)

Renames the file to track number - title.mp3.

Parameters:

aEvent - the Action Event fired for this button

filter

public void filter(java.awt.event.ActionEvent aEvent)

Applies the current filter to the tree.

Parameters:

aEvent - the Action Event fired for this button

filterClear

public void filterClear(java.awt.event.ActionEvent aEvent)

Clears the current filter.

Parameters:

aEvent - the Action Event fired for this button

filterClose

public void filterClose(java.awt.event.ActionEvent aEvent)

Closes the filter window.

Parameters:

aEvent - the Action Event fired for this button

filterDisplay

public void filterDisplay(java.awt.event.ActionEvent aEvent)

Displays or hides the filter window.

Parameters:

aEvent - the Action Event fired for this button

forums

public void forums()

Launches the browser to the forums website.

hideMainWindow

public void hideMainWindow()

Hides the main window.

language

public void language(java.awt.event.ActionEvent aEvent,
                     java.lang.String aLanguage)

Updates the language of the application to aLanguage.

Parameters:

aEvent - the ActionEvent fired

aLanguage - the language to change to

locationTool

public void locationTool(java.awt.event.ActionEvent aEvent)

Opens the global location change tool.

Parameters:

aEvent - the Action Event fired for this button

memory

public void memory(java.awt.event.ActionEvent aEvent)

Displays the memory usage and provide garbage collection.

Parameters:

aEvent - the Action Event fired for this button

playerNext

public void playerNext(java.awt.event.ActionEvent aEvent)

Plays the next track in the playlist.

Parameters:

aEvent - the actionevent fired

playerPause

public void playerPause(java.awt.event.ActionEvent aEvent)

Pauses the media player.

Parameters:

aEvent - the actionevent fired

playerPlay

public void playerPlay(java.awt.event.ActionEvent aEvent)

Plays the media player.

Parameters:

aEvent - the actionevent fired

playerPrevious

public void playerPrevious(java.awt.event.ActionEvent aEvent)

Plays the previous track in the playlist.

Parameters:

aEvent - the actionevent fired

playerStop

public void playerStop(java.awt.event.ActionEvent aEvent)

Stops the media player.

Parameters:

aEvent - the actionevent fired

playImmediately

public void playImmediately(java.awt.event.ActionEvent aEvent)

Plays the selected track immediately.

Parameters:

aEvent - the Action Event fired for this button

playlistClose

public void playlistClose(java.awt.event.ActionEvent aEvent)

Closes the playlist.

Parameters:

aEvent - the Actionevent fired

playlistDisplay

public void playlistDisplay(java.awt.event.ActionEvent aEvent)

Shows or hides the playlist.

Parameters:

aEvent - the Actionevent fired

playlistGoto

public void playlistGoto(java.awt.event.ActionEvent aEvent)

Go to the track in the navigator.

Parameters:

aEvent - the Actionevent fired

playlistLoad

public void playlistLoad(java.awt.event.ActionEvent aEvent)

Loads a playlist from a file.

Parameters:

aEvent - the Action Event fired for this button

playlistMoveDown

public void playlistMoveDown(java.awt.event.ActionEvent aEvent)

Moves a track down on the playlist.

Parameters:

aEvent - the Actionevent fired

playlistMoveOver

public void playlistMoveOver(java.awt.event.ActionEvent aEvent)

Moves the selected tracks over to the other list.

Parameters:

aEvent - the Action Event fired for this button

playlistMoveUp

public void playlistMoveUp(java.awt.event.ActionEvent aEvent)

Moves a track up on the playlist.

Parameters:

aEvent - the Actionevent fired

playlistRemoveTracks

public void playlistRemoveTracks(java.awt.event.ActionEvent aEvent)

Removes tracks from the playlist.

Parameters:

aEvent - the Actionevent fired

playlistClear

public void playlistClear(java.awt.event.ActionEvent aEvent)

Clears all tracks from the playlist.

Parameters:

aEvent - the Actionevent fired

playlistSave

public void playlistSave(java.awt.event.ActionEvent aEvent)

Saves a playlist to disk.

Parameters:

aEvent - the Action Event fired for this button

playlistShuffleCatalog

public void playlistShuffleCatalog(java.awt.event.ActionEvent aEvent)

Toggles between shuffling the catalog or not.

Parameters:

aEvent - the Action Event fired for this button

playlistShuffleList

public void playlistShuffleList(java.awt.event.ActionEvent aEvent)

Toggles between shuffling the playlist or not.

Parameters:

aEvent - the Action Event fired for this button

playlistToggle

public void playlistToggle(java.awt.event.ActionEvent aEvent)

Toggles between history and current playlist.

Parameters:

aEvent - the Action Event fired for this button

preferencesExport

public void preferencesExport(java.awt.event.ActionEvent aEvent)

Export preferences to an XML file.

Parameters:

aEvent - the Action Event fired for this button

preferencesImport

public void preferencesImport(java.awt.event.ActionEvent aEvent)

Import preferences from an XML file.

Parameters:

aEvent - the Action Event fired for this button

queue

public void queue(java.awt.event.ActionEvent aEvent)

Adds track(s) to the bottom of the queue.

Parameters:

aEvent - the Action Event fired for this button

queueNext

public void queueNext(java.awt.event.ActionEvent aEvent)

Adds track(s) to the top of the queue.

Parameters:

aEvent - the Action Event fired for this button

refresh

public void refresh(java.awt.event.ActionEvent aEvent)

Refreshes the data from the database and reloads the tree

Parameters:

aEvent - the Action Event fired for this button

rollback

public void rollback(java.awt.event.ActionEvent aEvent)

Rolls changes back to orginal form.

Parameters:

aEvent - the Action Event fired for this button

search

public void search(java.awt.event.ActionEvent aEvent)

Searches the database.

Parameters:

aEvent - the actionevent fired

showMainWindow

public void showMainWindow()

Shows the main window.

statistics

public void statistics(java.awt.event.ActionEvent aEvent)

Displays the statistics dialog.

Parameters:

aEvent - the Action Event fired for this button

titleCase

public void titleCase(java.awt.event.ActionEvent aEvent)

Converts the associated TextComponent to title case.

Parameters:

aEvent - the Action Event fired for this button

unlock

public void unlock(java.awt.event.ActionEvent aEvent)

Unlocks the current editor for editing.

Parameters:

aEvent - the Action Event fired for this button

reportNoCoverArt

public void reportNoCoverArt(java.awt.event.ActionEvent aEvent)

Displays a report with all albums without cover artwork.

Parameters:

aEvent - the Action Event fired for this button

reportCatalog

public void reportCatalog(java.awt.event.ActionEvent aEvent)

Displays a report with the entire catalog in alphabetical order.

Parameters:

aEvent - the Action Event fired for this button

reportBitrate

public void reportBitrate(java.awt.event.ActionEvent aEvent)

Displays a report to display all bitrates and lower.

Parameters:

aEvent - the Action Event fired for this button