com.gargoylesoftware.base.gui
public abstract class AbstractUIController extends Object
Swing uses an architecture similar to Model-View-Controller (MVC) in which the model, view and controller components are kept seperate from each other. This class provides some common behaviour that is useful for controller objects. This includes support for:
Version: $Revision: 1.6 $
Nested Class Summary | |
---|---|
class | AbstractUIController.TaskRunnable |
Field Summary | |
---|---|
Locale | locale_ |
Constructor Summary | |
---|---|
AbstractUIController()
Create a new controller. |
Method Summary | |
---|---|
protected void | assertNotNull(String fieldName, Object object)
Throw an exception if the specified object is null |
Locale | getLocale()
Return the current locale.
|
protected abstract void | localeChanged(Locale locale)
The current locale has changed - update all locale specific information.
|
void | run()
The main entry point into this controller |
protected abstract void | runImpl()
Subclasses will override this to provide the run logic |
void | setLocale(Locale locale)
Set the current locale
|
protected void | startTask(WorkerTask task)
Start a WorkerTask. |
protected void | taskComplete(WorkerTask task)
A callback that will be invoked when a task has completed whether it was
successful or not. |
protected void | taskErrorThrown(WorkerTask task, Throwable throwable)
A callback that will be invoked when a system error is thrown during the
processing of a WorkerTask. |
protected void | taskExceptionThrown(WorkerTask task, Exception exception)
A callback that will be invoked when an exception is thrown during the
processing of a WorkerTask. |
protected void | taskSuccessful(WorkerTask task)
A callback that will be invoked when a task completed successfully.
|
Parameters: fieldName The name of the paremeter we are checking object The value of the parameter we are checking
Returns: The current locale
Parameters: locale The new locale
Parameters: locale the new locale
When the task has completed, one of the following callbacks will be called based on the success of the task.
taskSuccessful()
will be called
taskExceptionThrown()
will be called
taskErrorThrown()
will be called
taskSuccessful()
will be called will be called to signal the completion
of the task
Parameters: task The WorkerTask that is about to execute.
Parameters: task The task that just finished.
Parameters: task The task that failed throwable The throwable object that was caught
The default behaviour is to print the stack trace of the caught exception to System.out. Override this method to provide custom error handling.
Parameters: task The task that failed exception The exception that was caught.
The default behaviour is to do nothing. Override this to provide custom behaviour.
Parameters: task The task that just finished.