A PropertyModel is used to dynamically access a model using a "property expression". See {@link PropertyResolver} javadoc for allowed property expressions.
For example, take the following bean:
public class Person { private String name; public String getName() { return name; } public void setName(String name) { this.name = name; } } We could construct a label that dynamically fetches the name property of the given person object like this:
Person person = getSomePerson(); ... add(new Label("myLabel", new PropertyModel(person, "name")); Where 'myLabel' is the name of the component, and 'name' is the property expression to get the name property.
In the same fashion, we can create form components that work dynamically on the given model object. For instance, we could create a text field that updates the name property of a person like this:
add(new TextField("myTextField", new PropertyModel(person, "name")); Note that the property resolver by default provides access to private members and methods. If guaranteeing encapsulation of the target objects is a big concern, you should consider using an alternative implementation.
@see PropertyResolver
@see IModel
@see Model
@see LoadableDetachableModel
@author Chris Turner
@author Eelco Hillenius
@author Jonathan Locke
@param < T> The Model object type