Class ThroughputController
- java.lang.Object
-
- org.apache.jmeter.testelement.AbstractTestElement
-
- org.apache.jmeter.control.GenericController
-
- org.apache.jmeter.control.ThroughputController
-
- All Implemented Interfaces:
Serializable
,Cloneable
,Controller
,LoopIterationListener
,Searchable
,TestElement
,TestStateListener
,TestCompilerHelper
public class ThroughputController extends GenericController implements Serializable, LoopIterationListener, TestStateListener
This class represents a controller that can control the number of times that it is executed, either by the total number of times the user wants the controller executed (BYNUMBER) or by the percentage of time it is called (BYPERCENT) The current implementation executes the first N samples (BYNUMBER) or the last N% of samples (BYPERCENT).- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static int
BYNUMBER
static int
BYPERCENT
-
Fields inherited from class org.apache.jmeter.control.GenericController
current, subControllersAndSamplers
-
Fields inherited from interface org.apache.jmeter.testelement.TestElement
COMMENTS, ENABLED, GUI_CLASS, NAME, TEST_CLASS
-
-
Constructor Summary
Constructors Constructor Description ThroughputController()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Object
clone()
String
getMaxThroughput()
protected int
getMaxThroughputAsInt()
String
getPercentThroughput()
protected float
getPercentThroughputAsFloat()
int
getStyle()
boolean
isDone()
Indicates whether the Controller is done delivering Samplers for the rest of the test.boolean
isPerThread()
void
iterationStart(LoopIterationEvent iterEvent)
Called when a loop iteration is about to start.Sampler
next()
Determines the next sampler to be processed.protected Object
readResolve()
void
setMaxThroughput(int maxThroughput)
void
setMaxThroughput(String maxThroughput)
void
setPercentThroughput(float percentThroughput)
void
setPercentThroughput(String percentThroughput)
void
setPerThread(boolean perThread)
void
setStyle(int style)
void
testEnded()
Called once for all threads after the end of a test.void
testEnded(String host)
Called once for all threads after the end of a test.void
testStarted()
Called just before the start of the test from the main engine thread.void
testStarted(String host)
Called just before the start of the test from the main engine thread.-
Methods inherited from class org.apache.jmeter.control.GenericController
addIterationListener, addTestElement, addTestElementOnce, currentReturnedNull, fireIterationStart, fireIterEvents, getCurrentElement, getIterCount, getSubControllers, incrementCurrent, incrementIterCount, initialize, initializeSubControllers, isFirst, nextIsAController, nextIsASampler, nextIsNull, reInitialize, reInitializeSubController, removeCurrentElement, removeIterationListener, resetCurrent, resetIterCount, setCurrentElement, setDone, setFirst, triggerEndOfLoop
-
Methods inherited from class org.apache.jmeter.testelement.AbstractTestElement
addPropertiesValues, addProperty, addProperty, canRemove, clear, clearTemporary, clearTestElementChildren, emptyTemporary, equals, getComment, getName, getProperty, getPropertyAsBoolean, getPropertyAsBoolean, getPropertyAsDouble, getPropertyAsFloat, getPropertyAsInt, getPropertyAsInt, getPropertyAsLong, getPropertyAsLong, getPropertyAsString, getPropertyAsString, getSearchableTokens, getThreadContext, getThreadName, hashCode, isEnabled, isRunningVersion, isTemporary, logProperties, mergeIn, propertyIterator, recoverRunningVersion, removeProperty, setComment, setEnabled, setName, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setRunningVersion, setTemporary, setThreadContext, setThreadName, traverse, traverseCollection, traverseMap, traverseProperty
-
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.apache.jmeter.testelement.TestElement
canRemove, clear, clearTestElementChildren, getComment, getName, getProperty, getPropertyAsBoolean, getPropertyAsBoolean, getPropertyAsDouble, getPropertyAsFloat, getPropertyAsInt, getPropertyAsInt, getPropertyAsLong, getPropertyAsLong, getPropertyAsString, getPropertyAsString, getThreadContext, getThreadName, isEnabled, isRunningVersion, isTemporary, propertyIterator, recoverRunningVersion, removeProperty, setComment, setEnabled, setName, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setRunningVersion, setTemporary, setThreadContext, setThreadName, traverse
-
-
-
-
Field Detail
-
BYNUMBER
public static final int BYNUMBER
- See Also:
- Constant Field Values
-
BYPERCENT
public static final int BYPERCENT
- See Also:
- Constant Field Values
-
-
Method Detail
-
setStyle
public void setStyle(int style)
-
getStyle
public int getStyle()
-
setPerThread
public void setPerThread(boolean perThread)
-
isPerThread
public boolean isPerThread()
-
setMaxThroughput
public void setMaxThroughput(int maxThroughput)
-
setMaxThroughput
public void setMaxThroughput(String maxThroughput)
-
getMaxThroughput
public String getMaxThroughput()
-
getMaxThroughputAsInt
protected int getMaxThroughputAsInt()
-
setPercentThroughput
public void setPercentThroughput(float percentThroughput)
-
setPercentThroughput
public void setPercentThroughput(String percentThroughput)
-
getPercentThroughput
public String getPercentThroughput()
-
getPercentThroughputAsFloat
protected float getPercentThroughputAsFloat()
-
next
public Sampler next()
Description copied from class:GenericController
Determines the next sampler to be processed.
If
GenericController.isDone()
istrue
, returns null.Gets the list element using current pointer. If this is
null
, callsGenericController.nextIsNull()
.If the list element is a
Sampler
, callsGenericController.nextIsASampler(Sampler)
, otherwise callsGenericController.nextIsAController(Controller)
If any of the called methods throws
NextIsNullException
, returnsnull
, otherwise the value obtained above is returned.- Specified by:
next
in interfaceController
- Overrides:
next
in classGenericController
- Returns:
- the next sampler or
null
- See Also:
Controller.next()
-
isDone
public boolean isDone()
Description copied from interface:Controller
Indicates whether the Controller is done delivering Samplers for the rest of the test. When the top-level controller returns true to JMeterThread, the thread is complete.- Specified by:
isDone
in interfaceController
- Overrides:
isDone
in classGenericController
- Returns:
- boolean
- See Also:
Controller.isDone()
-
clone
public Object clone()
- Specified by:
clone
in interfaceTestElement
- Overrides:
clone
in classAbstractTestElement
-
iterationStart
public void iterationStart(LoopIterationEvent iterEvent)
Description copied from interface:LoopIterationListener
Called when a loop iteration is about to start.- Specified by:
iterationStart
in interfaceLoopIterationListener
- Parameters:
iterEvent
- the event
-
testStarted
public void testStarted()
Description copied from interface:TestStateListener
Called just before the start of the test from the main engine thread. This is before the test elements are cloned. Note that not all the test variables will have been set up at this point.
N.B. testStarted() and testEnded() are called from different threads.
- Specified by:
testStarted
in interfaceTestStateListener
- See Also:
StandardJMeterEngine.run()
-
testStarted
public void testStarted(String host)
Description copied from interface:TestStateListener
Called just before the start of the test from the main engine thread. This is before the test elements are cloned. Note that not all the test variables will have been set up at this point.
N.B. testStarted() and testEnded() are called from different threads.
- Specified by:
testStarted
in interfaceTestStateListener
- Parameters:
host
- name of host- See Also:
StandardJMeterEngine.run()
-
testEnded
public void testEnded()
Description copied from interface:TestStateListener
Called once for all threads after the end of a test. This will use the same element instances as at the start of the test.
N.B. testStarted() and testEnded() are called from different threads.
- Specified by:
testEnded
in interfaceTestStateListener
- See Also:
StandardJMeterEngine.stopTest()
-
testEnded
public void testEnded(String host)
Description copied from interface:TestStateListener
Called once for all threads after the end of a test. This will use the same element instances as at the start of the test.
N.B. testStarted() and testEnded() are called from different threads.
- Specified by:
testEnded
in interfaceTestStateListener
- Parameters:
host
- name of host- See Also:
StandardJMeterEngine.stopTest()
-
readResolve
protected Object readResolve()
- Overrides:
readResolve
in classGenericController
-
-