org.formproc
Class FormUtilities

java.lang.Object
  |
  +--org.formproc.FormUtilities

public class FormUtilities

extends java.lang.Object

Utility class.

Author:

Anthony Eden

Method Summary

static FormData[]	filterFormData(FormData[] data, java.util.List formElements) Filter the incoming FormData array so that the resulting array only contains values for fields which are part of the FormElementGroup.
static FormData	findFormData(FormElement formElement, FormData[] formData) Helper method for finding a named FormData object in an array of FormData objects.
static FormData	findFormData(java.lang.String name, FormData[] formData) Helper method for finding a named FormData object in an array of FormData objects.
static FormData[]	toFormDataArray(FormData formData) Convert a single FormData object into a FormData array with one element.
static FormElement[]	toFormElementArray(FormElement formElement) Convert a single FormElement object into a FormElement array with one element.

Methods inherited from class java.lang.Object

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

Method Detail

findFormData

public static FormData findFormData(FormElement formElement,
                                    FormData[] formData)

Helper method for finding a named FormData object in an array of FormData objects. The given FormElement's name is used as the name for the FormData. If no FormData object with the given name is found then a new FormData object is created with the given name and a null value.

Parameters:

formElement - The FormElement

formData - The array of FormData objects

Returns:

The named FormData object

findFormData

public static FormData findFormData(java.lang.String name,
                                    FormData[] formData)

Helper method for finding a named FormData object in an array of FormData objects. If no FormData object with the given name is found then a new FormData object is created with the given name and a null value.

Parameters:

name - The field name

formData - The array of FormData objects

Returns:

The named FormData object

filterFormData

public static FormData[] filterFormData(FormData[] data,
                                        java.util.List formElements)

Filter the incoming FormData array so that the resulting array only contains values for fields which are part of the FormElementGroup. Note that the returned array is a completely new array and the source array is left untouched. If a field listed in the group had no submitted value then a FormData object with a null value will be provided.

Parameters:

data - The FormData array

Returns:

The resulting filtered array

toFormDataArray

public static FormData[] toFormDataArray(FormData formData)

Convert a single FormData object into a FormData array with one element.

Returns:

The FormData array

toFormElementArray

public static FormElement[] toFormElementArray(FormElement formElement)

Convert a single FormElement object into a FormElement array with one element.

Returns:

The FormElement array