com.sas.graphics.components
Class ConstantCollection

com.sas.graphics.components.ConstantCollection

public class ConstantCollection

Constant collections are used to support a common set of static actions applied on constants defined in the com.sas.graphics.components package. These actions include:
(1) validation of public constant values
(2) translation between constant value and string value
(3) translation between constant value and JSP string value
(4) translation between constant value and localized string value
(5) generation of constant int or string arrays
Please note that the set of constants is defined at construction time and is immutable. The methods here, are a convenience for working with the constant values.

Usage

If a com.sas.graphics.components class defines a set of constants then it is likely to also define an associated ConstantCollection to support the actions listed above on those constants. For example the com.sas.graphics.components.FillStyle class defines a set of constants for its fillType property (all having the FILL_TYPE prefix). The FillStyle class also defines a static ConstantCollection named FILL_TYPE to support the actions listed above being performed on this set of constants.

The methods toName, toJSPAttribute and toLocalizedName support the conversion of a constant value into its associated form.

The methods valueOfName, valueOfJSPAttribute and valueOfLocalizedName support the conversion from the identifed from back into its associated constant value.

The methods getConstants, getNames, getJSPAttributes and getLocalizedNames are a convenience to produce the specified set of constants as an array in the the desired form.

The methods validate and isValid verify whether or not a specified value is contained in the set of constants.

Since:

SAS 9.1

Constructor Summary

ConstantCollection(java.lang.Class rbClass, com.sas.graphics.components.ConstantCollection.Element[] elements)
Constructor used to specify a collection (an immutable set) of constant values.

ConstantCollection(java.lang.Class rbClass, java.lang.String rbKey, com.sas.graphics.components.ConstantCollection.Element[] elements)
Constructor used to specify a collection (an immutable set) of constant values.

Method Summary

int[]	getConstants() Returns all the constants in this set as an int array.
java.lang.String[]	getJSPAttributes() Returns all the constants in this set in the form of a string JSP (Java Server Page)attribute name.
java.lang.String[]	getLocalizedNames() Returns all the constants in this set in the form of easily readable localized string names.
java.lang.String[]	getNames() Returns all the constants in this set in the form of a string name.
boolean	isValid(int styleNum) This method identifies by boolean value whether or not the specified value is contained in this set.
java.lang.String	toJSPAttribute(int styleNum) Provides a conversion from the JSP (Java Server Page) string attribute name representation to its int constant value.
java.lang.String	toLocalizedName(int styleNum) Provides a conversion from the localized string name representation to its int constant value.
java.lang.String	toName(int styleNum) Provides a conversion from the string name representation to its int constant value.
void	validate(int styleNum) This method will throw an IllegalArgument exception if the specified value is not one of the constants specified in this set.
int	valueOfJSPAttribute(java.lang.String name) Provides a conversion from the JSP (Java Server Page) string attribute name to the int constant value.
int	valueOfLocalizedName(java.lang.String name) Provides a conversion from the localized string name to the int constant value.
int	valueOfName(java.lang.String name) Provides a conversion from the string constant name form to the int constant value.

Constructor Detail

ConstantCollection

public ConstantCollection(java.lang.Class rbClass,
                          com.sas.graphics.components.ConstantCollection.Element[] elements)

Constructor used to specify a collection (an immutable set) of constant values.

ConstantCollection

public ConstantCollection(java.lang.Class rbClass,
                          java.lang.String rbKey,
                          com.sas.graphics.components.ConstantCollection.Element[] elements)

Constructor used to specify a collection (an immutable set) of constant values.

Method Detail

validate

public void validate(int styleNum)
              throws java.lang.IllegalArgumentException

This method will throw an IllegalArgument exception if the specified value is not one of the constants specified in this set.

Throws:

an - IllegalArgumentException is thrown if the specified value is not contained in the collection.

java.lang.IllegalArgumentException

isValid

public boolean isValid(int styleNum)

This method identifies by boolean value whether or not the specified value is contained in this set.

Returns:

true if styleNum is contained in this set.

getConstants

public int[] getConstants()

Returns all the constants in this set as an int array.

Returns:

the set of constant values as an int array

getNames

public java.lang.String[] getNames()

Returns all the constants in this set in the form of a string name.

Returns:

all the constants in this set in the form of a string name.

getJSPAttributes

public java.lang.String[] getJSPAttributes()

Returns all the constants in this set in the form of a string JSP (Java Server Page)attribute name.

Returns:

all the constants in this set in the form of a string JSP (Java Server Page)attribute name.

getLocalizedNames

public java.lang.String[] getLocalizedNames()

Returns all the constants in this set in the form of easily readable localized string names.

Returns:

all the constants in this set in the form of easily readable localized string names.

toName

public java.lang.String toName(int styleNum)
                        throws java.lang.IllegalArgumentException

Provides a conversion from the string name representation to its int constant value.

Returns:

the specified constant value in the form of a localized string name.

Throws:

an - IllegalArgumentException is thrown if the specified value is not contained in the collection.

java.lang.IllegalArgumentException

toJSPAttribute

public java.lang.String toJSPAttribute(int styleNum)
                                throws java.lang.IllegalArgumentException

Provides a conversion from the JSP (Java Server Page) string attribute name representation to its int constant value.

Returns:

the specified constant value in the form of a JSP (Java Server Page) string name.

Throws:

an - IllegalArgumentException is thrown if the specified value is not contained in the collection.

java.lang.IllegalArgumentException

toLocalizedName

public java.lang.String toLocalizedName(int styleNum)
                                 throws java.lang.IllegalArgumentException

Provides a conversion from the localized string name representation to its int constant value. localized string name.

Returns:

the specified constant value in the form of an easily readable localized string name.

Throws:

an - IllegalArgumentException is thrown if the specified value is not contained in the collection.

java.lang.IllegalArgumentException

valueOfName

public int valueOfName(java.lang.String name)
                throws java.lang.IllegalArgumentException

Provides a conversion from the string constant name form to the int constant value.

Returns:

the constant value for the specified string name.

Throws:

an - IllegalArgumentException is thrown if the specified value is not recognised as belonging to this set of constants.

java.lang.IllegalArgumentException

valueOfJSPAttribute

public int valueOfJSPAttribute(java.lang.String name)
                        throws java.lang.IllegalArgumentException

Provides a conversion from the JSP (Java Server Page) string attribute name to the int constant value.

Returns:

the constant value for the specified string JSP attribute name.

Throws:

an - IllegalArgumentException is thrown if the specified value is not recognised as belonging to this set of constants.

java.lang.IllegalArgumentException

valueOfLocalizedName

public int valueOfLocalizedName(java.lang.String name)
                         throws java.lang.IllegalArgumentException

Provides a conversion from the localized string name to the int constant value.

Returns:

the constant value for the specified localized string name.

Throws:

an - IllegalArgumentException is thrown if the specified value is not recognised as belonging to this set of constants.

java.lang.IllegalArgumentException