org.threadly.load

Class ScriptBuilderUtils

java.lang.Object

org.threadly.load.ScriptBuilderUtils

public class ScriptBuilderUtils
extends java.lang.Object

Class for helping in construct more sophisticated test and graph structures.

Constructor Summary

Constructors

Constructor and Description
ScriptBuilderUtils()

Method Summary

Modifier and Type	Method and Description
static ParallelScriptBuilder	balanceBuilders(AbstractScriptBuilder... builders) Balance multiple builder chains to attempt to have them complete at a similar point in time.

Methods inherited from class java.lang.Object

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

Constructor Detail

ScriptBuilderUtils

public ScriptBuilderUtils()

Method Detail

balanceBuilders

public static ParallelScriptBuilder balanceBuilders(AbstractScriptBuilder... builders)

Balance multiple builder chains to attempt to have them complete at a similar point in time. This attempts to do such by looking at the longest step chain provided, and then make all the smaller step chains introduce pauses, progressing only as the longest chain progresses. This does not mean that the chains will absolutely complete at the same time, depending on the variations in step invocation time, there will be variations on chain completion time. For example if a chain has few steps, but long execution times, this will do nothing to ensure a consistent rate. This can be very useful if your trying to reproduce production like traffic. For example you could create a parallel chain for each API endpoint. You can have the count of each script builder (and thus each endpoint) in proportion based off your production usage. This will then be reproducing these calls in proportion, rather than just let the short chains end fast. An alternate method to produce a similar result, that may be more suited for same cases (for example when step invocation time varies dramatically), would be to allow all chains to execute freely, timing how long each chain takes. Then apply a rate limit on chains which completed too fast via AbstractScriptBuilder.setMaxScriptStepRate(double) so that the faster chains end up completing at the same time as the longest chain. This would have less overhead, but requires more manual effort, and also wont be able to balance the chains based off real time delays (which may be unexpected).

Parameters:

builders - Builders to inspect and apply flow control to attempt similar execution durations

Returns:

A parallel script builder to execute the provided, and now replaced script builders