com.sun.slamd.parameter
Class LongParameter

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

All Implemented Interfaces:

java.lang.Cloneable

public class LongParameter

extends Parameter

This class defines a parameter whose value is a 64-bit mathematical integer (no decimal values) that supports a much wider range of values than the standard integer parameter type. It can also support upper and lower bounds, although they are not required to be enforced.

Field Summary

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

description, displayName, isRequired, name, value

Constructor Summary

LongParameter()
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.

LongParameter(java.lang.String name)
Creates a new long parameter with the specified name.

LongParameter(java.lang.String name, boolean isRequired, long value)
Creates a new long parameter with the specified name, value, and required/optional indicator.

LongParameter(java.lang.String name, long value)
Creates a new long parameter with the specified name and value.

LongParameter(java.lang.String name, java.lang.String displayName, boolean isRequired, long value)
Creates a new long parameter with the specified name, display name, value, and required/optional indicator.

LongParameter(java.lang.String name, java.lang.String displayName, java.lang.String description, boolean isRequired, long value)
Creates a new long parameter with the specified name, display name, description, value, and required/optional indicator.

LongParameter(java.lang.String name, java.lang.String displayName, java.lang.String description, boolean isRequired, long value, boolean hasLowerBound, long lowerBound, boolean hasUpperBound, long upperBound)
Creates a new long parameter with the specified name, display name, description, value, and required/optional indicator, as well as information pertaining to upper and lower bounds.

Method Summary

java.lang.Object	clone() Creates a clone of this parameter.
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.
java.lang.String	getInvalidReason(java.lang.Object value) Retrieves the reason that the specified value is not valid.
long	getLongValue() Retrieves the value associated with this parameter as a Java long.
long	getLowerBound() Retrieves the lower bound that will be used if a lower bound is to be enforced.
long	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	setLowerBound(long lowerBound) Specifies the value to use as the lower bound, and indicates that a lower bound is to be enforced for this parameter.
void	setUpperBound(long 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(long value) 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

LongParameter

public LongParameter()

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.

LongParameter

public LongParameter(java.lang.String name)

Creates a new long parameter with the specified name. The display name will be the same as the name, it will not have a description or a value, and it will not be required to have a value. Upper and lower bounds will not be enforced.

Parameters:

name - The name to use for this parameter.

LongParameter

public LongParameter(java.lang.String name,
                     long value)

Creates a new long parameter with the specified name and value. The display name will be the same as the name, and it will not have a description. It will not be required, nor will upper or lower bounds be enforced.

Parameters:

name - The name to use for this parameter.

value - The value to use for this parameter.

LongParameter

public LongParameter(java.lang.String name,
                     boolean isRequired,
                     long value)

Creates a new long parameter with the specified name, value, and required/optional indicator. 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.

isRequired - Indicates whether this parameter is required to have a value.

value - The value to use for this parameter.

LongParameter

public LongParameter(java.lang.String name,
                     java.lang.String displayName,
                     boolean isRequired,
                     long value)

Creates a new long parameter with the specified name, display name, value, and required/optional indicator. 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.

isRequired - Indicates whether this parameter is required to have a value.

value - The value to use for this parameter.

LongParameter

public LongParameter(java.lang.String name,
                     java.lang.String displayName,
                     java.lang.String description,
                     boolean isRequired,
                     long value)

Creates a new long parameter with the specified name, display name, description, value, and required/optional indicator. 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.

isRequired - Indicates whether this parameter is required to have a value.

value - The value to use for this parameter.

LongParameter

public LongParameter(java.lang.String name,
                     java.lang.String displayName,
                     java.lang.String description,
                     boolean isRequired,
                     long value,
                     boolean hasLowerBound,
                     long lowerBound,
                     boolean hasUpperBound,
                     long upperBound)

Creates a new long parameter with the specified name, display name, description, value, and required/optional indicator, 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.

isRequired - Indicates whether this parameter is required to have a value.

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).

Method Detail

getLongValue

public long getLongValue()

Retrieves the value associated with this parameter as a Java long. 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 a long 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 long.

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 Long object.

Overrides:

getValue in class Parameter

Returns:

The value associated with this parameter.

setValue

public void setValue(long value)
              throws InvalidValueException

Specifies the value to use for this parameter.

Parameters:

value - The value to use for this parameter.

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 long, 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 long 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(long 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 long 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(long 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.

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.