Package com.inet.viewer
Class PromptData
java.lang.Object
com.inet.viewer.PromptData
- All Implemented Interfaces:
Serializable
This class is the holder of the information needed for a prompt.
Objects of this class represent a prompt with its name, its description,
its default value(s), and other various settings (can be edited, can have
multiple values, etc).
After the prompts are requested from the user, the prompt values set by the user are also stored here. A typical use of this object would be:
After the prompts are requested from the user, the prompt values set by the user are also stored here. A typical use of this object would be:
...
PromptData[] myPrompts = new PromptData[3];
for (int i=0; i<3; i++) {
myPrompts[i] = new PromptData(name[i], description[i], defaultValues[i], defaultDescs[i],
type[i], discrete[i], range[i], multi[i], changeable[i], descOnly[i], editMask[i],
minLength[i], maxLength[i]);
}
MyPromptDialog.execute(myPrompts); //show the prompts, request values from user, etc.
Object[] obj = new Object[3];
for (int i=0; i<3; i++) {
obj[i] = myPrompts[i].getChosenValue();
}
sendPromptsToServer(obj);
...
As can be seen - first the PromptData objects are initialized, then used to request
data from the user (its settings can be retrieved with methods such as getName(), getDescription(), getType(), etc.
The chosen values are of the following type, depending on the type of the prompt:
Prompt Type | Java Type |
Number/Currency | Double |
Boolean | Boolean |
Date/DateTime | java.util.Date |
Time | Time |
String | String |
Binary | byte[] |
Range | Range |
Multiple | Vector |
- Since:
- 7.0
- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
Data type bit mask - Arraystatic final int
Data type constant - binarystatic final int
Data type constant - booleanstatic final int
Data type constant - numberstatic final int
Data type constant - datestatic final int
Data type constant - datetimestatic final int
Data type constant - numberstatic final int
Data type bit mask - Rangestatic final int
Data type constant - stringstatic final int
Data type constant - timestatic final int
Data type constant - unknown -
Constructor Summary
ConstructorDescriptionPromptData
(boolean skipThis) Creates aPromptData
object which is to be ignored - this is useful for prompts which are not used in the report.PromptData
(PromptData data) Clones aPromptData
object and initializes a new one with all values equal to that of the oldPromptData
object.PromptData
(String name, String subreportName, String description, String[] defaultValues, String[] defaultDescs, int type, boolean discrete, boolean range, boolean multi, boolean changeable, boolean descOnly, boolean informixSP, String editMask, String minValue, String maxValue) Creates aPromptData
object with the parameters chosen.PromptData
(String name, String displayName, String subreportName, String description, String[] defaultValues, String[] defaultDescs, int type, boolean discrete, boolean range, boolean multi, boolean changeable, boolean descOnly, boolean informixSP, String editMask, String minValue, String maxValue) Creates aPromptData
object with the parameters chosen. -
Method Summary
Modifier and TypeMethodDescriptionboolean
Checks equality with another object - aPromptData
object is equal to another if all settings are the same in both objects.Returns the parent to this prompt if this is a cascading prompt.Returns the set value of this prompt.Returns the default values of this prompt.
Note that Date are given as Calendar object, and DateTime as Timestamp.Returns the description of this prompt.Returns name to use for displaying the prompt namegetIcon()
Returns the icon of thisPromptData
.getName()
Returns the name of this prompt.int
getType()
Returns the type of this prompt (without any included bit flags) - that is, NUMBER, CURRENCY, BOOLEAN, DATE, TIME, DATETIME, STRING, or BINARYint
hashCode()
boolean
Returns whether or not this prompt allows discrete values.boolean
Returns whether or not this prompt allows multiple valuesboolean
isRange()
Returns whether or not this prompt allows range values.void
setCascadingParent
(String cascadingParent) If not null, causes this prompt to be viewed as a cascading prompt and sets its parent.void
setChosenValues
(Object values) Sets the value(s) actually chosen for this prompt.void
setDisplayName
(String displayName) Sets the name to be used in the display of the prompt name.toString()
Simply returns the display name of this prompt.
-
Field Details
-
UNKNOWN
public static final int UNKNOWNData type constant - unknown- Since:
- 7.0
- See Also:
-
NUMBER
public static final int NUMBERData type constant - number- Since:
- 7.0
- See Also:
-
CURRENCY
public static final int CURRENCYData type constant - number- Since:
- 7.0
- See Also:
-
BOOLEAN
public static final int BOOLEANData type constant - boolean- Since:
- 7.0
- See Also:
-
DATE
public static final int DATEData type constant - date- Since:
- 7.0
- See Also:
-
TIME
public static final int TIMEData type constant - time- Since:
- 7.0
- See Also:
-
STRING
public static final int STRINGData type constant - string- Since:
- 7.0
- See Also:
-
DATETIME
public static final int DATETIMEData type constant - datetime- Since:
- 7.0
- See Also:
-
BINARY
public static final int BINARYData type constant - binary- Since:
- 7.0
- See Also:
-
RANGE
public static final int RANGEData type bit mask - Range- Since:
- 7.0
- See Also:
-
ARRAY
public static final int ARRAYData type bit mask - Array- Since:
- 7.0
- See Also:
-
-
Constructor Details
-
PromptData
public PromptData(boolean skipThis) Creates aPromptData
object which is to be ignored - this is useful for prompts which are not used in the report.- Parameters:
skipThis
- boolean value whether prompt data object must be ignored- Since:
- 7.0
-
PromptData
public PromptData(String name, String subreportName, String description, String[] defaultValues, String[] defaultDescs, int type, boolean discrete, boolean range, boolean multi, boolean changeable, boolean descOnly, boolean informixSP, String editMask, String minValue, String maxValue) Creates aPromptData
object with the parameters chosen.- Parameters:
name
- Name of the prompt to use as the property name of the promptsubreportName
- Name of the sub report this prompt belongs to (or "" if it is from the main report)description
- Description of the promptdefaultValues
- DefaultValues if any, that is, list of values to be able to choose from. If not a multiple value prompt, the first value is taken as the value set by default.defaultDescs
- Default value descriptions, if any - indexes must correspond to the default value string array.type
- Type of the prompt, using the bit flags. For example, a currency range array would have the type ARRAY|RANGE|CURRENCY.discrete
- Can discrete values be chosen for this prompt?range
- Can range values be chosen for this prompt?multi
- Can multiple values be chosen for this prompt?changeable
- Is it possible enter own values (if not - only default values)informixSP
- Is this an Informix Stored Procedure prompt? (default should be false)descOnly
- Are only the descriptions of the default values to be shown?editMask
- Edit mask - as of yet unimplemented.minValue
- Minimum value, or length of value allowed to be entered (if String).maxValue
- Maximum value, or length of value allowed to be entered (if String).- Since:
- 7.0
-
PromptData
public PromptData(String name, String displayName, String subreportName, String description, String[] defaultValues, String[] defaultDescs, int type, boolean discrete, boolean range, boolean multi, boolean changeable, boolean descOnly, boolean informixSP, String editMask, String minValue, String maxValue) Creates aPromptData
object with the parameters chosen.- Parameters:
name
- Name of the prompt to use as the property name of the promptdisplayName
- Display name of the prompt to use for display only.subreportName
- Name of the sub report this prompt belongs to (or "" if it is from the main report)description
- Description of the promptdefaultValues
- DefaultValues if any, that is, list of values to be able to choose from. If not a multiple value prompt, the first value is taken as the value set by default.defaultDescs
- Default value descriptions, if any - indexes must correspond to the default value string array.type
- Type of the prompt, using the bit flags. For example, a currency range array would have the type ARRAY|RANGE|CURRENCY.discrete
- Can discrete values be chosen for this prompt?range
- Can range values be chosen for this prompt?multi
- Can multiple values be chosen for this prompt?changeable
- Is it possible enter own values (if not - only default values)informixSP
- Is this an Informix Stored Procedure prompt? (default should be false)descOnly
- Are only the descriptions of the default values to be shown?editMask
- Edit mask - as of yet unimplemented.minValue
- Minimum value, or length of value allowed to be entered (if String).maxValue
- Maximum value, or length of value allowed to be entered (if String).- Since:
- 7.0
-
PromptData
Clones aPromptData
object and initializes a new one with all values equal to that of the oldPromptData
object.- Parameters:
data
- Prompt to "clone"- Since:
- 7.0
-
-
Method Details
-
getDescription
Returns the description of this prompt. May benull
if no description is set.- Returns:
- The description of this prompt. May be
null
if no description is set. - Since:
- 7.0
-
isRange
public boolean isRange()Returns whether or not this prompt allows range values.- Returns:
- Does this prompt allow range values?
- Since:
- 7.0
-
isDiscrete
public boolean isDiscrete()Returns whether or not this prompt allows discrete values.- Returns:
- Does this prompt allow discrete values?
- Since:
- 7.0
-
isMultipleAllowed
public boolean isMultipleAllowed()Returns whether or not this prompt allows multiple values- Returns:
- Does this prompt allow multiple values?
- Since:
- 7.0
-
getName
Returns the name of this prompt. Note that this name is unique for the report. This name can be null for hidden prompts.- Returns:
- The name of this prompt. Note that this name is unique for the report. This name can be null for hidden prompts.
- Since:
- 7.0
-
getType
public int getType()Returns the type of this prompt (without any included bit flags) - that is, NUMBER, CURRENCY, BOOLEAN, DATE, TIME, DATETIME, STRING, or BINARY- Returns:
- The type of this prompt.
- Since:
- 7.0
-
setChosenValues
Sets the value(s) actually chosen for this prompt. If more than one value was chosen, use a vector. If values are ranges, use aRange
. For the values themselves, use:- String for STRING
- Double for NUMBER and CURRENCY
- Boolean for BOOLEAN
- Date for DATE and DATETIME
- Time for TIME
- byte[] for BINARY
- Parameters:
values
- Value(s) to be set as chosen - should be a vector if more than one.- Since:
- 7.0
-
toString
Simply returns the display name of this prompt. -
getIcon
Returns the icon of thisPromptData
.- Returns:
- Returns the icon of this
PromptData
.
-
getChosenValue
Returns the set value of this prompt. Depending on the value type, this object can be one of various things:- If a multiple prompt, this is a vector containing one or more single values.
- If one of the values is a range, it is a RangePromptValue.
The single values are:
-
- String for STRING
- Double for NUMBER and CURRENCY
- Boolean for BOOLEAN
- Date for DATE and DATETIME
- Time for TIME
- byte[] for BINARY
- Returns:
- The set value of this prompt.
- Since:
- 7.0
-
getDefaultValues
Returns the default values of this prompt.
Note that Date are given as Calendar object, and DateTime as Timestamp.- Returns:
- Default values of this prompt.
- Since:
- 7.0
-
equals
Checks equality with another object - aPromptData
object is equal to another if all settings are the same in both objects. -
hashCode
public int hashCode() -
getCascadingParent
Returns the parent to this prompt if this is a cascading prompt. If not, this returnsnull
.- Returns:
- parent to this prompt, or null if there is none
-
setCascadingParent
If not null, causes this prompt to be viewed as a cascading prompt and sets its parent. Otherwise, deactivates cascading for this prompt.- Parameters:
cascadingParent
- parent to this prompt, or null if there is none
-
setDisplayName
Sets the name to be used in the display of the prompt name.- Parameters:
displayName
- name to use for prompt name display- Since:
- 7.8
-
getDisplayName
Returns name to use for displaying the prompt name- Returns:
- display name of the prompt
- Since:
- 7.8
-