// $Header: /home/cvs/jakarta-jmeter/src/core/org/apache/jmeter/control/gui/RunTimeGui.java,v 1.1.2.1 2004/06/03 00:08:36 sebb Exp $
/*
* Copyright 2000-2004 The Apache Software Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
package org.apache.jmeter.control.gui;
import java.awt.BorderLayout;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import javax.swing.Box;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.JTextField;
import org.apache.jmeter.control.RunTime;
import org.apache.jmeter.testelement.TestElement;
import org.apache.jmeter.util.JMeterUtils;
/**
* The user interface for a controller which specifies that its subcomponents
* should be executed some number of seconds in a loop. This component can be
* used standalone or embedded into some other component.
*
* @version $Revision: 1.1.2.1 $ on $Date: 2004/06/03 00:08:36 $
*/
public class RunTimeGui
extends AbstractControllerGui
implements ActionListener
{
/**
* A field allowing the user to specify the number of seconds the controller
* should loop.
*/
private JTextField seconds;
/**
* Boolean indicating whether or not this component should display its
* name. If true, this is a standalone component. If false, this component
* is intended to be used as a subpanel for another component.
*/
private boolean displayName = true;
/** The name of the seconds field component. */
private static final String SECONDS = "Seconds Field";
/**
* Create a new LoopControlPanel as a standalone component.
*/
public RunTimeGui()
{
this(true);
}
/**
* Create a new LoopControlPanel as either a standalone or an embedded
* component.
*
* @param displayName indicates whether or not this component should
* display its name. If true, this is a standalone
* component. If false, this component is intended
* to be used as a subpanel for another component.
*/
public RunTimeGui(boolean displayName)
{
this.displayName = displayName;
init();
setState(1);
}
/**
* A newly created component can be initialized with the contents of
* a Test Element object by calling this method. The component is
* responsible for querying the Test Element object for the
* relevant information to display in its GUI.
*
* @param element the TestElement to configure
*/
public void configure(TestElement element)
{
super.configure(element);
if (element instanceof RunTime)
{
setState(((RunTime) element).getRuntimeString());
}
else
{
setState(1);
}
}
/* Implements JMeterGUIComponent.createTestElement() */
public TestElement createTestElement()
{
RunTime lc = new RunTime();
modifyTestElement(lc);
return lc;
}
/* Implements JMeterGUIComponent.modifyTestElement(TestElement) */
public void modifyTestElement(TestElement lc)
{
configureTestElement(lc);
if (lc instanceof RunTime)
{
if (seconds.getText().length() > 0)
{
((RunTime) lc).setRuntime(seconds.getText());
}
else
{
((RunTime) lc).setRuntime(0);
}
}
}
/**
* Invoked when an action occurs. This implementation assumes that the
* target component is the infinite seconds checkbox.
*
* @param event the event that has occurred
*/
public void actionPerformed(ActionEvent event)
{
seconds.setEnabled(true);
}
public String getLabelResource()
{
return "runtime_controller_title";
}
/**
* Initialize the GUI components and layout for this component.
*/
private void init()
{
// The Loop Controller panel can be displayed standalone or inside
// another panel. For standalone, we want to display the TITLE, NAME,
// etc. (everything). However, if we want to display it within another
// panel, we just display the Loop Count fields (not the TITLE and
// NAME).
// Standalone
if (displayName)
{
setLayout(new BorderLayout(0, 5));
setBorder(makeBorder());
add(makeTitlePanel(), BorderLayout.NORTH);
JPanel mainPanel = new JPanel(new BorderLayout());
mainPanel.add(createLoopCountPanel(), BorderLayout.NORTH);
add(mainPanel, BorderLayout.CENTER);
}
else
{
// Embedded
setLayout(new BorderLayout());
add(createLoopCountPanel(), BorderLayout.NORTH);
}
}
/**
* Create a GUI panel containing the components related to the number of
* seconds which should be executed.
*
* @return a GUI panel containing the loop count components
*/
private JPanel createLoopCountPanel()
{
JPanel loopPanel = new JPanel(new BorderLayout(5, 0));
// SECONDS LABEL
JLabel secondsLabel =
new JLabel(JMeterUtils.getResString("runtime_seconds"));
loopPanel.add(secondsLabel, BorderLayout.WEST);
JPanel loopSubPanel = new JPanel(new BorderLayout(5, 0));
// TEXT FIELD
seconds = new JTextField("60", 5);
secondsLabel.setLabelFor(seconds);
loopSubPanel.add(seconds, BorderLayout.CENTER);
loopPanel.add(loopSubPanel,BorderLayout.CENTER);
loopPanel.add(
Box.createHorizontalStrut(
secondsLabel.getPreferredSize().width
+ seconds.getPreferredSize().width),
BorderLayout.NORTH);
return loopPanel;
}
/**
* Set the number of seconds which should be reflected in the GUI. The
* secsCount parameter should contain the String representation of an
* integer. This integer will be treated as the number of seconds. If this
* integer is less than 0, the number of seconds will be assumed to be
* infinity.
*
* @param secsCount the String representation of the number of seconds
*/
private void setState(String secsCount)
{
seconds.setText(secsCount);
seconds.setEnabled(true);
}
/**
* Set the number of seconds which should be reflected in the GUI. If the
* secsCount is less than 0, the number of seconds will be assumed to be
* infinity.
*
* @param secsCount the number of seconds
*/
private void setState(long secsCount)
{
seconds.setEnabled(true);
seconds.setText("" + secsCount);
}
}