talx.controller.base
Class ReaderHandler

java.lang.Object
  talx.controller.base.ReaderHandler

All Implemented Interfaces:

ActionHandler, GUIStateConstants, java.io.Serializable

public final class ReaderHandler

extends java.lang.Object

implements ActionHandler, GUIStateConstants

Used when the reader contains a message.

See Also:

Serialized Form

Field Summary

Fields inherited from interface talx.model.GUIStateConstants

ACTIVE_COMMANDS, ARCHIVE_MESSAGE, CHOICE_DIALOG, COMPOSE_FOCUS, COMPOSE_WINDOW, COMPOSER_CAPTION, COMPOSER_DIRTY, CONFIRM_DIALOG, CURRENT_PEOPLE, CURRENT_PLAYER, DEFAULT_MESSAGE, DIALOG_FOCUS, DIALOG_TEXT, INBOX_FOCUS, INBOX_MAIL_COUNTS, INBOX_MAIL_COUNTS_ANSWERED, INBOX_MAIL_COUNTS_NEW, INBOX_PANEL, INBOX_PLAYER_CAPTIONS, NO_CHANGE, NO_MESSAGE, NO_PEOPLE, NO_PERSON, NO_PLAYER, READER_CAPTION, READER_FOCUS, READER_HEADERS, READER_WINDOW, STATE_ABBR, STATE_CONST, STATE_DESC

Method Summary

boolean	canRun(GUIState state, Controller c) This method tells the controller whether the given handler will function in the given GUIState.
static ReaderHandler	getInstance() Returns the only object of this type.
ActionHandler	handleAction(java.awt.event.ActionEvent ev, Controller c) Handles reader controls.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static ReaderHandler getInstance()

Returns the only object of this type.

canRun

public boolean canRun(GUIState state,
                      Controller c)

Description copied from interface: ActionHandler

This method tells the controller whether the given handler will function in the given GUIState. For example, if a given handler only responds to Inbox actions, then this method should test the given GUIState to make sure the inbox flag is set.

Specified by:

canRun in interface ActionHandler

Parameters:

state - the current visual state of the system

Returns:

true if the given visual state will support this behavioral state. False if using this handler would lock up the system.

handleAction

public ActionHandler handleAction(java.awt.event.ActionEvent ev,
                                  Controller c)
                           throws ActionVetoException

Handles reader controls. This method handles delete button presses by deleting the message and resetting the interface, reply button presses by setting up the composer to get a reply, and other reader controls by clearing the interface (ie calling the inbox handler with a null event). If the control is not a reader control, this method delegates to the InboxHandler's handleAction method.

Specified by:

handleAction in interface ActionHandler

Throws:

java.lang.NullPointerException - if ev is null. This class cannot be used as an initial handler class.

ActionVetoException - to suppress a controller change finished event upon termination.