org.springframework.binding.form
Interface HierarchicalFormModel

All Superinterfaces:

FormModel, PropertyChangePublisher

All Known Subinterfaces:

ValidatingFormModel

All Known Implementing Classes:

AbstractFormModel, DefaultFormModel

public interface HierarchicalFormModel
extends FormModel

Sub-interface implemented by form models that can be part of a form model hierarchy.

In a HierarchicalFormModel:

• the enabled state of the parent is inherited by the children. So if the parent is disabled then the child is also disabled; however if the child is disabled the parent might not be disabled.
• the dirty state of the chidren is inherited by the parent. So if one or more of the children are dirty then the parent is also dirty. However if the parent is dirty the children my not be.
• the readOnly state of the parent is inherited by the children. If the parent is readOnly, all children are readOnly as well. However a child may be readOnly while the parent is not.

Author:

Oliver Hutchison

Field Summary

Fields inherited from interface org.springframework.binding.form.FormModel

COMMITTABLE_PROPERTY, DIRTY_PROPERTY, ENABLED_PROPERTY, READONLY_PROPERTY

Method Summary

void	addChild(HierarchicalFormModel child) Adds a new child to the form model.
FormModel[]	getChildren() Returns an array of child form models.
HierarchicalFormModel	getParent() Returns the parent form model or null of there is none.
void	removeChild(HierarchicalFormModel child) Removes a child from this form model.
void	removeParent() Remove the parent form model
void	setParent(HierarchicalFormModel parent) Sets the parent form model.

Methods inherited from interface org.springframework.binding.form.FormModel

addCommitListener, commit, getFieldFace, getFieldMetadata, getFieldNames, getFormObject, getFormObjectHolder, getId, getValueModel, getValueModel, hasValueModel, isBuffered, isCommittable, isDirty, isEnabled, isReadOnly, registerPropertyConverter, removeCommitListener, reset, revert, setFormObject

Methods inherited from interface org.springframework.binding.value.PropertyChangePublisher

addPropertyChangeListener, addPropertyChangeListener, removePropertyChangeListener, removePropertyChangeListener

Method Detail

getParent

HierarchicalFormModel getParent()

Returns the parent form model or null of there is none.

getChildren

FormModel[] getChildren()

Returns an array of child form models.

setParent

void setParent(HierarchicalFormModel parent)

Sets the parent form model.

removeParent

void removeParent()

Remove the parent form model

addChild

void addChild(HierarchicalFormModel child)

Adds a new child to the form model. The child form model will have it's parent set to this.

removeChild

void removeChild(HierarchicalFormModel child)

Removes a child from this form model.