Openfire 3.5.0 Javadoc

org.xmpp.forms
Class FormField

java.lang.Object
  extended by org.xmpp.forms.FormField

public class FormField
extends Object

Represents a field of a form. The field could be used to represent a question to complete, a completed question or a data returned from a search. The exact interpretation of the field depends on the context where the field is used.

Author:
Gaston Dombiak

Nested Class Summary
static class FormField.Option
          Represents the available option of a given FormField.
static class FormField.Type
          Type-safe enumeration to represent the field type of the Data forms.
 
Method Summary
 void addOption(String label, String value)
          Adds an available option to the question that the user has in order to answer the question.
 void addValue(Object value)
          Adds a default value to the question if the question is part of a form to fill out.
 void clearValues()
          Removes all the values of the field.
 String getDescription()
          Returns a description that provides extra clarification about the question.
 String getLabel()
          Returns the label of the question which should give enough information to the user to fill out the form.
 List<FormField.Option> getOptions()
          Returns the available options to answer for this question.
 FormField.Type getType()
          Returns an indicative of the format for the data to answer.
 List<String> getValues()
          Returns an Iterator for the default values of the question if the question is part of a form to fill out.
 String getVariable()
          Returns the variable name that the question is filling out.
 boolean isRequired()
          Returns true if the question must be answered in order to complete the questionnaire.
 void setDescription(String description)
          Sets a description that provides extra clarification about the question.
 void setLabel(String label)
          Sets the label of the question which should give enough information to the user to fill out the form.
 void setRequired(boolean required)
          Sets if the question must be answered in order to complete the questionnaire.
 void setType(FormField.Type type)
          Sets an indicative of the format for the data to answer.
 void setVariable(String var)
          Sets the attribute that uniquely identifies the field in the context of the form.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

addValue

public void addValue(Object value)
Adds a default value to the question if the question is part of a form to fill out. Otherwise, adds an answered value to the question.

Parameters:
value - a default value or an answered value of the question.

clearValues

public void clearValues()
Removes all the values of the field.


addOption

public void addOption(String label,
                      String value)
Adds an available option to the question that the user has in order to answer the question.

Parameters:
label - a label that represents the option.
value - the value of the option.

getOptions

public List<FormField.Option> getOptions()
Returns the available options to answer for this question. The returned options cannot be modified but they will be updated if the underlying DOM object gets updated.

Returns:
the available options to answer for this question.

setType

public void setType(FormField.Type type)
Sets an indicative of the format for the data to answer. Valid formats are:

Parameters:
type - an indicative of the format for the data to answer.

setVariable

public void setVariable(String var)
Sets the attribute that uniquely identifies the field in the context of the form. If the field is of type "fixed" then the variable is optional.

Parameters:
var - the unique identifier of the field in the context of the form.

setLabel

public void setLabel(String label)
Sets the label of the question which should give enough information to the user to fill out the form.

Parameters:
label - the label of the question.

setRequired

public void setRequired(boolean required)
Sets if the question must be answered in order to complete the questionnaire.

Parameters:
required - if the question must be answered in order to complete the questionnaire.

setDescription

public void setDescription(String description)
Sets a description that provides extra clarification about the question. This information could be presented to the user either in tool-tip, help button, or as a section of text before the question.

If the question is of type FIXED then the description should remain empty.

Parameters:
description - provides extra clarification about the question.

isRequired

public boolean isRequired()
Returns true if the question must be answered in order to complete the questionnaire.

Returns:
true if the question must be answered in order to complete the questionnaire.

getVariable

public String getVariable()
Returns the variable name that the question is filling out.

Returns:
the variable name of the question.

getValues

public List<String> getValues()
Returns an Iterator for the default values of the question if the question is part of a form to fill out. Otherwise, returns an Iterator for the answered values of the question.

Returns:
an Iterator for the default values or answered values of the question.

getType

public FormField.Type getType()
Returns an indicative of the format for the data to answer. Valid formats are:

Returns:
format for the data to answer.

getLabel

public String getLabel()
Returns the label of the question which should give enough information to the user to fill out the form.

Returns:
label of the question.

getDescription

public String getDescription()
Returns a description that provides extra clarification about the question. This information could be presented to the user either in tool-tip, help button, or as a section of text before the question.

If the question is of type FIXED then the description should remain empty.

Returns:
description that provides extra clarification about the question.

Openfire 3.5.0 Javadoc

Copyright © 2003-2007 Jive Software.