Package org.btrplace.safeplace.testing.fuzzer

Class DefaultFuzzer

java.lang.Object

org.btrplace.safeplace.testing.fuzzer.DefaultFuzzer

All Implemented Interfaces:

Supplier<TestCase>, ConfigurableFuzzer, Fuzzer

public class DefaultFuzzer
extends Object
implements ConfigurableFuzzer

Default implementation of a fuzzer.

Author:

Fabien Hermenier

Constructor Summary

Constructors

Constructor	Description
DefaultFuzzer(Tester t, Constraint toTest, List<Constraint> pre)	Make a new fuzzer.

Method Summary

Modifier and Type	Method	Description
ConfigurableFuzzer	dstOffNodes(double ratio)	Set the ratio of nodes OFFLINE at the END of the reconfiguration
ConfigurableFuzzer	dstVMs(int ready, int running, int sleeping)	Set the distribution of VM final state.
ConfigurableFuzzer	durations(int min, int max)	Set the bounds for the action duration
TestCase	get()
long	lastFuzzingDuration()	The duration of the fuzzing stage.
int	lastFuzzingIterations()	The number of fuzzing iterations to get a valid test case.
long	lastValidationDuration()	The duration of the validation stage.
ConfigurableFuzzer	nodes(int nb)	Set the number of nodes inside the plan.
ConfigurableFuzzer	restriction(Set<Restriction> domain)	Set the restriction domain for the constraint to fuzz.
DefaultFuzzer	save(Writer w)	Write the generated test cases for a later replay.
DefaultFuzzer	save(String path)	Write the generated test cases for a later replay.
ConfigurableFuzzer	srcOffNodes(double ratio)	Set the ratio of nodes initially OFFLINE.
ConfigurableFuzzer	srcVMs(int ready, int running, int sleeping)	Set the distribution of VM initial state.
ConfigurableFuzzer	vms(int nb)	Set the number of VMs inside the plan.
ConfigurableFuzzer	with(String var, int val)	Set the value for a constraint int argument.
ConfigurableFuzzer	with(String var, int[] vals)	Set the domain for a constraint int argument.
ConfigurableFuzzer	with(String var, int min, int max)	Set the domain for a constraint int argument.
ConfigurableFuzzer	with(String arg, String val)	Set the value for a constraint String argument.
ConfigurableFuzzer	with(String arg, String[] vals)	Set the domain for a constraint String argument.
ConfigurableFuzzer	with(String arg, Domain d)	Set the domain for a constraint argument.
ConfigurableFuzzer	with(FuzzerDecorator f)	Add a decorator.

Methods inherited from class java.lang.Object

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

Constructor Details

DefaultFuzzer

public DefaultFuzzer(Tester t, Constraint toTest, List<Constraint> pre)

Make a new fuzzer.

Parameters:

t - the tester to use to validate the test case

toTest - the constraint to test inside the test cases

pre - the constraint to use to validate the generate test case

Method Details

lastFuzzingDuration

public long lastFuzzingDuration()

Description copied from interface: Fuzzer

The duration of the fuzzing stage.

Specified by:

lastFuzzingDuration in interface Fuzzer

Returns:

a duration in millisecond

lastValidationDuration

public long lastValidationDuration()

Description copied from interface: Fuzzer

The duration of the validation stage.

Specified by:

lastValidationDuration in interface Fuzzer

Returns:

a duration in millisecond

lastFuzzingIterations

public int lastFuzzingIterations()

Description copied from interface: Fuzzer

The number of fuzzing iterations to get a valid test case.

Specified by:

lastFuzzingIterations in interface Fuzzer

Returns:

an integer

get

public TestCase get()

Specified by:

get in interface Supplier<TestCase>

with

public ConfigurableFuzzer with(String var, int val)

Description copied from interface: ConfigurableFuzzer

Set the value for a constraint int argument.

Specified by:

with in interface ConfigurableFuzzer

Parameters:

var - the argument name

val - the value

Returns:

this

with

public ConfigurableFuzzer with(String var, int min, int max)

Description copied from interface: ConfigurableFuzzer

Set the domain for a constraint int argument. The fuzzer will pick a value among this domain

Specified by:

with in interface ConfigurableFuzzer

Parameters:

var - the argument name

min - the lower bound

max - the upper bound

Returns:

this

with

public ConfigurableFuzzer with(String var, int[] vals)

Description copied from interface: ConfigurableFuzzer

Set the domain for a constraint int argument. The fuzzer will pick a value among this domain

Specified by:

with in interface ConfigurableFuzzer

Parameters:

var - the argument name

vals - the possible values

Returns:

this

with

public ConfigurableFuzzer with(String arg, String val)

Description copied from interface: ConfigurableFuzzer

Set the value for a constraint String argument.

Specified by:

with in interface ConfigurableFuzzer

Parameters:

arg - the argument name

val - the value

Returns:

this

with

public ConfigurableFuzzer with(String arg, String[] vals)

Description copied from interface: ConfigurableFuzzer

Set the domain for a constraint String argument. The fuzzer will pick a value among this domain

Specified by:

with in interface ConfigurableFuzzer

Parameters:

arg - the argument name

vals - the possible values

Returns:

this

with

public ConfigurableFuzzer with(String arg, Domain d)

Description copied from interface: ConfigurableFuzzer

Set the domain for a constraint argument. The fuzzer will pick a value among this domain

Specified by:

with in interface ConfigurableFuzzer

Parameters:

arg - the argument name

d - the argument domain

Returns:

this

restriction

public ConfigurableFuzzer restriction(Set<Restriction> domain)

Description copied from interface: ConfigurableFuzzer

Set the restriction domain for the constraint to fuzz. The fuzzer will pick a value among this domain

Specified by:

restriction in interface ConfigurableFuzzer

Parameters:

domain - the domain

Returns:

this

save

public DefaultFuzzer save(Writer w)

Description copied from interface: ConfigurableFuzzer

Write the generated test cases for a later replay. Each TestCase is serialised to a JSON format. One line per test case.

Specified by:

save in interface ConfigurableFuzzer

Parameters:

w - the output stream

Returns:

this

See Also:

to provide the saved test cases

save

public DefaultFuzzer save(String path)

Description copied from interface: ConfigurableFuzzer

Write the generated test cases for a later replay.

Specified by:

save in interface ConfigurableFuzzer

Parameters:

path - the output file

Returns:

this

See Also:

ConfigurableFuzzer.save(Writer)

vms

public ConfigurableFuzzer vms(int nb)

Description copied from interface: ConfigurableFuzzer

Set the number of VMs inside the plan.

Specified by:

vms in interface ConfigurableFuzzer

Parameters:

nb - a number >= 0

Returns:

this

nodes

public ConfigurableFuzzer nodes(int nb)

Description copied from interface: ConfigurableFuzzer

Set the number of nodes inside the plan.

Specified by:

nodes in interface ConfigurableFuzzer

Parameters:

nb - a number >= 0

Returns:

this

with

public ConfigurableFuzzer with(FuzzerDecorator f)

Description copied from interface: ConfigurableFuzzer

Add a decorator. It will be called once the initial plan generated.

Specified by:

with in interface ConfigurableFuzzer

Parameters:

f - the decorator to add

Returns:

this

srcOffNodes

public ConfigurableFuzzer srcOffNodes(double ratio)

Description copied from interface: ConfigurableFuzzer

Set the ratio of nodes initially OFFLINE.

Specified by:

srcOffNodes in interface ConfigurableFuzzer

Parameters:

ratio - a number <= 1.0

Returns:

this

dstOffNodes

public ConfigurableFuzzer dstOffNodes(double ratio)

Description copied from interface: ConfigurableFuzzer

Set the ratio of nodes OFFLINE at the END of the reconfiguration

Specified by:

dstOffNodes in interface ConfigurableFuzzer

Parameters:

ratio - a number <= 1.0

Returns:

this

srcVMs

public ConfigurableFuzzer srcVMs(int ready, int running, int sleeping)

Description copied from interface: ConfigurableFuzzer

Set the distribution of VM initial state. The individual weight compared to their sum indicates the probability. For example, if the cumulative weight is 100, then each weight denotes a percentage

Specified by:

srcVMs in interface ConfigurableFuzzer

Parameters:

ready - the weight of VMs initially ready.

running - the weight of VMs initially running.

sleeping - the weight of VMs initially sleeping.

Returns:

this

dstVMs

public ConfigurableFuzzer dstVMs(int ready, int running, int sleeping)

Description copied from interface: ConfigurableFuzzer

Set the distribution of VM final state. The individual weight compared to their sum indicates the probability. For example, if the cumulative weight is 100, then each weight denotes a percentage

Specified by:

dstVMs in interface ConfigurableFuzzer

Parameters:

ready - the weight of VMs eventually ready.

running - the weight of VMs eventually running.

sleeping - the weight of VMs eventually sleeping.

Returns:

this

durations

public ConfigurableFuzzer durations(int min, int max)

Description copied from interface: ConfigurableFuzzer

Set the bounds for the action duration

Specified by:

durations in interface ConfigurableFuzzer

Parameters:

min - the minimum duration

max - the maximum duration

Returns:

this