com.cloudera.gertrude.condition

Class AbstractPropertyCondition<V,S extends ExperimentState>

java.lang.Object

com.cloudera.gertrude.condition.AbstractPropertyCondition<V,S>

All Implemented Interfaces:

Condition<S>

Direct Known Subclasses:

IntHeaderCondition

public abstract class AbstractPropertyCondition<V,S extends ExperimentState>
extends Object
implements Condition<S>

A base class for the common Condition pattern of checking whether or not the value of a field in an ExperimentState belongs to a given set of values.

For example, the property might be the country that a request originated in, and the arguments to the function would be a list of country codes. If the country returned by the #getValue method is in the given list of country codes, then the #evaluate method would return true.

Nested Class Summary

Nested classes/interfaces inherited from interface com.cloudera.gertrude.Condition

Condition.CacheLevel

Field Summary

Fields inherited from interface com.cloudera.gertrude.Condition

FALSE, TRUE

Constructor Summary

Constructors

Constructor and Description
AbstractPropertyCondition()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	evaluate(S state) Returns a true or false value for the given ExperimentState.
abstract V	getValue(S state) Returns the value of the property for the given state.
void	initialize(List<String> args) Initialize this instance with an optional list of arguments provided in the serialized ExperimentSpace.
protected abstract Set<V>	parseArgs(List<String> args) Sub-classes should override this method to validate and extract the information they need to evalate the state of a given ExperimentState instance.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.cloudera.gertrude.Condition

getCacheLevel

Constructor Detail

AbstractPropertyCondition

public AbstractPropertyCondition()

Method Detail

initialize

public void initialize(List<String> args)

Description copied from interface: Condition

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

Specified by:

initialize in interface Condition<S extends ExperimentState>

Parameters:

args - the provided arguments

evaluate

public boolean evaluate(S state)

Description copied from interface: Condition

Returns a true or false value for the given ExperimentState.

Specified by:

evaluate in interface Condition<S extends 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

parseArgs

protected abstract Set<V> parseArgs(List<String> args)

Sub-classes should override this method to validate and extract the information they need to evalate the state of a given ExperimentState instance.

Parameters:

args - the input arguments from the configuration

Returns:

the set of values to match on

getValue

public abstract V getValue(S state)

Returns the value of the property for the given state.

Parameters:

state - the ExperimentState to evaluate

Returns:

the value of the property checked by this condition