Package com.sun.interview
Class StringQuestion
java.lang.Object
com.sun.interview.Question
com.sun.interview.StringQuestion
A
question
to which the response is a string.-
Field Summary
Fields -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotected
StringQuestion
(Interview interview, String tag) Create a question with a nominated tag. -
Method Summary
Modifier and TypeMethodDescriptionvoid
clear()
Clear any response to this question, resetting the value back to its initial state.protected static boolean
Compare two strings for equality.Get the default response for this question.int
Get the nominal maximum length for the string.Get the response to this question as a string.String[]
Get the suggested responses to this question, or null if none.getValue()
Get the current (default or latest) response to this question.Verify this question is on the current path, and if it is, return the current value.boolean
Check if the question always has a valid response.boolean
Check if the question currently has a valid response.protected void
Save the value for this question in a dictionary, using the tag as the key.void
Set the default response for this question, used by the clear method.void
setNominalMaxLength
(int nominalMaxLength) Set the expected maximum length for the string.void
setSuggestions
(String... newSuggestions) Set the set of suggested responses.void
Set the current value.Methods inherited from class com.sun.interview.Question
addMarker, equals, export, getChecklistItems, getHelpID, getImage, getInterview, getKey, getNext, getResourceString, getResourceString, getSummary, getTag, getText, getTextArgs, hashCode, hasMarker, isEnabled, isHidden, load, reload, removeMarker, setHelpID, setImage, setImage, setSummary, setText
-
Field Details
-
value
The current response for this question. -
suggestions
Suggested values for this question. -
nominalMaxLength
protected int nominalMaxLengthThe nominal maximum length for the string.
-
-
Constructor Details
-
StringQuestion
Create a question with a nominated tag.- Parameters:
interview
- The interview containing this question.tag
- A unique tag to identify this specific question.
-
-
Method Details
-
equal
Compare two strings for equality.- Parameters:
s1
- the first string to be compared, or nulls2
- the other string to be compared, or null- Returns:
- true if both parameters are null, or if both are non-null and equal.
-
getDefaultValue
Get the default response for this question.- Returns:
- the default response for this question.
- See Also:
-
setDefaultValue
Set the default response for this question, used by the clear method.- Parameters:
v
- the default response for this question.- See Also:
-
getValue
Get the current (default or latest) response to this question.- Returns:
- The current value.
- See Also:
-
setValue
Set the current value. -
getValueOnPath
Verify this question is on the current path, and if it is, return the current value.- Returns:
- the current value of this question
- Throws:
Interview.NotOnPathFault
- if this question is not on the current path- See Also:
-
getStringValue
Description copied from class:Question
Get the response to this question as a string.- Specified by:
getStringValue
in classQuestion
- Returns:
- a string representing the current response to this question, or null.
- See Also:
-
isValueValid
public boolean isValueValid()Description copied from class:Question
Check if the question currently has a valid response.- Specified by:
isValueValid
in classQuestion
- Returns:
- true if the question currently has a valid response, and false otherwise.
-
isValueAlwaysValid
public boolean isValueAlwaysValid()Description copied from class:Question
Check if the question always has a valid response. This may be true, for example, for a choice question with a default response.- Specified by:
isValueAlwaysValid
in classQuestion
- Returns:
- true if the question always has a valid response, and false otherwise.
-
getNominalMaxLength
public int getNominalMaxLength()Get the nominal maximum length for the string.- Returns:
- the nominal maximum length for the string.
- See Also:
-
setNominalMaxLength
public void setNominalMaxLength(int nominalMaxLength) Set the expected maximum length for the string.- Parameters:
nominalMaxLength
- the nominal maximum length for the string.- See Also:
-
getSuggestions
Get the suggested responses to this question, or null if none.- Returns:
- The suggestions.
- See Also:
-
setSuggestions
Set the set of suggested responses.- Parameters:
newSuggestions
- The values to be set, or null if none- Throws:
IllegalArgumentException
- if any of the values in the array are null- See Also:
-
clear
public void clear()Clear any response to this question, resetting the value back to its initial state. -
save
Save the value for this question in a dictionary, using the tag as the key.
-