org.apache.tapestry5.corelib.components
Class BeanEditor

java.lang.Object
  extended by 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.

Component Parameters
NameDescriptionTypeFlagsDefaultDefault PrefixSince
addA 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).Stringliteral
excludeA 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.Stringliteral
includeA 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.Stringliteral
modelThe 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.org.apache.tapestry5.beaneditor.BeanModelprop
objectThe 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.Objectprop
overridesWhere 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.org.apache.tapestry5.PropertyOverridesNot Nullthisprop
reorderA 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.Stringliteral

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()


Copyright © 2003-2012 The Apache Software Foundation.