com.cloudera.gertrude

Interface Condition<S extends ExperimentState>

All Known Implementing Classes:

AbstractPropertyCondition, IntHeaderCondition

public interface Condition<S extends ExperimentState>

Determines a true or false value for a given ExperimentState.

The Condition interface allows Gertrude clients to specify rules that determine which experiments and flag value modifiers are active for a request.

For example, a client could implement a Condition that tested whether or not a request was in a particular country, or one based on a regular expression matching the hostname of the machine running this instance.

Classes that implement the Condition interface should be registered with the ConditionFactory for the current session so that Gertrude can create new instances of those classes from the information contained in the serialized version of the current ExperimentSpace.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Condition.CacheLevel An indicator for how often the value of a Condition will change when the evaluate(ExperimentState) method is called repeatedly.

Field Summary

Fields

Modifier and Type	Field and Description
static Condition<ExperimentState>	FALSE A Condition instance that is always false.
static Condition<ExperimentState>	TRUE A Condition instance that is always true.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	evaluate(S state) Returns a true or false value for the given ExperimentState.
Condition.CacheLevel	getCacheLevel() Returns an indication of the level at which this Condition instance may be cached.
void	initialize(List<String> args) Initialize this instance with an optional list of arguments provided in the serialized ExperimentSpace.

Field Detail

TRUE

static final Condition<ExperimentState> TRUE

A Condition instance that is always true.

FALSE

static final Condition<ExperimentState> FALSE

A Condition instance that is always false.

Method Detail

initialize

void initialize(List<String> args)

Initialize this instance with an optional list of arguments provided in the serialized ExperimentSpace.

Parameters:

args - the provided arguments

evaluate

boolean evaluate(S state)

Returns a true or false value for the given ExperimentState.

Parameters:

state - the ExperimentState that contains information about the request

Returns:

true or false, depending on the logic of this instance and the provided state

getCacheLevel

Condition.CacheLevel getCacheLevel()

Returns an indication of the level at which this Condition instance may be cached.

Returns:

the cache level of this instance