com.sun.faban.driver.engine
Class FlatMix

java.lang.Object
  com.sun.faban.driver.engine.Mix
      com.sun.faban.driver.engine.FlatMix

All Implemented Interfaces:

Serializable, Cloneable

public class FlatMix
extends Mix

The implementation of the flat mix annotation.

Author:

Akara Sucharitakul

See Also:

Serialized Form

Nested Class Summary

static class

FlatMix.Selector The selector implementation for the FlatMix.

Field Summary

Fields inherited from class com.sun.faban.driver.engine.Mix

className

Constructor Summary

FlatMix()

Method Summary

Object	clone() Creates and returns a copy of this object.
void	configure(Element driverConfigNode) Configures the flat mix based on the ratios given in the configuration file.
FlatMix	flatMix() Returns the flat mix representation of this mix.
void	init(Class<?> driverClass) Initializes the default FlatMix without an annotation.
void	init(Class<?> driverClass, Annotation a) Initializes this mix according to the annotation.
void	normalize() Normalizes the mix so each row will have a sum of 1.0d.
FlatMix.Selector	selector(Random random) Obtains the per-thread and per-driver instance selector.
String	toString() Provides a string representation of this FlatMix.
void	validate() Validates the mix spec in the benchmark definitions to ensure all the rows and columns are valid.

Methods inherited from class com.sun.faban.driver.engine.Mix

getLogger, getMix

Methods inherited from class java.lang.Object

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

Constructor Detail

FlatMix

public FlatMix()

Method Detail

init

public void init(Class<?> driverClass,
                 Annotation a)
          throws DefinitionException

Initializes this mix according to the annotation.

Specified by:

init in class Mix

Parameters:

driverClass - The driver class annotating this mix

a - The annotation

Throws:

DefinitionException - If there is an error in the annotation

init

public void init(Class<?> driverClass)
          throws DefinitionException

Initializes the default FlatMix without an annotation.

Parameters:

driverClass - The driver class in question

Throws:

DefinitionException

clone

public Object clone()

Creates and returns a copy of this object. The precise meaning of "copy" may depend on the class of the object. The general intent is that, for any object x, the expression:

 x.clone() != x

will be true, and that the expression:

 x.clone().getClass() == x.getClass()

will be true, but these are not absolute requirements. While it is typically the case that:

 x.clone().equals(x)

will be true, this is not an absolute requirement.

By convention, the returned object should be obtained by calling super.clone. If a class and all of its superclasses (except Object) obey this convention, it will be the case that x.clone().getClass() == x.getClass().

By convention, the object returned by this method should be independent of this object (which is being cloned). To achieve this independence, it may be necessary to modify one or more fields of the object returned by super.clone before returning it. Typically, this means copying any mutable objects that comprise the internal "deep structure" of the object being cloned and replacing the references to these objects with references to the copies. If a class contains only primitive fields or references to immutable objects, then it is usually the case that no fields in the object returned by super.clone need to be modified.

The method clone for class Object performs a specific cloning operation. First, if the class of this object does not implement the interface Cloneable, then a CloneNotSupportedException is thrown. Note that all arrays are considered to implement the interface Cloneable. Otherwise, this method creates a new instance of the class of this object and initializes all its fields with exactly the contents of the corresponding fields of this object, as if by assignment; the contents of the fields are not themselves cloned. Thus, this method performs a "shallow copy" of this object, not a "deep copy" operation.

The class Object does not itself implement the interface Cloneable, so calling the clone method on an object whose class is Object will result in throwing an exception at run time.

Overrides:

clone in class Mix

Returns:

a clone of this instance.

See Also:

Cloneable

configure

public void configure(Element driverConfigNode)
               throws ConfigurationException

Configures the flat mix based on the ratios given in the configuration file.

Specified by:

configure in class Mix

Parameters:

driverConfigNode - The DOM node holding the driver config

Throws:

ConfigurationException - If the configuration is invalid for the mix

validate

public void validate()
              throws DefinitionException

Validates the mix spec in the benchmark definitions to ensure all the rows and columns are valid.

Throws:

DefinitionException - Found missing or invalid row/column

normalize

public void normalize()

Normalizes the mix so each row will have a sum of 1.0d. This is important as we do not require the spec input to sum to this amount but the selector (doMenu) will base the random number generator to 1.

Specified by:

normalize in class Mix

flatMix

public FlatMix flatMix()

Returns the flat mix representation of this mix. This is used for consistent reporting.

Specified by:

flatMix in class Mix

Returns:

The flat mix representation.

toString

public String toString()

Provides a string representation of this FlatMix.

Overrides:

toString in class Object

Returns:

The string representation

See Also:

Object.toString()

selector

public FlatMix.Selector selector(Random random)

Obtains the per-thread and per-driver instance selector.

Specified by:

selector in class Mix

Parameters:

random - The per-thread random value generator

Returns:

The selector to be used by the driver