Apache JMeter
2.0.1.20050615

org.apache.jmeter.control
Class IfController

java.lang.Object
  extended byorg.apache.jmeter.testelement.AbstractTestElement
      extended byorg.apache.jmeter.control.GenericController
          extended byorg.apache.jmeter.control.IfController
All Implemented Interfaces:
Cloneable, Controller, Serializable, TestElement

public class IfController
extends GenericController
implements Serializable

Version:
$Date: 2004/10/06 01:58:00 $ $Revision: 1.3.2.2 $ This is a Conditional Controller; it will execute the set of statements (samplers/controllers, etc) while the 'condition' is true. In a programming world - this is equivalant of : if (condition) { statements .... } In JMeter you may have : Thread-Group (set to loop a number of times or indefinitely, ... Samplers ... (e.g. Counter ) ... Other Controllers .... ... IfController ( condition set to something like - ${counter}<10) ... statements to perform if condition is true ... ... Other Controllers /Samplers }
Author:
Cyrus Montakab created 2003/06/30
See Also:
Serialized Form

Nested Class Summary
static class IfController.Test
          JUnit test
 
Field Summary
 
Fields inherited from class org.apache.jmeter.control.GenericController
current, iterationListeners, subControllersAndSamplers
 
Fields inherited from interface org.apache.jmeter.testelement.TestElement
ENABLED, GUI_CLASS, NAME, TEST_CLASS
 
Constructor Summary
IfController()
          constructor
IfController(String condition)
          constructor
 
Method Summary
 String getCondition()
          Condition Accessor - this is gonna be like ${count}<10
 boolean isDone()
          This is overriding the parent method.
 Sampler next()
          Delivers the next Sampler.
 void setCondition(String condition)
          Condition Accessor - this is gonna be like ${count}<10
 
Methods inherited from class org.apache.jmeter.control.GenericController
addIterationListener, addTestElement, currentReturnedNull, fireIterationStart, fireIterEvents, getCurrentElement, getIterCount, getSubControllers, incrementCurrent, incrementIterCount, initialize, isFirst, nextIsAController, nextIsASampler, nextIsNull, reInitialize, removeCurrentElement, resetCurrent, resetIterCount, setCurrentElement, setDone, setFirst
 
Methods inherited from class org.apache.jmeter.testelement.AbstractTestElement
addProperty, canRemove, clear, clearTemporary, clone, emptyTemporary, equals, getName, getProperty, getPropertyAsBoolean, getPropertyAsBoolean, getPropertyAsDouble, getPropertyAsFloat, getPropertyAsInt, getPropertyAsLong, getPropertyAsString, getThreadContext, getThreadName, isRunningVersion, isTemporary, logProperties, mergeIn, propertyIterator, recoverRunningVersion, removeProperty, setName, setProperty, setProperty, setRunningVersion, setTemporary, setThreadContext, setThreadName, threadFinished, threadStarted, traverse, traverseCollection, traverseMap, traverseProperty
 
Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.apache.jmeter.testelement.TestElement
canRemove, clear, clone, getProperty, getPropertyAsBoolean, getPropertyAsFloat, getPropertyAsInt, getPropertyAsLong, getPropertyAsString, getThreadContext, getThreadName, isRunningVersion, isTemporary, propertyIterator, recoverRunningVersion, removeProperty, setProperty, setProperty, setRunningVersion, setTemporary, setThreadContext, setThreadName, threadFinished, threadStarted, traverse
 

Constructor Detail

IfController

public IfController()
constructor


IfController

public IfController(String condition)
constructor

Method Detail

setCondition

public void setCondition(String condition)
Condition Accessor - this is gonna be like ${count}<10


getCondition

public String getCondition()
Condition Accessor - this is gonna be like ${count}<10


isDone

public boolean isDone()
This is overriding the parent method. IsDone indicates whether the termination condition is reached. I.e. if the condition evaluates to False - then isDone() returns TRUE

Specified by:
isDone in interface Controller
Overrides:
isDone in class GenericController
See Also:
Controller.isDone()

next

public Sampler next()
Description copied from interface: Controller
Delivers the next Sampler.

Specified by:
next in interface Controller
Overrides:
next in class GenericController
See Also:
'JMeterThread' iterates thru the Controller by calling this method. IF a valid 'Sampler' is returned, then it executes the sampler (calls sampler.sampler(xxx) method) . So here we make sure that the samplers belonging to this Controller do not get called - if isDone is true - if its the first time this is run. The first time is special cause it is called prior the iteration even starts !

Apache JMeter
2.0.1.20050615

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