org.apache.jmeter.gui
Class MainFrame

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Frame
                  javax.swing.JFrame
                      org.apache.jmeter.gui.MainFrame

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, javax.swing.RootPaneContainer, javax.swing.WindowConstants, Remoteable, TestListener

public class MainFrame
extends javax.swing.JFrame
implements TestListener, Remoteable

The main JMeter frame, containing the menu bar, test tree, and an area for JMeter component GUIs.

See Also:

Serialized Form

Nested Class Summary

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.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

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 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()
Deprecated. Do not use - only needed for JUnit tests

MainFrame(java.awt.event.ActionListener actionHandler, javax.swing.tree.TreeModel treeModel, JMeterTreeListener treeListener)
Create a new JMeter frame.

Method Summary

void	closeMenu() Close the currently selected menu.
void	drawDraggedComponent(java.awt.Component dragIcon, int x, int y) Repaint pieces of the GUI as needed while dragging.
javax.swing.JTree	getTree()
void	setEditAddEnabled(boolean enabled) Specify whether or not the Edit|Add menu item should be enabled.
void	setEditAddMenu(javax.swing.JMenu menu) Set the menu that should be used for the Edit|Add menu.
void	setEditEnabled(boolean enabled) Specify whether or not the Edit menu item should be enabled.
void	setEditMenu(javax.swing.JPopupMenu menu) Set the menu that should be used for the Edit menu.
void	setEditRemoveEnabled(boolean enabled) Specify whether or not the Edit|Remove menu item should be enabled.
void	setExtendedFrameTitle(java.lang.String fname)
void	setFileLoadEnabled(boolean enabled) Specify whether or not the File|Load menu item should be enabled.
void	setFileRevertEnabled(boolean enabled) Specify whether or not the File|Revert item should be enabled.
void	setFileSaveEnabled(boolean enabled) Specify whether or not the File|Save menu item should be enabled.
void	setMainPanel(javax.swing.JComponent comp)
void	setProjectFileLoaded(java.lang.String file) Specify the project file that was just loaded
void	showStoppingMessage(java.lang.String host) Show a dialog indicating that JMeter threads are stopping on a particular host.
void	testEnded() Called when a test is ended on the local system.
void	testEnded(java.lang.String host) Called when a test is ended on the remote system.
void	testIterationStart(LoopIterationEvent event) Each time through a Thread Group's test script, an iteration event is fired for each thread.
void	testStarted() Called when a test is started on the local system.
void	testStarted(java.lang.String host) Called when a test is started on a specific host.
void	updateCounts()

Methods inherited from class javax.swing.JFrame

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

Methods inherited from class java.awt.Frame

addNotify, 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, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setVisible, 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, 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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Constructor Detail

MainFrame

public MainFrame(java.awt.event.ActionListener actionHandler,
                 javax.swing.tree.TreeModel treeModel,
                 JMeterTreeListener treeListener)

Create a new JMeter frame.

Parameters:

actionHandler - this parameter is not used

treeModel - the model for the test tree

treeListener - the listener for the test tree

MainFrame

public MainFrame()

Deprecated. Do not use - only needed for JUnit tests

Default constructor for the JMeter frame. This constructor will not properly initialize the tree, so don't use it.

Method Detail

setFileLoadEnabled

public void setFileLoadEnabled(boolean enabled)

Specify whether or not the File|Load menu item should be enabled.

Parameters:

enabled - true if the menu item should be enabled, false otherwise

setFileSaveEnabled

public void setFileSaveEnabled(boolean enabled)

Specify whether or not the File|Save menu item should be enabled.

Parameters:

enabled - true if the menu item should be enabled, false otherwise

setFileRevertEnabled

public void setFileRevertEnabled(boolean enabled)

Specify whether or not the File|Revert item should be enabled.

Parameters:

enabled - true if the menu item should be enabled, false otherwise

setProjectFileLoaded

public void setProjectFileLoaded(java.lang.String file)

Specify the project file that was just loaded

Parameters:

file - - the full path to the file that was loaded

setEditMenu

public void setEditMenu(javax.swing.JPopupMenu menu)

Set the menu that should be used for the Edit menu.

Parameters:

menu - the new Edit menu

setEditEnabled

public void setEditEnabled(boolean enabled)

Specify whether or not the Edit menu item should be enabled.

Parameters:

enabled - true if the menu item should be enabled, false otherwise

setEditAddMenu

public void setEditAddMenu(javax.swing.JMenu menu)

Set the menu that should be used for the Edit|Add menu.

Parameters:

menu - the new Edit|Add menu

setEditAddEnabled

public void setEditAddEnabled(boolean enabled)

Specify whether or not the Edit|Add menu item should be enabled.

Parameters:

enabled - true if the menu item should be enabled, false otherwise

setEditRemoveEnabled

public void setEditRemoveEnabled(boolean enabled)

Specify whether or not the Edit|Remove menu item should be enabled.

Parameters:

enabled - true if the menu item should be enabled, false otherwise

closeMenu

public void closeMenu()

Close the currently selected menu.

showStoppingMessage

public void showStoppingMessage(java.lang.String host)

Show a dialog indicating that JMeter threads are stopping on a particular host.

Parameters:

host - the host where JMeter threads are stopping

updateCounts

public void updateCounts()

setMainPanel

public void setMainPanel(javax.swing.JComponent comp)

getTree

public javax.swing.JTree getTree()

testStarted

public void testStarted()

Called when a test is started on the local system. This implementation sets the running indicator and ensures that the menubar is enabled and in the running state.

Specified by:

testStarted in interface TestListener

See Also:

StandardJMeterEngine.run()

testStarted

public void testStarted(java.lang.String host)

Called when a test is started on a specific host. This implementation sets the running indicator and ensures that the menubar is in the running state.

Specified by:

testStarted in interface TestListener

Parameters:

host - the host where the test is starting

See Also:

StandardJMeterEngine.run()

testEnded

public void testEnded()

Called when a test is ended on the local system. This implementation disables the menubar, stops the running indicator, and closes the stopping message dialog.

Specified by:

testEnded in interface TestListener

See Also:

StandardJMeterEngine.stopTest()

testEnded

public void testEnded(java.lang.String host)

Called when a test is ended on the remote system. This implementation stops the running indicator and closes the stopping message dialog.

Specified by:

testEnded in interface TestListener

Parameters:

host - the host where the test is ending

See Also:

StandardJMeterEngine.stopTest()

testIterationStart

public void testIterationStart(LoopIterationEvent event)

Description copied from interface: TestListener

Each time through a Thread Group's test script, an iteration event is fired for each thread. This will be after the test elements have been cloned, so in general the instance will not be the same as the ones the start/end methods call.

Specified by:

testIterationStart in interface TestListener

setExtendedFrameTitle

public void setExtendedFrameTitle(java.lang.String fname)

drawDraggedComponent

public void drawDraggedComponent(java.awt.Component dragIcon,
                                 int x,
                                 int y)

Repaint pieces of the GUI as needed while dragging. This method should only be called from the Swing event thread.

Parameters:

dragIcon - the component being dragged

x - the current mouse x coordinate

y - the current mouse y coordinate