hydra

Class AbstractDescription

java.lang.Object

hydra.AbstractDescription

Direct Known Subclasses:

AdminDescription, AgentDescription, AsyncEventQueueDescription, BridgeDescription, CacheDescription, ClientCacheDescription, ClientDescription, ClientRegionDescription, DiskStoreDescription, FixedPartitionDescription, GatewayDescription, GatewayHubDescription, GatewayReceiverDescription, GatewaySenderDescription, GemFireDescription, HadoopDescription, HDFSStoreDescription, HostAgentDescription, HostDescription, HypericServerInstallDescription, JDKVersionDescription, JProbeDescription, MasterDescription, PartitionDescription, PoolDescription, RegionDescription, ResourceManagerDescription, SecurityDescription, SSLDescription, VersionDescription, VmDescription

public abstract class AbstractDescription
extends Object

Abstract superclass for description objects.

Constructor Summary

Constructors

Constructor and Description
AbstractDescription()

Method Summary

Modifier and Type	Method and Description
protected Properties	addProperties(Properties src, Properties dst) Adds the src properties to the non-null dst properties.
protected static List	asList(int[] ints) Converts the primitive int array to a List of Integer.
protected String	convertPrm(Long key) Converts the parameter key to its gemfire-style property name.
protected static String	convertPrmDefault(String prm) Converts the parameter to its gemfire-style default field name.
protected static Boolean	getBooleanFor(String str, Long key) Converts the given string to a Boolean.
protected static Class	getClass(Long key, String classname) Returns the class with the given name.
protected static String	getClassname(Object obj) Returns the classname for the given object.
static Object	getInstance(Long key, String classname) Returns an instance of the class with the given name.
protected static Integer	getIntegerFor(String str, Long key) Converts the given string to an Integer.
protected static Integer	getNonnegativeIntegerFor(Integer i, Long key) Makes sure the given integer is nonnegative.
protected static Map	getParametersAndDefaults(Long key, Class cls) Returns the "public static Long" parameters provided by the given class, as Long keys, along with their default values or the empty string.
protected static String	getPath(Long key, String val) Returns the fully expanded path to the file for the given string.
protected static SSLDescription	getSSLDescription(String str, Long key, TestConfig config) Returns the SSL description for the given string.
protected static Class	loadClass(String classname) Loads the class with the given name.
protected static String	parseMethod(Long key, String val, Class[] argTypes, Class returnType) Parses the given string into a class and method.
abstract SortedMap	toSortedMap() Returns a sorted map of description fields and their values.
String	toString() Returns a string representing the sorted field-value map with each entry on a separate line, indented if necessary to fit within parent descriptions for ease of reading in a log file.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractDescription

public AbstractDescription()

Method Detail

toSortedMap

public abstract SortedMap toSortedMap()

Returns a sorted map of description fields and their values.

toString

public String toString()

Returns a string representing the sorted field-value map with each entry on a separate line, indented if necessary to fit within parent descriptions for ease of reading in a log file.

Overrides:

toString in class Object

addProperties

protected Properties addProperties(Properties src,
                                   Properties dst)

Adds the src properties to the non-null dst properties.

asList

protected static List asList(int[] ints)

Converts the primitive int array to a List of Integer.

getBooleanFor

protected static Boolean getBooleanFor(String str,
                                       Long key)

Converts the given string to a Boolean.

getIntegerFor

protected static Integer getIntegerFor(String str,
                                       Long key)

Converts the given string to an Integer.

getClass

protected static Class getClass(Long key,
                                String classname)

Returns the class with the given name.

Throws:

HydraConfigException - if not found.

getClassname

protected static String getClassname(Object obj)

Returns the classname for the given object.

getInstance

public static Object getInstance(Long key,
                                 String classname)

Returns an instance of the class with the given name.

Throws:

HydraConfigException - if instantiation fails.

getNonnegativeIntegerFor

protected static Integer getNonnegativeIntegerFor(Integer i,
                                                  Long key)

Makes sure the given integer is nonnegative.

Throws:

HydraConfigException - if the integer is negative.

getParametersAndDefaults

protected static Map getParametersAndDefaults(Long key,
                                              Class cls)

Returns the "public static Long" parameters provided by the given class, as Long keys, along with their default values or the empty string. Assumes that default fields start with "DEFAULT_", are all upper case, and use underscores between words that are capitalized in the corresponding parameter field.

Throws:

HydraConfigException - if none are found.

convertPrm

protected String convertPrm(Long key)

Converts the parameter key to its gemfire-style property name. For example, passwordFile converts to password-file.

convertPrmDefault

protected static String convertPrmDefault(String prm)

Converts the parameter to its gemfire-style default field name. For example, passwordFile converts to DEFAULT_PASSWORD_FILE.

getPath

protected static String getPath(Long key,
                                String val)

Returns the fully expanded path to the file for the given string.

Throws:

HydraConfigException - if the file does not exist.

loadClass

protected static Class loadClass(String classname)

Loads the class with the given name.

Throws:

HydraRuntimeException - if not found.

parseMethod

protected static String parseMethod(Long key,
                                    String val,
                                    Class[] argTypes,
                                    Class returnType)

Parses the given string into a class and method. Validates that the method is a valid public static method with the specified arg types and return type. Returns the input string. Accepts null and empty string.

Throws:

HydraConfigException - if the class or method is not found.

getSSLDescription

protected static SSLDescription getSSLDescription(String str,
                                                  Long key,
                                                  TestConfig config)

Returns the SSL description for the given string.

Throws:

HydraConfigException - if the given string is not listed in SSLPrms.names.