ds.funnel.traffic.factory

Class ConfigurationParser

java.lang.Object

ds.funnel.traffic.factory.ConfigurationParser

public class ConfigurationParser
extends java.lang.Object

This class contains methods to parse the contents of a string which specifies components for a TrafficGenerator object. Configuration string format must be as follows:

Each component for the TrafficGenerator must be specified with a clause: mainFlag typeFlag params...;

• main flag: specifies the main type of component (PacketGenerator, PacketTimeDistribution, or PacketSizeDistribution) to be configured
• type flag: specifies the actual type (Regular, Random, etc) of the component which should be created
• params: the parameters which should be used for initializing the component (presumably of the right sort and order for the desired component, but this is not checked by ConfigurationParser); there may be any number

If the component desired is a complex component which has one or more other base components as parameters, for example a BurstyTimeDistribution, then the specifications for the base components should be included within the parameter list and surrounded by curly brackets. For example, a BurstyTimeDistribution might be specified as follows:

-time_distribution -bursty { -time_distribution -regular 100 } 100 {-time_distribution -random 100 10} { -time_distribution -random 1000 };

Current valid main flags:

• -time_distribution PacketTimeDistribution
• -size_distribution PacketSizeDistribution
• -packet_generator PacketGenerator

Current valid type flags (must be paired with a main flag for which the type actually exists):

• -regular (RegularTimeDistribution)
• -random (RandomTimeDistribution, RandomSizeDistribution, RandomPacketGenerator)
• -bursty (BurstyTimeDistribution)
• -normal (NormalSizeDistribution)
• -thorax (ThoraxPacketGenerator, ThoraxTimeDistribution, ThoraxSizeDistribution)

For example, "-time_distribution -random 12 34;" would specify a RandomTimeDistribution with the parameters 12, 34.

Individual component specifications must be delimited by semicolons. All other values should be separated by whitespace or newline characters.

Author:

Kira Lindburg

Constructor Summary

Constructors

Constructor and Description
ConfigurationParser() Creates a new ConfigurationParser without any set string to parse; a string should be given to the parser before attempting to call the parseConfigurationString() method.
ConfigurationParser(java.lang.String configString) Creates a new ConfigurationParser which will parse the specified configuration string.

Method Summary

Modifier and Type	Method and Description
java.util.List<ComponentSpecification>	getSpecifications()
void	parseConfigurationString() Parses the configuration string currently stored in this ConfigurationParser and stores the results.
void	parseConfigurationString(java.lang.String inConfigurationString) Sets the configuration string for this parser to the specified string, and then parses the string.
void	setConfigurationString(java.lang.String newConfigString) Sets the string this ConfigurationParser will parse to the specified string.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConfigurationParser

public ConfigurationParser()

Creates a new ConfigurationParser without any set string to parse; a string should be given to the parser before attempting to call the parseConfigurationString() method.

ConfigurationParser

public ConfigurationParser(java.lang.String configString)

Creates a new ConfigurationParser which will parse the specified configuration string.

Method Detail

setConfigurationString

public void setConfigurationString(java.lang.String newConfigString)

Sets the string this ConfigurationParser will parse to the specified string.

Parameters:

newConfigString - the new string which will be used when parseConfigurationString() is called

getSpecifications

public java.util.List<ComponentSpecification> getSpecifications()

Returns:

the current list of component specifications which have been parsed

parseConfigurationString

public void parseConfigurationString()

Parses the configuration string currently stored in this ConfigurationParser and stores the results. All previous specifications parsed will be overwritten.

Throws:

java.lang.IllegalArgumentException - if there are any missing or invalid flags within the file (see configuration string format specifications)

parseConfigurationString

public void parseConfigurationString(java.lang.String inConfigurationString)

Sets the configuration string for this parser to the specified string, and then parses the string.

Parameters:

inConfigurationString - the new string to parse

Throws:

java.lang.IllegalArgumentException - if there are any missing or invalid flags within the string (see configuration string format specifications)