org.xmpp.forms
Class DataForm

java.lang.Object
  org.xmpp.packet.PacketExtension
      org.xmpp.forms.DataForm

public class DataForm
extends PacketExtension

Represents a form that could be use for gathering data as well as for reporting data returned from a search.

The form could be of the following types:

• form -> Indicates a form to fill out.
• submit -> The form is filled out, and this is the data that is being returned from the form.
• cancel -> The form was cancelled. Tell the asker that piece of information.
• result -> Data results being returned from a search, or some other query.

In case the form represents a search, the report will be structured in columns and rows. Use addReportedField(String,String,FormField.Type) to set the columns of the report whilst the report's rows can be configured using addItemFields(Map).

Author:

Gaston Dombiak

Nested Class Summary

static class

DataForm.Type Type-safe enumeration to represent the type of the Data forms.

Field Summary

static String	ELEMENT_NAME Element name of the packet extension.
static String	NAMESPACE Namespace of the packet extension.

Fields inherited from class org.xmpp.packet.PacketExtension

docFactory, element, registeredExtensions

Constructor Summary

DataForm(DataForm.Type type)

DataForm(org.dom4j.Element element)

Method Summary

FormField	addField() Adds a new field as part of the form.
void	addInstruction(String instruction) Adds a new instruction to the list of instructions that explain how to fill out the form and what the form is about.
void	addItemFields(Map<String,Object> fields) Adds a new row of items of reported data.
void	addReportedField(String variable, String label, FormField.Type type) Adds a field to the list of fields that will be returned from a search.
void	clearInstructions() Clears all the stored instructions in this packet extension.
DataForm	createCopy() Creates a deep copy of this packet extension.
FormField	getField(String variable) Returns the field whose variable matches the specified variable.
List<FormField>	getFields() Returns the fields that are part of the form.
List<String>	getInstructions() Returns an unmodifiable list of instructions that explain how to fill out the form and what the form is about.
String	getTitle() Returns the description of the data form.
DataForm.Type	getType() Returns the type of this data form.
static boolean	parseBoolean(String booleanString)
static Date	parseDate(String date) Returns the Date obtained by parsing the specified date representation.
boolean	removeField(String variable) Removes the field whose variable matches the specified variable.
void	setTitle(String title) Sets the description of the data.

Methods inherited from class org.xmpp.packet.PacketExtension

getElement, getExtensionClass

Methods inherited from class java.lang.Object

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

Field Detail

ELEMENT_NAME

public static final String ELEMENT_NAME

Element name of the packet extension.

See Also:

Constant Field Values

NAMESPACE

public static final String NAMESPACE

Namespace of the packet extension.

See Also:

Constant Field Values

Constructor Detail

DataForm

public DataForm(DataForm.Type type)

DataForm

public DataForm(org.dom4j.Element element)

Method Detail

parseDate

public static Date parseDate(String date)
                      throws ParseException

Returns the Date obtained by parsing the specified date representation. The date representation is expected to be in the UTC GMT+0 format.

Parameters:

date - date representation in the UTC GMT+0 format.

Returns:

the Date obtained by parsing the specified date representation.

Throws:

ParseException - if an error occurs while parsing the date representation.

parseBoolean

public static boolean parseBoolean(String booleanString)
                            throws ParseException

Throws:

ParseException

getType

public DataForm.Type getType()

Returns the type of this data form.

Returns:

the data form type.

See Also:

DataForm.Type

setTitle

public void setTitle(String title)

Sets the description of the data. It is similar to the title on a web page or an X window. You can put a