org.apache.jmeter.control

Class CriticalSectionController

java.lang.Object

org.apache.jmeter.testelement.AbstractTestElement

org.apache.jmeter.control.GenericController

org.apache.jmeter.control.CriticalSectionController

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, org.apache.jmeter.control.Controller, org.apache.jmeter.gui.Searchable, org.apache.jmeter.testelement.TestElement, org.apache.jmeter.testelement.TestStateListener, org.apache.jmeter.testelement.ThreadListener, org.apache.jmeter.threads.TestCompilerHelper

public class CriticalSectionController
extends org.apache.jmeter.control.GenericController
implements org.apache.jmeter.testelement.ThreadListener, org.apache.jmeter.testelement.TestStateListener

This is a Critical Section Controller; it will execute the set of statements (samplers/controllers, etc) under named lock.

In a programming world - this is equivalent of :

 try {
          named_lock.lock();
          statements ....
 } finally {
          named_lock.unlock();
 }
 

In JMeter you may have :

 Thread-Group (set to loop a number of times or indefinitely,
    ... Samplers ... (e.g. Counter )
    ... Other Controllers ....
    ... CriticalSectionController ( lock name like "foobar" )
       ... statements to perform when lock acquired
       ...
    ... Other Controllers /Samplers }
 

Since:

2.12

See Also:

Serialized Form

Field Summary

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 and Description
CriticalSectionController() constructor
CriticalSectionController(java.lang.String name) constructor

Method Summary

Modifier and Type	Method and Description
java.lang.String	getLockName()
org.apache.jmeter.samplers.Sampler	next()
protected void	reInitialize() Called after execution of last child of the controller We release lock
void	setLockName(java.lang.String name) Condition Accessor - this is gonna be any string value
void	testEnded()
void	testEnded(java.lang.String host)
void	testStarted()
void	testStarted(java.lang.String host)
void	threadFinished()
void	threadStarted()

Methods inherited from class org.apache.jmeter.control.GenericController

addIterationListener, addTestElement, addTestElementOnce, currentReturnedNull, fireIterationStart, fireIterEvents, getCurrentElement, getIterCount, getSubControllers, incrementCurrent, incrementIterCount, initialize, initializeSubControllers, isDone, isFirst, nextIsAController, nextIsASampler, nextIsNull, readResolve, removeCurrentElement, removeIterationListener, resetCurrent, resetIterCount, setCurrentElement, setDone, setFirst, triggerEndOfLoop

Methods inherited from class org.apache.jmeter.testelement.AbstractTestElement

addPropertiesValues, addProperty, addProperty, canRemove, clear, clearTemporary, clearTestElementChildren, clone, 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, clone, getComment, getName, getProperty, getPropertyAsBoolean, getPropertyAsBoolean, getPropertyAsDouble, getPropertyAsFloat, getPropertyAsInt, getPropertyAsInt, getPropertyAsLong, getPropertyAsLong, getPropertyAsString, getPropertyAsString, getThreadContext, getThreadName, isEnabled, isRunningVersion, isTemporary, propertyIterator, recoverRunningVersion, removed, removeProperty, setComment, setEnabled, setName, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setRunningVersion, setTemporary, setThreadContext, setThreadName, traverse

Constructor Detail

CriticalSectionController

public CriticalSectionController()

constructor

CriticalSectionController

public CriticalSectionController(java.lang.String name)

constructor

Parameters:

name - The name of this controller

Method Detail

setLockName

public void setLockName(java.lang.String name)

Condition Accessor - this is gonna be any string value

Parameters:

name - The name of the lock for this controller

getLockName

public java.lang.String getLockName()

Returns:

String lock name

next

public org.apache.jmeter.samplers.Sampler next()

Specified by:

next in interface org.apache.jmeter.control.Controller

Overrides:

next in class org.apache.jmeter.control.GenericController

See Also:

Controller.next()

reInitialize

protected void reInitialize()

Called after execution of last child of the controller We release lock

Overrides:

reInitialize in class org.apache.jmeter.control.GenericController

See Also:

GenericController.reInitialize()

threadStarted

public void threadStarted()

Specified by:

threadStarted in interface org.apache.jmeter.testelement.ThreadListener

threadFinished

public void threadFinished()

Specified by:

threadFinished in interface org.apache.jmeter.testelement.ThreadListener

testStarted

public void testStarted()

Specified by:

testStarted in interface org.apache.jmeter.testelement.TestStateListener

testStarted

public void testStarted(java.lang.String host)

Specified by:

testStarted in interface org.apache.jmeter.testelement.TestStateListener

testEnded

public void testEnded()

Specified by:

testEnded in interface org.apache.jmeter.testelement.TestStateListener

testEnded

public void testEnded(java.lang.String host)

Specified by:

testEnded in interface org.apache.jmeter.testelement.TestStateListener