com.cloudera.gertrude

Class ExperimentSpaceDeserializer

java.lang.Object

com.cloudera.gertrude.ExperimentSpaceDeserializer

Direct Known Subclasses:

AvroExperimentSpaceDeserializer

public abstract class ExperimentSpaceDeserializer
extends Object

Converts an ExperimentSpace.Serialized instance to an ExperimentSpace and performs any other validation and verification checks that are necessary to ensure that the ExperimentSpace is ready to be used to serve requests.

Different binaries may want to handle data deserialization in different ways; the Gertrude framework attempts to make as few assumptions as possible about dependencies, up to and including serialization frameworks (such as protocol buffers, Apache Avro, etc.) Other modules in the Gertrude framework provide concrete implementations of particular serialization formats and associated deserialization code for use by clients.

Constructor Summary

Constructors

Constructor and Description
ExperimentSpaceDeserializer()

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract com.google.common.base.Optional<ExperimentSpace>	deserialize(ExperimentSpace.Serialized data) Attempts to convert the ExperimentSpace.Serialized data to an ExperimentSpace, returning Optional.absent() in the case that the deserialization could not be performed.
protected ConditionFactory	getConditionFactory()
protected Map<String,ExperimentFlag<?>>	getExperimentFlags()
void	initialize(Map<String,ExperimentFlag<?>> experimentFlags, ConditionFactory conditionFactory) Initialize this instance with the compiled experiment flags and ConditionFactory needed to validate and parse the serialized ExperimentSpace.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExperimentSpaceDeserializer

public ExperimentSpaceDeserializer()

Method Detail

initialize

public void initialize(Map<String,ExperimentFlag<?>> experimentFlags,
              ConditionFactory conditionFactory)

Initialize this instance with the compiled experiment flags and ConditionFactory needed to validate and parse the serialized ExperimentSpace.

This is only public for testing new serialization frameworks; clients should not use this method directly.

Parameters:

experimentFlags - the experiment flags that have been registered with this binary

conditionFactory - the ConditionFactory configured for this binary

getExperimentFlags

protected Map<String,ExperimentFlag<?>> getExperimentFlags()

getConditionFactory

protected ConditionFactory getConditionFactory()

deserialize

protected abstract com.google.common.base.Optional<ExperimentSpace> deserialize(ExperimentSpace.Serialized data)
                                                                         throws IOException

Attempts to convert the ExperimentSpace.Serialized data to an ExperimentSpace, returning Optional.absent() in the case that the deserialization could not be performed.

Parameters:

data - the serialized form of an ExperimentSpace

Returns:

a valid ExperimentSpace or an Optional.absent() instance

Throws:

IOException - if there is an issue reading the serialized data