org.andromda.presentation.jsf

Class FormPopulator

java.lang.Object

org.andromda.presentation.jsf.FormPopulator

All Implemented Interfaces:

Serializable

public class FormPopulator
extends Object
implements Serializable

Provides utilities for population of forms when using JSF.

Author:

Chad Brandon

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
FormPopulator()

Method Summary

Methods

Modifier and Type	Method and Description
static void	populateForm(Object fromForm, Object toForm) Copies the properties from the fromForm to the toForm.
static void	populateForm(Object fromForm, Object toForm, boolean override) Copies the properties from the fromForm to the toForm.
static void	populateFormFromPropertyMap(Object form, Map<String,DateFormat> formatters, Map<String,?> properties) Populates the form from the given map of properties.
static void	populateFormFromPropertyMap(Object form, Map<String,DateFormat> formatters, Map<String,?> properties, boolean override) Populates the form from the given map of properties.
static void	populateFormFromPropertyMap(Object form, Map<String,DateFormat> formatters, Map<String,?> properties, String[] ignoreProperties) Populates the form from the given map of properties.
static void	populateFormFromPropertyMap(Object form, Map<String,DateFormat> formatters, Map<String,?> properties, String[] ignoreProperties, boolean override, boolean assignableTypesOnly) Populates the form from the given map of properties.
static void	populateFormFromPropertyMapAssignableTypesOnly(Object form, Map<String,DateFormat> formatters, Map<String,?> properties) Populates the form from the given map of properties and populates only if the types the properties are assignable.
static void	populateFormFromRequestAttributes(Object form, Map<String,DateFormat> formatters, boolean override) Populates the form from the attributes contained in the request object.
static void	populateFormFromRequestAttributes(Object form, Map<String,DateFormat> formatters, boolean override, boolean assignableTypesOnly) Populates the form from the attributes contained in the request object.

Methods inherited from class java.lang.Object

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

Constructor Detail

FormPopulator

public FormPopulator()

Method Detail

populateForm

public static final void populateForm(Object fromForm,
                Object toForm)

Copies the properties from the fromForm to the toForm. Only passes not-null values to the toForm.

Parameters:

fromForm - the form from which we're populating

toForm - the form to which we're populating

populateForm

public static final void populateForm(Object fromForm,
                Object toForm,
                boolean override)

Copies the properties from the fromForm to the toForm. Only passes not-null values to the toForm.

Parameters:

fromForm - the form from which we're populating

toForm - the form to which we're populating

override - whether or not properties that have already been copied, should be overridden.

populateFormFromRequestAttributes

public static final void populateFormFromRequestAttributes(Object form,
                                     Map<String,DateFormat> formatters,
                                     boolean override,
                                     boolean assignableTypesOnly)

Populates the form from the attributes contained in the request object.

Parameters:

form - the form to populate.

formatters - any date or time formatters.

override - whether or not to override properties already set on the given form.

assignableTypesOnly - whether or not copying should be attempted only if the property types are assignable.

populateFormFromRequestAttributes

public static final void populateFormFromRequestAttributes(Object form,
                                     Map<String,DateFormat> formatters,
                                     boolean override)

Populates the form from the attributes contained in the request object.

Parameters:

form - the form to populate.

formatters - any date or time formatters.

override - whether or not to override properties already set on the given form.

populateFormFromPropertyMap

public static final void populateFormFromPropertyMap(Object form,
                               Map<String,DateFormat> formatters,
                               Map<String,?> properties,
                               boolean override)

Populates the form from the given map of properties. If a matching property is null or an empty string, then null is placed on the form.

Parameters:

form - the form to populate.

formatters - any date or time formatters.

properties - the properties to populate from.

override - whether or not to override properties already set on the given form.

populateFormFromPropertyMap

public static final void populateFormFromPropertyMap(Object form,
                               Map<String,DateFormat> formatters,
                               Map<String,?> properties)

Populates the form from the given map of properties. If a matching property is null or an empty string, then null is placed on the form.

Parameters:

form - the form to populate.

formatters - any date or time formatters.

properties - the properties to populate from.

populateFormFromPropertyMapAssignableTypesOnly

public static final void populateFormFromPropertyMapAssignableTypesOnly(Object form,
                                                  Map<String,DateFormat> formatters,
                                                  Map<String,?> properties)

Populates the form from the given map of properties and populates only if the types the properties are assignable. If a matching property is null or an empty string, then null is placed on the form.

Parameters:

form - the form to populate.

formatters - any date or time formatters.

properties - the properties to populate from.

populateFormFromPropertyMap

public static final void populateFormFromPropertyMap(Object form,
                               Map<String,DateFormat> formatters,
                               Map<String,?> properties,
                               String[] ignoreProperties)

Populates the form from the given map of properties. If a matching property is null or an empty string, then null is placed on the form.

Parameters:

form - the form to populate.

formatters - any date or time formatters.

properties - the properties to populate from.

ignoreProperties - names of any properties to ignore when it comes to populating on the form.

populateFormFromPropertyMap

public static final void populateFormFromPropertyMap(Object form,
                               Map<String,DateFormat> formatters,
                               Map<String,?> properties,
                               String[] ignoreProperties,
                               boolean override,
                               boolean assignableTypesOnly)

Populates the form from the given map of properties. If a matching property is null or an empty string, then null is placed on the form.

Parameters:

form - the form to populate.

formatters - any date or time formatters.

properties - the properties to populate from.

ignoreProperties - names of any properties to ignore when it comes to populating on the form.

override - whether or not to override properties already set on the given form.

assignableTypesOnly - whether or not copying should be attempted only if the property types are assignable.