com.sun.slamd.parameter
Class IntegerWithUnitParameter

java.lang.Object
  com.sun.slamd.parameter.Parameter
      com.sun.slamd.parameter.IntegerWithUnitParameter

All Implemented Interfaces:

java.lang.Cloneable

public class IntegerWithUnitParameter

extends Parameter

This class defines a parameter that consists of two parts -- an integer value and a string value. The string value will be presented in a drop-down list form that allows the user to choose an appropriate set of units to use for the integer value.

Field Summary

Fields inherited from class com.sun.slamd.parameter.Parameter

description, displayName, isRequired, name, value

Constructor Summary

IntegerWithUnitParameter()
Creates a new instance of the Parameter to be used when decoding values transported over the network, and should not be used by jobs to create parameters.

IntegerWithUnitParameter(java.lang.String name, int value, java.lang.String[] choices)
Creates a new integer with unit parameter with the specified name, value required/optional indicator, and set of choices.

IntegerWithUnitParameter(java.lang.String name, java.lang.String displayName, int value, java.lang.String[] choices)
Creates a new integer with unit parameter with the specified name, display name, value, required/optional indicator, and set of choices.

IntegerWithUnitParameter(java.lang.String name, java.lang.String displayName, java.lang.String description, int value, boolean hasLowerBound, int lowerBound, boolean hasUpperBound, int upperBound, java.lang.String[] choices, java.lang.String selectedChoice)
Creates a new integer with unit parameter with the specified name, display name, description, value, required/optional indicator, and choices as well as information pertaining to upper and lower bounds.

IntegerWithUnitParameter(java.lang.String name, java.lang.String displayName, java.lang.String description, int value, java.lang.String[] choices)
Creates a new integer with unit parameter with the specified name, display name, description, value, required/optional indicator, and choices.

Method Summary

java.lang.Object	clone() Creates a clone of this parameter.
java.lang.String[]	getChoices() Retrieves the list of choices available for the unit drop-down list.
java.lang.String	getDisplayValue() Retrieves a String that can be used when displaying the value of this parameter to the end user.
java.lang.String	getHTMLDisplayValue() Retrieves a String that can be used when displaying the value of this parameter to the end user in the context of an HTML page.
java.lang.String	getHTMLInputForm(java.lang.String prefix) Retrieves a string of text that can be used to request a value for this parameter using an HTML form.
int	getIntValue() Retrieves the value associated with this parameter as a Java integer.
java.lang.String	getInvalidReason(java.lang.Object value) Retrieves the reason that the specified value is not valid.
int	getLowerBound() Retrieves the lower bound that will be used if a lower bound is to be enforced.
java.lang.String	getSelectedChoice() Retrieves the value that has been selected from the drop-down list.
int	getUpperBound() Retrieves the upper bound that will be used if an upper bound is to be enforced.
java.lang.Object	getValue() Retrieves the value associated with this parameter.
java.lang.String	getValueString() Retrieves a string representation of the value of this parameter.
int	getVisibleColumns() Retrieves the number of columns that should be visible in the HTML input form.
boolean	hasLowerBound() Indicates whether a lower bound will be enforced for this parameter.
boolean	hasUpperBound() Indicates whether an upper bound will be enforced for this parameter.
void	htmlInputFormToValue(java.lang.String[] values) Specifies the value of this parameter based on the provided text that would be returned from posting an HTML form.
void	setChoices(java.lang.String[] choices) Specifies the list of choices available for the unit drop-down list.
void	setLowerBound(int lowerBound) Specifies the value to use as the lower bound, and indicates that a lower bound is to be enforced for this parameter.
void	setSelectedChoice(java.lang.String selectedChoice) Specifies the choice that has been selected from the drop-down list.
void	setUpperBound(int upperBound) Specifies the value to use as the upper bound, and indicates that an upper bound is to be enforced for this parameter.
void	setValue(int value, java.lang.String selectedChoice) Specifies the value to use for this parameter.
void	setValue(java.lang.Object value) Specifies the value to use for this parameter.
void	setValueFrom(Parameter parameter) Sets the value for this parameter from the information in the provided parameter.
void	setValueFromString(java.lang.String valueString) Specifies the value to use for this parameter from the provided String.
void	setVisibleColumns(int visibleColumns) Specifies the number of columns that should be visible in the HTML input form.
void	unsetLowerBound() Specifies that a lower bound should not be enforced for this parameter.
void	unsetUpperBound() Specifies that an upper bound should not be enforced for this parameter.

Methods inherited from class com.sun.slamd.parameter.Parameter

decode, encode, getDescription, getDisplayName, getHTMLPostValue, getInvalidReason, getName, hasValue, isRequired, isValid, isValid, setDescription, setDisplayName, setName, setRequired, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

IntegerWithUnitParameter

public IntegerWithUnitParameter()

Creates a new instance of the Parameter to be used when decoding values transported over the network, and should not be used by jobs to create parameters. If any initialization is needed that will not be covered by calls to the setName, setDisplayName, setDescription, or setValueFromString, then it should be done here.

IntegerWithUnitParameter

public IntegerWithUnitParameter(java.lang.String name,
                                int value,
                                java.lang.String[] choices)

Creates a new integer with unit parameter with the specified name, value required/optional indicator, and set of choices. The display name will be the same as the name and it will not have a description. Upper and lower bounds will not be enforced.

Parameters:

name - The name to use for this parameter.

value - The value to use for this parameter.

choices - The set of choices for this parameter.

IntegerWithUnitParameter

public IntegerWithUnitParameter(java.lang.String name,
                                java.lang.String displayName,
                                int value,
                                java.lang.String[] choices)

Creates a new integer with unit parameter with the specified name, display name, value, required/optional indicator, and set of choices. It will not have a description, and upper and lower bounds will not be enforced.

Parameters:

name - The name to use for this parameter.

displayName - The name to use for this parameter when it is displayed to the end user.

value - The value to use for this parameter.

choices - The set of choices for this parameter.

IntegerWithUnitParameter

public IntegerWithUnitParameter(java.lang.String name,
                                java.lang.String displayName,
                                java.lang.String description,
                                int value,
                                java.lang.String[] choices)

Creates a new integer with unit parameter with the specified name, display name, description, value, required/optional indicator, and choices. Upper and lower bounds will not be enforced.

Parameters:

name - The name to use for this parameter.

displayName - The name to use for this parameter when it is displayed to the end user.

description - The description to use for this parameter.

value - The value to use for this parameter.

choices - The set of choices for this parameter.

IntegerWithUnitParameter

public IntegerWithUnitParameter(java.lang.String name,
                                java.lang.String displayName,
                                java.lang.String description,
                                int value,
                                boolean hasLowerBound,
                                int lowerBound,
                                boolean hasUpperBound,
                                int upperBound,
                                java.lang.String[] choices,
                                java.lang.String selectedChoice)

Creates a new integer with unit parameter with the specified name, display name, description, value, required/optional indicator, and choices as well as information pertaining to upper and lower bounds.

Parameters:

name - The name to use for this parameter.

displayName - The name to use for this parameter when it is displayed to the end user.

description - The description to use for this parameter.

value - The value to use for this parameter.

hasLowerBound - Indicates whether the lower bound will be enforced for this parameter.

lowerBound - The lower bound to use for this parameter (will only be effective if hasLowerBound is true).

hasUpperBound - Indicates whether the upper bound will be enforced for this parameter.

upperBound - The upper bound to use for this parameter (will only be effective if hasUpperBound is true).

choices - The set of choices for this parameter.

selectedChoice - The choice that should be selected by default.

Method Detail

getIntValue

public int getIntValue()

Retrieves the value associated with this parameter as a Java integer. Note that you should check to make sure that this parameter actually has a value before calling this method, because it is possible to have an integer parameter whose value is not required. If this parameter does not have a value, then the value returned from this function is unreliable.

Returns:

The value associated with this parameter as a Java integer.

getSelectedChoice

public java.lang.String getSelectedChoice()

Retrieves the value that has been selected from the drop-down list.

Returns:

The value that has been selected from the drop-down list.

setSelectedChoice

public void setSelectedChoice(java.lang.String selectedChoice)
                       throws InvalidValueException

Specifies the choice that has been selected from the drop-down list.

Parameters:

selectedChoice - The choice that has been selected from the drop-down list.

Throws:

InvalidValueException - If the specified choice is not a valid option.

getValue

public java.lang.Object getValue()

Retrieves the value associated with this parameter. If it does not have a value, then null will be returned. If it does have a value, then that value will be returned as a Java Integer object.

Overrides:

getValue in class Parameter

Returns:

The value associated with this parameter.

setValue

public void setValue(int value,
                     java.lang.String selectedChoice)
              throws InvalidValueException

Specifies the value to use for this parameter.

Parameters:

value - The value to use for this parameter.

selectedChoice - The selected choice indicating the unit for the value.

Throws:

InvalidValueException - If the specified value does not meet the upper or lower bounds requirements (if they are to be enforced).

setValue

public void setValue(java.lang.Object value)
              throws InvalidValueException

Specifies the value to use for this parameter.

Overrides:

setValue in class Parameter

Parameters:

value - The value to use for this parameter.

Throws:

InvalidValueException - If the specified value cannot be interpreted as a Java integer, or if it does not meet the upper or lower bounds requirements (if they are to be enforced).

setValueFrom

public void setValueFrom(Parameter parameter)

Sets the value for this parameter from the information in the provided parameter. Note that the provided parameter must be of the same type as this parameter or no action will be taken.

Specified by:

setValueFrom in class Parameter

Parameters:

parameter - The parameter from which to take the value for this parameter.

setValueFromString

public void setValueFromString(java.lang.String valueString)
                        throws InvalidValueException

Specifies the value to use for this parameter from the provided String. Note that no validation is performed with this method.

Specified by:

setValueFromString in class Parameter

Parameters:

valueString - The string representation of the value to use for this parameter.

Throws:

InvalidValueException - If the provided value cannot be used to provide a value for this parameter.

getValueString

public java.lang.String getValueString()

Retrieves a string representation of the value of this parameter.

Specified by:

getValueString in class Parameter

Returns:

A string representation of the value of this parameter.

getLowerBound

public int getLowerBound()

Retrieves the lower bound that will be used if a lower bound is to be enforced. If the lower bound is not to be enforced, then the value returned from this method will be meaningless.

Returns:

The lower bound that will be used if a lower bound is to be enforced.

setLowerBound

public void setLowerBound(int lowerBound)

Specifies the value to use as the lower bound, and indicates that a lower bound is to be enforced for this parameter.

Parameters:

lowerBound - The value to use as the lower bound.

unsetLowerBound

public void unsetLowerBound()

Specifies that a lower bound should not be enforced for this parameter.

hasLowerBound

public boolean hasLowerBound()

Indicates whether a lower bound will be enforced for this parameter.

Returns:

true if a lower bound will be enforced, or false if not.

getUpperBound

public int getUpperBound()

Retrieves the upper bound that will be used if an upper bound is to be enforced. If the upper bound is not to be enforced, then the value returned from this method will be meaningless.

Returns:

The lower bound that will be used if a lower bound is to be enforced.

setUpperBound

public void setUpperBound(int upperBound)

Specifies the value to use as the upper bound, and indicates that an upper bound is to be enforced for this parameter.

Parameters:

upperBound - The value to use as the upper bound.

unsetUpperBound

public void unsetUpperBound()

Specifies that an upper bound should not be enforced for this parameter.

hasUpperBound

public boolean hasUpperBound()

Indicates whether an upper bound will be enforced for this parameter.

Returns:

true if an upper bound will be enforced, or false if not.

getChoices

public java.lang.String[] getChoices()

Retrieves the list of choices available for the unit drop-down list.

Returns:

The list of choices available for the unit drop-down list.

setChoices

public void setChoices(java.lang.String[] choices)

Specifies the list of choices available for the unit drop-down list. If the currently selected choice is not in the new list, then the selected choice will be changed so that it is the first value of the new list.

Parameters:

choices - The list of choices available for the unit drop-down list.

getInvalidReason

public java.lang.String getInvalidReason(java.lang.Object value)

Retrieves the reason that the specified value is not valid.

Specified by:

getInvalidReason in class Parameter

Parameters:

value - The value for which to make the determination.

Returns:

The reason that the specified value is not valid, or null if it is valid.

getDisplayValue

public java.lang.String getDisplayValue()

Retrieves a String that can be used when displaying the value of this parameter to the end user.

Specified by:

getDisplayValue in class Parameter

Returns:

A String that can be used when displaying the value of this parameter to the end user.

getHTMLDisplayValue

public java.lang.String getHTMLDisplayValue()

Retrieves a String that can be used when displaying the value of this parameter to the end user in the context of an HTML page.

Overrides:

getHTMLDisplayValue in class Parameter

Returns:

A String that can be used when displaying the value of this parameter to the end user in the context of an HTML page.

getVisibleColumns

public int getVisibleColumns()

Retrieves the number of columns that should be visible in the HTML input form.

Returns:

The number of columns that should be visible in the HTML input form.

setVisibleColumns

public void setVisibleColumns(int visibleColumns)

Specifies the number of columns that should be visible in the HTML input form.

Parameters:

visibleColumns - The number of columns that should be visible in the HTML input form.

getHTMLInputForm

public java.lang.String getHTMLInputForm(java.lang.String prefix)

Retrieves a string of text that can be used to request a value for this parameter using an HTML form. Note that this should just be for the input field itself and should not use the display name or have any special marker to indicate whether the value is required or not, as those are to be added by whaterver is generating the HTML page.

Specified by:

getHTMLInputForm in class Parameter

Parameters:

prefix - The prefix that should be placed in front of the parameter name as the name of the form element.

Returns:

A string of text that can be used to request a value for this parameter using an HTML form.

htmlInputFormToValue

public void htmlInputFormToValue(java.lang.String[] values)
                          throws InvalidValueException

Specifies the value of this parameter based on the provided text that would be returned from posting an HTML form.

Specified by:

htmlInputFormToValue in class Parameter

Parameters:

values - The set of values for this parameter contained in the servlet request.

Throws:

InvalidValueException - If the specified value is not acceptable for this parameter.

clone

public java.lang.Object clone()

Creates a clone of this parameter.

Specified by:

clone in class Parameter

Returns:

A clone of this parameter.