org.threadly.load

Class ExecutableScript

java.lang.Object

org.threadly.load.ExecutableScript

public class ExecutableScript
extends java.lang.Object

This class handles the execution of a completely generated execution script.

Constructor Summary

Constructors

Constructor and Description
ExecutableScript(int neededThreadQty, org.threadly.load.ExecutableScript.ExecutionItem startExecutionItem) Constructs a new ExecutableScript.

Method Summary

Modifier and Type	Method and Description
int	getThreadQtyNeeded() Returns how many threads will be started when the script is executed.
java.util.List<org.threadly.concurrent.future.ListenableFuture<StepResult>>	startScript() Starts the execution of the script.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecutableScript

public ExecutableScript(int neededThreadQty,
                        org.threadly.load.ExecutableScript.ExecutionItem startExecutionItem)

Constructs a new ExecutableScript. If the minimum threads needed don't match the execution graph provided, it may restrict load, or never complete. Execution will not proceed to the next step until the previous step has fully completed.

Parameters:

neededThreadQty - Minimum number of threads to execute provided steps

startExecutionItem - Execution item which represents the script

Method Detail

getThreadQtyNeeded

public int getThreadQtyNeeded()

Returns how many threads will be started when the script is executed.

Returns:

Number of threads needed to run script as provided

startScript

public java.util.List<org.threadly.concurrent.future.ListenableFuture<StepResult>> startScript()

Starts the execution of the script. It will traverse through the execution graph an execute things as previously defined by using the builder. This returns a collection of futures. If an execution step was executed, the future will return a StepResult. That StepResult will indicate either a successful or failure in execution. If a failure does occur then future test steps will NOT be executed. If a step was never executed due to a failure, those futures will be resolved in an error (thus calls to Future.get() will throw a ExecutionException). You can use StepResultCollectionUtils.getFailedResult(java.util.Collection) to see if any steps failed. This will block till all steps have completed (or a failed test step occurred). If StepResultCollectionUtils.getFailedResult(java.util.Collection) returns null, then the test completed without error.

Returns:

A collection of futures which will represent each execution step