This is a quick guide to changes between releases of Tapestry. This is meant to provide information on any additions or changes that developers will face after upgrading to the latest version of Tapestry.
It is always advised to perform a full and complete build after upgrading.
You should also check the project-wide release notes for information about bugs fixes and other improvements.
The method getElementName() on interface Field was renamed to getControlName(). This brings the property in alignment with W3C documentation and terminology, and helps differentiate from the element name (i.e., the tag name used to represent the element in a component template).
This affects a number of existing components that implement the interface.
Method allocateElementName() on interface FormSupport was likewise renamed to allocateControlName().
The show and hide parameters of the Zone component now have a default binding prefix of "literal".
In addition, the client-side Tapestry.ZoneEffect object was renamed to Tapestry.ElementEffect to reflect that it can be used with elements that are not explicitly Zones.
The method invokeIfBlank() on interface Validator was renamed to isRequired().
The findMeta() method on interface MetaDataLocator has changed significantly; it now expands symbols and performs type coercion.
The GridModel interface and the prepare() method of GridDataSource have changed to accommodate the ability to sort using multiple columns.
The getWidth() method was removed from the PropertyModel interface; the logic for deducing the desired field size from the @Width annotation has been moved into AbstractTextField.
The data type for boolean values has changed from "checkbox" (reflecting how it is rendered in an edit form) to "boolean" (reflecting what it is). In addition, all numeric types are given the data type "number". This will only affect your application if you provided an overriding contribution to the BeanBlockSource service.
The return type for getStackTrace() on ExceptionInfo changed from List<String> to List<StackTraceElement>.
The store methods on these two interfaces were renamed to be more explicit. These are not methods typically invoked from user code.
The remove() method of BeanModel was renamed to exclude(), and a new method, include() was added. The remove parameter of BeanEditForm, BeanEditor, BeanDisplay and Grid were all renamed to exclude as well (and a new include parameter was added to each).