org.apache.tapestry5.corelib.components
Class BeanEditor

java.lang.Object
  org.apache.tapestry5.corelib.components.BeanEditor

@SupportsInformalParameters
public class BeanEditor
extends Object

A component that generates a user interface for editing the properties of a bean. This is the central component of the BeanEditForm, and utilizes a PropertyEditor for much of its functionality. This component places a BeanEditContext into the environment.

Parameters:

Name	Type	Flags	Default	Default Prefix	Since	Description
add	java.lang.String			literal		A comma-separated list of property names to be added to the org.apache.tapestry5.beaneditor.BeanModel (only used when a default model is created automatically).
exclude	java.lang.String			literal		A comma-separated list of property names to be removed from the org.apache.tapestry5.beaneditor.BeanModel (only used when a default model is created automatically). The names are case-insensitive.
include	java.lang.String			literal		A comma-separated list of property names to be retained from the org.apache.tapestry5.beaneditor.BeanModel (only used when a default model is created automatically). Only these properties will be retained, and the properties will also be reordered. The names are case-insensitive.
model	org.apache.tapestry5.beaneditor.BeanModel			prop		The model that identifies the parameters to be edited, their order, and every other aspect. If not specified, a default bean model will be created from the type of the object bound to the object parameter. The add, include, exclude and reorder parameters are only applied to a default model, not an explicitly provided one.
object	java.lang.Object			prop		The object to be edited by the BeanEditor. This will be read when the component renders and updated when the form for the component is submitted. Typically, the container will listen for a "prepare" event, in order to ensure that a non-null value is ready to be read or updated.
overrides	org.apache.tapestry5.PropertyOverrides	Not Null	this	prop		Where to search for local overrides of property editing blocks as block parameters. Further, the container of the overrides is used as the source for overridden validation messages. This is normally the BeanEditor component itself, but when the component is used within a BeanEditForm, it will be the BeanEditForm's resources that will be searched.
reorder	java.lang.String			literal		A comma-separated list of property names indicating the order in which the properties should be presented. The names are case insensitive. Any properties not indicated in the list will be appended to the end of the display orde. Only used when a default model is created automatically.

See the BeanEditForm documentation for examples of how to use and customize this component. A further example is available in the documentation for the FormFragment component.

Nested Class Summary

static class

BeanEditor.Prepare

Constructor Summary

BeanEditor()

Method Summary

Object

getObject()

Methods inherited from class java.lang.Object

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

Constructor Detail

BeanEditor

public BeanEditor()

Method Detail

getObject

public Object getObject()