us.abstracta.jmeter.javadsl.parallel

Class ParallelController

java.lang.Object

us.abstracta.jmeter.javadsl.core.testelements.BaseTestElement

us.abstracta.jmeter.javadsl.core.testelements.TestElementContainer<T,BaseThreadGroup.ThreadGroupChild>

us.abstracta.jmeter.javadsl.core.controllers.BaseController<ParallelController>

us.abstracta.jmeter.javadsl.parallel.ParallelController

All Implemented Interfaces:

DslController, DslTestElement, BaseThreadGroup.ThreadGroupChild

public class ParallelController
extends BaseController<ParallelController>

Allows grouping requests that need to execute in parallel.

This element uses Parallel Controller plugin, check its documentation for more details.

By default, this element executes unlimited amount of parallel requests ang generate no additional sample result. Check provided methods to change this behavior.

Since:

0.30

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ParallelController.CodeBuilder

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_NAME
protected boolean	generateParent
protected Integer	maxThreads

Fields inherited from class us.abstracta.jmeter.javadsl.core.testelements.TestElementContainer

children

Fields inherited from class us.abstracta.jmeter.javadsl.core.testelements.BaseTestElement

guiClass, name

Constructor Summary

Constructors

Constructor and Description
ParallelController(String name, List<BaseThreadGroup.ThreadGroupChild> children)

Method Summary

Modifier and Type	Method and Description
protected org.apache.jmeter.testelement.TestElement	buildTestElement()
ParallelController	generateParentSample() Specifies whether to generate a sample result containing children elements results as sub results.
ParallelController	generateParentSample(boolean enable) Same as generateParentSample() but allowing to enable and disable the setting.
ParallelController	maxThreads(int maxThreads) Allows limiting the number of threads used to execute children elements in parallel.
static ParallelController	parallelController() Same as #parallelController(ThreadGroupChild...) but postponing children specification to allow specifying additional settings first.
static ParallelController	parallelController(BaseThreadGroup.ThreadGroupChild... children) Builds a Parallel Controller executing the given children elements in parallel.
static ParallelController	parallelController(String name) Same as #parallelController(String, ThreadGroupChild...) but postponing children specification to allow specifying additional settings first.
static ParallelController	parallelController(String name, BaseThreadGroup.ThreadGroupChild... children) Same as #parallelController(ThreadGroupChild...) but allowing to set a name on controller.

Methods inherited from class us.abstracta.jmeter.javadsl.core.controllers.BaseController

children

Methods inherited from class us.abstracta.jmeter.javadsl.core.testelements.TestElementContainer

buildTreeUnder

Methods inherited from class us.abstracta.jmeter.javadsl.core.testelements.BaseTestElement

buildConfiguredTestElement, buildTestElementGui, configureTestElement, durationToSeconds, loadBeanProperties, showAndWaitFrameWith, showFrameWith, showInGui, showTestElementGui

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface us.abstracta.jmeter.javadsl.core.DslTestElement

buildTreeUnder, showInGui

Field Detail

DEFAULT_NAME

public static final String DEFAULT_NAME

See Also:

Constant Field Values

generateParent

protected boolean generateParent

maxThreads

protected Integer maxThreads

Constructor Detail

ParallelController

public ParallelController(String name,
                          List<BaseThreadGroup.ThreadGroupChild> children)

Method Detail

parallelController

public static ParallelController parallelController(BaseThreadGroup.ThreadGroupChild... children)

Builds a Parallel Controller executing the given children elements in parallel.

Parameters:

children - test elements to execute in parallel.

Returns:

the Parallel Controller for additional configuration and usage.

parallelController

public static ParallelController parallelController(String name,
                                                    BaseThreadGroup.ThreadGroupChild... children)

Same as #parallelController(ThreadGroupChild...) but allowing to set a name on controller.

Setting the name of the controller is particularly useful when using generateParentSample(boolean) to focus on transaction steps and properly identify associated metrics.

Parameters:

name - is the label assigned to the Parallel Controller, which will appear in collected metrics when generateParentSample(boolean) is used.

children - test elements to execute in parallel.

Returns:

the controller for further configuration or usage.

See Also:

#parallelController(ThreadGroupChild...)

parallelController

public static ParallelController parallelController()

Same as #parallelController(ThreadGroupChild...) but postponing children specification to allow specifying additional settings first.

Returns:

the controller for further configuration or usage.

Since:

0.30.1

See Also:

#parallelController(ThreadGroupChild...)

parallelController

public static ParallelController parallelController(String name)

Same as #parallelController(String, ThreadGroupChild...) but postponing children specification to allow specifying additional settings first.

Returns:

the controller for further configuration or usage.

Since:

0.30.1

See Also:

#parallelController(String, ThreadGroupChild...)

generateParentSample

public ParallelController generateParentSample()

Specifies whether to generate a sample result containing children elements results as sub results.

Take into consideration that when this option is enabled, then only the parallel controller sample result metrics will appear in metrics like summary results and similar. When generate parent sample is used, consider always using a name for the controller to properly identify it in collected metrics.

Returns:

the controller for further configuration or usage.

Since:

1.0

generateParentSample

public ParallelController generateParentSample(boolean enable)

Same as generateParentSample() but allowing to enable and disable the setting.

This is helpful when the resolution is taken at runtime.

Parameters:

enable - specifies to enable or disable the setting. By default, it is set to false.

Returns:

the controller for further configuration or usage.

See Also:

generateParentSample()

maxThreads

public ParallelController maxThreads(int maxThreads)

Allows limiting the number of threads used to execute children elements in parallel.

Parameters:

maxThreads - number of threads to use. When not specified, no limit is set.

Returns:

the controller for further configuration or usage.

buildTestElement

protected org.apache.jmeter.testelement.TestElement buildTestElement()

Specified by:

buildTestElement in class BaseTestElement