edu.udo.cs.yale.gui
Class MainFrame

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Frame
                  javax.swing.JFrame
                      edu.udo.cs.yale.gui.MainFrame

All Implemented Interfaces:

BreakpointListener, java.awt.event.WindowListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.event.ChangeListener, javax.swing.RootPaneContainer, javax.swing.WindowConstants

public class MainFrame
extends javax.swing.JFrame
implements java.awt.event.WindowListener, javax.swing.event.ChangeListener, BreakpointListener

The main component class of the Yale GUI. The class holds a lot of Actions that can be used for the tool bar and for the menu bar. MainFrame has methods for handling the experiment (saving, opening, creating new). It keeps track of the state of the experiment and enables/disables buttons. It must be notified whenever the experiment changes and propagates this event to its children. Most of the code is enclosed within the Actions.

Version:

$Id: MainFrame.java,v 2.96 2006/10/03 13:22:41 ingomierswa Exp $

Author:

Simon Fischer, Ingo Mierswa

See Also:

Serialized Form

Nested Class Summary

private class	MainFrame.AnovaCalculatorAction
private class	MainFrame.AttributeEditorAction
private class	MainFrame.CheckForJDBCDriversAction
private class	MainFrame.CheckForUpdatesAction
private class	MainFrame.ExitAction
private class	MainFrame.ExportAction
private class	MainFrame.ManageBuildingBlocksAction
private class	MainFrame.ManageTemplatesAction
private class	MainFrame.NewAction
private class	MainFrame.OpenAction
private class	MainFrame.PrintAction
private class	MainFrame.RedoAction
private class	MainFrame.ResumeAction
private class	MainFrame.RunAction
private class	MainFrame.SaveAction
private class	MainFrame.SaveAsAction
private class	MainFrame.SaveAsTemplateAction
private class	MainFrame.SettingsAction
private class	MainFrame.StopAction
private class	MainFrame.ToggleExpertModeAction
private class	MainFrame.TotDAction
private class	MainFrame.TutorialAction
private class	MainFrame.UndoAction
private class	MainFrame.ValidateExperiment
private class	MainFrame.WizardAction

Nested classes/interfaces inherited from class javax.swing.JFrame

javax.swing.JFrame.AccessibleJFrame

Nested classes/interfaces inherited from class java.awt.Frame

java.awt.Frame.AccessibleAWTFrame

Nested classes/interfaces inherited from class java.awt.Window

java.awt.Window.AccessibleAWTWindow

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

javax.swing.Action	ANOVA_CALCULATOR_ACTION
javax.swing.Action	ATTRIBUTE_EDITOR_ACTION
private boolean	changed
javax.swing.Action	CHECK_FOR_JDBC_DRIVERS_ACTION
javax.swing.Action	CHECK_FOR_UPDATES_ACTION
private ExperimentEditor	currentExperimentEditor
private XMLEditor	editor
private javax.swing.JTabbedPane	editorTabs
javax.swing.Action	EXIT_ACTION
private ExperimentPanel	experimentPanel
private ExperimentThread	experimentThread
javax.swing.Action	EXPORT_ACTION
javax.swing.Action	MANAGE_BUILDING_BLOCKS_ACTION
javax.swing.Action	MANAGE_TEMPLATES_ACTION
private MessageViewer	messageViewer
private MonitorPanel	monitorPanel
javax.swing.Action	NEW_ACTION
javax.swing.Action	OPEN_ACTION
javax.swing.Action	PRINT_ACTION
private java.awt.print.PrinterJob	printerJob
private javax.swing.JMenu	recentFilesMenu
javax.swing.Action	REDO_ACTION
private ResultDisplay	resultDisplay
javax.swing.Action	RESUME_ACTION
javax.swing.Action	RUN_ACTION
javax.swing.Action	SAVE_ACTION
javax.swing.Action	SAVE_AS_ACTION
javax.swing.Action	SAVE_AS_TEMPLATE_ACTION
private static long	serialVersionUID
javax.swing.Action	SETTINGS_ACTION
private javax.swing.JSplitPane	splitPaneV
private StatusBar	statusBar
javax.swing.Action	STOP_ACTION
private static java.lang.String	TITLE The title of the frame.
javax.swing.Action	TOGGLE_EXPERT_MODE_ACTION
javax.swing.Action	TOTD_ACTION
private TreePanel	treePanel
javax.swing.Action	TUTORIAL_ACTION
private boolean	tutorialMode
javax.swing.Action	UNDO_ACTION
private int	undoIndex
private java.util.LinkedList<java.lang.String>	undoList
javax.swing.Action	VALIDATE_ACTION
javax.swing.Action	WIZARD_ACTION

Fields inherited from class javax.swing.JFrame

accessibleContext, EXIT_ON_CLOSE, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface edu.udo.cs.yale.BreakpointListener

BREAKPOINT_AFTER, BREAKPOINT_BEFORE, BREAKPOINT_POS_NAME, BREAKPOINT_WITHIN

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

MainFrame()
Creates a new main frame containing the Yale GUI.

Method Summary

private void	addToUndoList()
void	breakpointReached(Operator operator, IOContainer ioContainer, int location) This method is invoked every time a breakpoint is reached during the experiment.
private boolean	close()
void	enableActions() Enables and disables all actions according to the current state (experiment running, operator selected...
private void	enableUndoAction()
private void	exit()
void	experimentChanged() Must be called when the experiment changed (such that is different from the experiment last saved to disk.
void	experimentEnded(IOContainer results)
private java.lang.String	getBaseName()
int	getHorizontalDividerLocation()
MessageViewer	getMessageViewer()
MonitorPanel	getMonitorPanel()
OperatorTree	getOperatorTree()
OperatorPropertyTable	getPropertyTable()
ResultDisplay	getResultDisplay()
int	getVerticalDividerLocation()
void	open()
void	open(java.io.File file)
void	open(java.io.File file, boolean showInfo)
private void	redo()
void	resume() Since the mainframe toggles the resume itself this method does nothing.
private void	save()
void	setDividerLocations(int h, int v)
void	setExperiment(Experiment experiment) Sets a new experiment and registers the MainFrame listener.
private void	setExperimentIntoStateAt(int undoIndex)
private void	setOperator(Operator root) Sets the root operator for all editors.
private void	setTitle() Sets the window title (Yale + filename + an asterisk if experiment was modified.
void	setTutorialMode(boolean mode)
void	stateChanged(javax.swing.event.ChangeEvent e) Handles events of the editorTabs, i.e. updates all editors such that they reflect the changed experiment.
private void	undo()
void	updateRecentFileList() Updates the list of recently used files.
void	updateToggleExpertModeIcon()
void	windowActivated(java.awt.event.WindowEvent e)
void	windowClosed(java.awt.event.WindowEvent e)
void	windowClosing(java.awt.event.WindowEvent e)
void	windowDeactivated(java.awt.event.WindowEvent e)
void	windowDeiconified(java.awt.event.WindowEvent e)
void	windowIconified(java.awt.event.WindowEvent e)
void	windowOpened(java.awt.event.WindowEvent e)

Methods inherited from class javax.swing.JFrame

addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setIconImage, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, update

Methods inherited from class java.awt.Frame

addNotify, finalize, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setResizable, setState, setTitle, setUndecorated

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setAlwaysOnTop, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, setLocationRelativeTo, show, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

TITLE

private static final java.lang.String TITLE

The title of the frame.

See Also:

Constant Field Values

NEW_ACTION

public final javax.swing.Action NEW_ACTION

OPEN_ACTION

public final javax.swing.Action OPEN_ACTION

SAVE_ACTION

public final javax.swing.Action SAVE_ACTION

SAVE_AS_ACTION

public final javax.swing.Action SAVE_AS_ACTION

SAVE_AS_TEMPLATE_ACTION

public final javax.swing.Action SAVE_AS_TEMPLATE_ACTION

MANAGE_TEMPLATES_ACTION

public final javax.swing.Action MANAGE_TEMPLATES_ACTION

MANAGE_BUILDING_BLOCKS_ACTION

public final javax.swing.Action MANAGE_BUILDING_BLOCKS_ACTION

PRINT_ACTION

public final javax.swing.Action PRINT_ACTION

EXPORT_ACTION

public final javax.swing.Action EXPORT_ACTION

EXIT_ACTION

public final javax.swing.Action EXIT_ACTION

RUN_ACTION

public final javax.swing.Action RUN_ACTION

RESUME_ACTION

public final javax.swing.Action RESUME_ACTION

STOP_ACTION

public final javax.swing.Action STOP_ACTION

VALIDATE_ACTION

public final javax.swing.Action VALIDATE_ACTION

WIZARD_ACTION

public final javax.swing.Action WIZARD_ACTION

SETTINGS_ACTION

public final javax.swing.Action SETTINGS_ACTION

TOGGLE_EXPERT_MODE_ACTION

public final javax.swing.Action TOGGLE_EXPERT_MODE_ACTION

TUTORIAL_ACTION

public final javax.swing.Action TUTORIAL_ACTION

TOTD_ACTION

public final javax.swing.Action TOTD_ACTION

UNDO_ACTION

public final javax.swing.Action UNDO_ACTION

REDO_ACTION

public final javax.swing.Action REDO_ACTION

ATTRIBUTE_EDITOR_ACTION

public final javax.swing.Action ATTRIBUTE_EDITOR_ACTION

ANOVA_CALCULATOR_ACTION

public final javax.swing.Action ANOVA_CALCULATOR_ACTION

CHECK_FOR_UPDATES_ACTION

public final javax.swing.Action CHECK_FOR_UPDATES_ACTION

CHECK_FOR_JDBC_DRIVERS_ACTION

public final javax.swing.Action CHECK_FOR_JDBC_DRIVERS_ACTION

editor

private XMLEditor editor

treePanel

private TreePanel treePanel

experimentPanel

private ExperimentPanel experimentPanel

editorTabs

private javax.swing.JTabbedPane editorTabs

resultDisplay

private ResultDisplay resultDisplay

monitorPanel

private MonitorPanel monitorPanel

messageViewer

private MessageViewer messageViewer

statusBar

private StatusBar statusBar

recentFilesMenu

private javax.swing.JMenu recentFilesMenu

printerJob

private java.awt.print.PrinterJob printerJob

changed

private boolean changed

experimentThread

private ExperimentThread experimentThread

currentExperimentEditor

private ExperimentEditor currentExperimentEditor

tutorialMode

private boolean tutorialMode

splitPaneV

private javax.swing.JSplitPane splitPaneV

undoList

private java.util.LinkedList<java.lang.String> undoList

undoIndex

private int undoIndex

Constructor Detail

MainFrame

public MainFrame()

Creates a new main frame containing the Yale GUI.

Method Detail

setTutorialMode

public void setTutorialMode(boolean mode)

getMonitorPanel

public MonitorPanel getMonitorPanel()

getHorizontalDividerLocation

public int getHorizontalDividerLocation()

getVerticalDividerLocation

public int getVerticalDividerLocation()

setDividerLocations

public void setDividerLocations(int h,
                                int v)

updateToggleExpertModeIcon

public void updateToggleExpertModeIcon()

getPropertyTable

public OperatorPropertyTable getPropertyTable()

getMessageViewer

public MessageViewer getMessageViewer()

getOperatorTree

public OperatorTree getOperatorTree()

getResultDisplay

public ResultDisplay getResultDisplay()

experimentEnded

public void experimentEnded(IOContainer results)

breakpointReached

public void breakpointReached(Operator operator,
                              IOContainer ioContainer,
                              int location)

Description copied from interface: BreakpointListener

This method is invoked every time a breakpoint is reached during the experiment. The location is one out of BREAKPOINT_BEFORE or BREAKPOINT_AFTER.

Specified by:

breakpointReached in interface BreakpointListener

resume

public void resume()

Since the mainframe toggles the resume itself this method does nothing.

Specified by:

resume in interface BreakpointListener

setExperiment

public void setExperiment(Experiment experiment)

Sets a new experiment and registers the MainFrame listener.

setOperator

private void setOperator(Operator root)

Sets the root operator for all editors. This method should not be used to change the experiment. Please use the method setExperiment(Experiment) for this purpose which also sets some listeners etc.

experimentChanged

public void experimentChanged()

Must be called when the experiment changed (such that is different from the experiment last saved to disk.

addToUndoList

private void addToUndoList()

undo

private void undo()

redo

private void redo()

setExperimentIntoStateAt

private void setExperimentIntoStateAt(int undoIndex)

enableUndoAction

private void enableUndoAction()

setTitle

private void setTitle()

Sets the window title (Yale + filename + an asterisk if experiment was modified.

getBaseName

private java.lang.String getBaseName()

close

private boolean close()

open

public void open()

open

public void open(java.io.File file)

open

public void open(java.io.File file,
                 boolean showInfo)

save

private void save()

exit

private void exit()

updateRecentFileList

public void updateRecentFileList()

Updates the list of recently used files.

windowOpened

public void windowOpened(java.awt.event.WindowEvent e)

Specified by:

windowOpened in interface java.awt.event.WindowListener

windowClosing

public void windowClosing(java.awt.event.WindowEvent e)

Specified by:

windowClosing in interface java.awt.event.WindowListener

windowClosed

public void windowClosed(java.awt.event.WindowEvent e)

Specified by:

windowClosed in interface java.awt.event.WindowListener

windowIconified

public void windowIconified(java.awt.event.WindowEvent e)

Specified by:

windowIconified in interface java.awt.event.WindowListener

windowDeiconified

public void windowDeiconified(java.awt.event.WindowEvent e)

Specified by:

windowDeiconified in interface java.awt.event.WindowListener

windowActivated

public void windowActivated(java.awt.event.WindowEvent e)

Specified by:

windowActivated in interface java.awt.event.WindowListener

windowDeactivated

public void windowDeactivated(java.awt.event.WindowEvent e)

Specified by:

windowDeactivated in interface java.awt.event.WindowListener

stateChanged

public void stateChanged(javax.swing.event.ChangeEvent e)

Handles events of the editorTabs, i.e. updates all editors such that they reflect the changed experiment.

Specified by:

stateChanged in interface javax.swing.event.ChangeListener

enableActions

public void enableActions()

Enables and disables all actions according to the current state (experiment running, operator selected...