Apache JMeter
1.9

org.apache.jmeter.gui
Class GuiPackage

java.lang.Object
  |
  +--org.apache.jmeter.gui.GuiPackage

public class GuiPackage
extends Object

GuiPackage is a static class that provides convenient access to information about the current state of JMeter's GUI. Any GUI class can grab a handle to GuiPackage by calling the static method getInstance() and then use it to query the GUI about it's state. When actions, for instance, need to affect the GUI, they typically use GuiPackage to get access to different parts of the GUI.

Version:
$Revision: 1.15 $
Author:
Michael Stover

Method Summary
 org.apache.jorphan.collections.HashTree addSubTree(org.apache.jorphan.collections.HashTree subTree)
          Add a subtree to the currently selected node.
 TestElement createTestElement(String guiClass)
          Create a TestElement corresponding to the specified GUI class.
 void displayPopUp(Component invoker, MouseEvent e, JPopupMenu popup)
          Display the specified popup menu at the location specified by a mouse event with the specified source component.
 void displayPopUp(MouseEvent e, JPopupMenu popup)
          Display the specified popup menu with the source component and location from the specified mouse event.
 JMeterGUIComponent getCurrentGui()
          Convenience method for grabbing the gui for the current node.
 org.apache.jorphan.collections.HashTree getCurrentSubTree()
          Get the currently selected subtree.
 JMeterGUIComponent getGui(TestElement node)
          Get a JMeterGUIComponent for the specified test element.
 JMeterGUIComponent getGui(TestElement node, String guiClass)
          Get a JMeterGUIComponent for the specified test element.
static GuiPackage getInstance()
          Retrieve the singleton GuiPackage instance.
static GuiPackage getInstance(JMeterTreeListener listener, JMeterTreeModel treeModel)
          When GuiPackage is requested for the first time, it should be given handles to JMeter's Tree Listener and TreeModel.
 MainFrame getMainFrame()
          Get the main JMeter frame.
 JMeterTreeNode getNodeOf(TestElement userObject)
          Find the JMeterTreeNode for a certain TestElement object.
 ValueReplacer getReplacer()
          Get a ValueReplacer for the test tree.
 JMeterTreeListener getTreeListener()
          Get the listener for JMeter's test tree.
 JMeterTreeModel getTreeModel()
          Get the model for JMeter's test tree.
 boolean isDirty()
          Retrieves the state of the 'dirty' property, a flag that indicates if there are test tree components that have been modified since they were last saved.
 void removeNode(TestElement node)
          Remove a test element from the tree.
 void setDirty(boolean dirty)
          The dirty property is a flag that indicates whether there are parts of JMeter's test tree that the user has not saved since last modification.
 void setMainFrame(MainFrame newMainFrame)
          Set the main JMeter frame.
 void setTreeListener(JMeterTreeListener newTreeListener)
          Set the listener for JMeter's test tree.
 void setTreeModel(JMeterTreeModel newTreeModel)
          Set the model for JMeter's test tree.
 void updateCurrentGui()
          Update the GUI for the currently selected node.
 void updateCurrentNode()
          This method should be called in order for GuiPackage to change the current node.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getInstance

public static GuiPackage getInstance()
Retrieve the singleton GuiPackage instance.

Returns:
the GuiPackage instance

getInstance

public static GuiPackage getInstance(JMeterTreeListener listener,
                                     JMeterTreeModel treeModel)
When GuiPackage is requested for the first time, it should be given handles to JMeter's Tree Listener and TreeModel.

Parameters:
listener - the TreeListener for JMeter's test tree
treeModel - the model for JMeter's test tree
Returns:
GuiPackage

getGui

public JMeterGUIComponent getGui(TestElement node)
Get a JMeterGUIComponent for the specified test element. If the GUI has already been created, that instance will be returned. Otherwise, if a GUI component of the same type has been created, and the component is not marked as an UnsharedComponent, that shared component will be returned. Otherwise, a new instance of the component will be created. The TestElement's GUI_CLASS property will be used to determine the appropriate type of GUI component to use.

Parameters:
node - the test element which this GUI is being created for
Returns:
the GUI component corresponding to the specified test element

getGui

public JMeterGUIComponent getGui(TestElement node,
                                 String guiClass)
Get a JMeterGUIComponent for the specified test element. If the GUI has already been created, that instance will be returned. Otherwise, if a GUI component of the same type has been created, and the component is not marked as an UnsharedComponent, that shared component will be returned. Otherwise, a new instance of the component will be created.

Parameters:
node - the test element which this GUI is being created for
guiClass - the fully qualifed class name of the GUI component which will be created if it doesn't already exist
Returns:
the GUI component corresponding to the specified test element

removeNode

public void removeNode(TestElement node)
Remove a test element from the tree. This removes the reference to any associated GUI component.

Parameters:
node - the test element being removed

getCurrentGui

public JMeterGUIComponent getCurrentGui()
Convenience method for grabbing the gui for the current node.

Returns:
the GUI component associated with the currently selected node

getNodeOf

public JMeterTreeNode getNodeOf(TestElement userObject)
Find the JMeterTreeNode for a certain TestElement object.

Parameters:
userObject - the test element to search for
Returns:
the tree node associated with the test element

createTestElement

public TestElement createTestElement(String guiClass)
Create a TestElement corresponding to the specified GUI class.

Parameters:
guiClass - the fully qualified class name of the GUI component
Returns:
the test element corresponding to the specified GUI class.

updateCurrentGui

public void updateCurrentGui()
Update the GUI for the currently selected node. The GUI component is configured to reflect the settings in the current tree node.


updateCurrentNode

public void updateCurrentNode()
This method should be called in order for GuiPackage to change the current node. This will save any changes made to the earlier node before choosing the new node.


setDirty

public void setDirty(boolean dirty)
The dirty property is a flag that indicates whether there are parts of JMeter's test tree that the user has not saved since last modification. Various (@link Command actions) set this property when components are modified/created/saved.

Parameters:
dirty - the new value of the dirty flag

isDirty

public boolean isDirty()
Retrieves the state of the 'dirty' property, a flag that indicates if there are test tree components that have been modified since they were last saved.

Returns:
true if some tree components have been modified since they were last saved, false otherwise

addSubTree

public org.apache.jorphan.collections.HashTree addSubTree(org.apache.jorphan.collections.HashTree subTree)
                                                   throws IllegalUserActionException
Add a subtree to the currently selected node.

Parameters:
subTree - the subtree to add.
Returns:
the resulting subtree starting with the currently selected node
Throws:
IllegalUserActionException - if a subtree cannot be added to the currently selected node

getCurrentSubTree

public org.apache.jorphan.collections.HashTree getCurrentSubTree()
Get the currently selected subtree.

Returns:
the subtree of the currently selected node

getTreeModel

public JMeterTreeModel getTreeModel()
Get the model for JMeter's test tree.

Returns:
the JMeter tree model

setTreeModel

public void setTreeModel(JMeterTreeModel newTreeModel)
Set the model for JMeter's test tree.

Parameters:
newTreeModel - the new JMeter tree model

getReplacer

public ValueReplacer getReplacer()
Get a ValueReplacer for the test tree.

Returns:
a ValueReplacer configured for the test tree

setMainFrame

public void setMainFrame(MainFrame newMainFrame)
Set the main JMeter frame.

Parameters:
newMainFrame - the new JMeter main frame

getMainFrame

public MainFrame getMainFrame()
Get the main JMeter frame.

Returns:
the main JMeter frame

setTreeListener

public void setTreeListener(JMeterTreeListener newTreeListener)
Set the listener for JMeter's test tree.

Parameters:
newTreeListener - the new JMeter test tree listener

getTreeListener

public JMeterTreeListener getTreeListener()
Get the listener for JMeter's test tree.

Returns:
the JMeter test tree listener

displayPopUp

public void displayPopUp(MouseEvent e,
                         JPopupMenu popup)
Display the specified popup menu with the source component and location from the specified mouse event.

Parameters:
e - the mouse event causing this popup to be displayed
popup - the popup menu to display

displayPopUp

public void displayPopUp(Component invoker,
                         MouseEvent e,
                         JPopupMenu popup)
Display the specified popup menu at the location specified by a mouse event with the specified source component.

Parameters:
invoker - the source component
e - the mouse event causing this popup to be displayed
popup - the popup menu to display

Apache JMeter
1.9

Copyright © 1998-2003 Apache Software Foundation. All Rights Reserved.