Road Map and Changes

A JIRA based RoadMap with the next planned improvements.

Changes (all since v0.1) :

Latest Stable Release - Version 2.3.0 - 27 March 2011

IMPORTANT: be sure to read the upgrade path when upgrading from previous releases.

Major new features

• Ajax support.
• Page Action support.
• Stateful Controls.

New documentation:

• Added a section covering the new Behavior support.
• Added a chapter on Ajax, covering AjaxBehaviors, Ajax execution flow and a full example.
• Added a section covering the new Page Action support.

New examples:

• Added examples showcasing the new Ajax support. See the Ajax Menu for the full list of examples.
• Added an example showing how to integrate a TabbedPanel, Form and Table.
• Added an example showing a Stateful TabbedPanel.
• Added an example FieldSeparator Control and example usage page [CLK-544].

Removed:

• Removed the ability to automatically bypass validation for Forms through JavaScript. This ability was added in 2.2.0 but raised concerns over security and was dropped for 2.3.0. If you used this feature in existing applications, please see the Upgrade path for a safe alternative to bypass validation. We apologize for the inconvenience.

Deprecated:

• Deprecated stateful page support: Page.setStateful().

  Stateful pages had the following issues:

  • Stateful pages was introduced to make it easier to store page state across multiple HTTP requests. However developing a stateful page is very different from developing a stateless one and this lead to Click applications that are inconsistent and harder to maintain.
  • In addition stateful page support has never been implemented consistently across the framework and some components did not work correctly.
  • Stateful pages are very coarse grained, making it difficult to control which objects are stored in the session.
  • Stateful pages have also introduced unnecessary complexity in the framework itself, which can now be phased out.
  Unfortunately there is no direct upgrade path from a stateful page. However the majority of use cases are catered for by the new stateful support in the controls: Table, Form, TabbedPanel, Field and AbstractLink.
• Deprecated TreeNode constructors which accepts a parent node. Instead use add to build the node hierarchy [CLK-743].
• Deprecated ActionListenerAdaptor since ActionListener only has a single method and no adaptor is necessary [CLK-731].

New features and issues resolved:

• Added new CayenneUtils method, applyMetaData(Form, Class), for adding validation metadata such as required and maxlength to form fields for a given DataObject type [CLK-756].
• Added support for multiple TabbedPanels on a page. To programmatically activate a specific TabbedPanel use the tabPanelIndex-<panel-name> request parameter, for example tabPanelIndex-myTabbedPanel [CLK-753].
• Improve fields to only be processed if they have an incoming request parameter. This improvement streamlines dynamic forms since fields added at runtime during s POST request won't bind their values and won't be validated for that request. In subsequent requests the Field will have an incoming parameter and so will have it's value bound and validated. Another advantage is that dynamically added Fields won't have their default value overridden in the POST request they were added in. This issue has been raised by Nirmal Solanki [CLK-722].
• Added automapping support for GAE with a caveat that page templates must be placed under the folders page or pages. This issue was raised by Ke Sun [CLK-639].
• Added MessagesMapService interface to support pluggable messages map implementations [CLK-655].
• Improved MessagesMap to be extendable and customizable [CLK-728].
• Added support for loading DateField translations for month and day names from the JDK. [CLK-650].
• Added support for Menus that do not have roles defined. If no roles are defined, IsUserInRoles passes a null argument to hasAccess to determine whether access is permitted to menus without roles [CLK-724].
• Added Polish language support. This issue was raised and fixed by Tomasz Bandura [739].
• Changed AbstractControl not to render the name attribute since it is only used for Field controls [CLK-699].
• Improved Table and Select to retrieve data from their DataProviders during the onRender event. This change allows exceptions thrown by DataProviders to be handled by the ErrorPage [CLK-684].
• Improved DateField to load the date-format-pattern on demand. This change allows one to override the default date-format-pattern from the page properties file: click-page.properties. [CLK-705].
• Added support for absolute page classnames when configuring pages in click.xml. Absolute classnames aids with IDE hot-linking and is less confusing to use. [CLK-704].
• Added a renderId property to ResourceElement to exclude the ID attribute from rendering [CLK-695].
• Improved CountrySelect to include more countries by using Locale.getISOCountries(). This issue was raised and fixed by Lorenzo Simionato [CLK-740].
• Fixed Control IDs to render underscores instead of periods [CLK-747].
• Fixed TabbedForm and CayenneTabbedForm JavaScript validation. This issue was raised and fixed by Tomasz Bandura [CLK-735].
• Fixed escaping of control values and attributes to be XML friendly in order to support Ajax requests. Previously all HTML characters was escaped, now only the following characters are escaped: <, >, ", ', & [CLK-674].
• Added method, ClickUtils.escape(String), to escape XML characters.
• Improved ClickUtils.encodeUrl to default to "UTF-8" if no request character encoding is available [CLK-720].
• Improved page header support allowing headers to be set from page constructor [CLK-711].
• Fixed Table controlLink which did not keep a reference to its parent [CLK-686].
• Fixed ConcurrentModificationException when rendering cached Menus from multiple threads [CLK-712].
• Fixed race condition while initializing cached menus [CLK-713].
• Fixed menu not rendering separator [CLK-681].
• Fixed SubmitLink to use Form id instead of Form name [CLK-701].
• Fixed Form validation to add and remove an error class [CLK-700].
• Fixed issue where Context.createPage could lead to duplicate page-to-class mappings. This issue was raised by Andrey Rybin and fixed by Md. Jahid Shohel [CLK-625].
• Fixed AutoCompleteTextField not to be added to parent Page [CLK-707].
• Fixed a potential memory leak when undeploying a click application. [CLK-706].
• Fixed issue where setting autobinding="default" throws exception. This issue was raised by Tsay Yaw Hann [CLK-714].
• Fixed Select to set an initial value when populated through a DataProvider. This issue was raised and fixed by Sander van Grieken [CLK-745].
• Fixed table headers that used incorrect title attribute when table is sortable. This issue was raised by Patrick Talbot [CLK-241].
• Fixed CayenneTemplate generics to align with Cayenne DataContext [CLK-750].
• Fixed readonly CheckList to use disabled attribute, same as Checkbox does [CLK-751].
• Removed the #FIXED attributes from the click.dtd which caused xml validation errors. This issue was raised by Ryan Holmes [CLK-717].
• Updated Velocity library to version 1.7 [CLK-748].
• Update to the latest version for some of the JARs dependencies: log4j-1.2.16, freemarker-2.3.16, commons-codec-1.4, and commons-lang-2.5, commons-io-2.0.1.
• Update to Velocity Tools 2.0 WebappResourceLoader [CLK-693].
• Replace EDU.oswego.cs.dl.util.concurrent.ConcurrentReaderHashMap with java.util.concurrent.ConcurrentHashMap. This issue was raised and fixed by Henry Saputra [CLK-636].
• Removed ognl.OgnlOps dependency. [CLK-694].

Archives

Version 2.3.0 Release Candidate 1 - 30 January 2011

See the release notes for 2.3.0.

Version 2.3.0-M1 - 28 November 2010

See the release notes for 2.3.0.

Version 2.2.0 - 22 May 2010

IMPORTANT: be sure to read the upgrade path when upgrading from previous releases.

Its worth highlighting that in this release we have removed the deprecated methods Page.getHtmlImports and Control.getHtmlImports. Users will have to migrate their code to use the new getHeadElements instead. Please see the section, migrating imports, for more details.

New examples:

• Dynamic Form demonstrates how to dynamically add new Fields at runtime.
• Dynamic FieldSet demonstrates how to dynamically add a FieldSet at runtime.
• Dynamic Select demonstrates how to dynamically add fields based on a Select field value.
• Disabled Demo demonstrates the behavior of disabled fields.

New features and issues resolved:

• Added DataProvider support for Table, Select, PickList and CheckList providing on demand loading of data. With DataProviders, users won't have to be concerned about which page event (onInit or onRender) to set the data on the control [CLK-640].
• Added PagingDataProvider interface to support large paginated result sets for Tables [CLK-640].
• Added a MenuFactory for creating and loading Menus from configuration files. All the static Menu methods have been deprecated and will be removed in a future release.
• Added an option for MenuFactory to not statically cache menus. This allows developers to cache menus in different scopes such as HttpSession. [CLK-405].
• Added i18n support for Menus loaded from menu.xml. The menu DTD now includes a new name attribute. By specifying a name attribute in menu.xml, the Menu will attempt to load its label and title from resource bundles [CLK-591].
• Added a Page Interceptor facility that provides an extension point for code which can listen to key page events and also interrupt normal page processing flow. [CLK-598].
• Added improved dynamic Form support. Forms can now optionally bypass validation for JavaScript based submissions using the new JavaScript function "Click.submit(form, validate)" [CLK-638].
• Added improved dynamic Page and Form behaviour through new helper methods that can bind and validate Forms and Fields before the onProcess page event e.g. in the Page constructor or "onInit" event. The new methods are:
  • ClickUtils.bind(Field)
  • ClickUtils.bind(Form)
  • ClickUtils.bind(AbstractLink)
  • ClickUtils.bindAndValidate(Field)
  • ClickUtils.bindAndValidate(Form) [CLK-638]
• Added improved disabled behavior through the following changes:
  • Disabled fields are not processed or validated
  • Disabled field values are not copied to domain objects
  • Disabled fields are automatically enabled if the field has an incoming request parameter, indicating that the field was enabled on the client using JavaScript. Please note that this behavior does not apply to Checkbox or Radio fields. See the setDisabled() javadoc for details [CLK-646].
• Added new method Container.replace for replacing an existing control with a new control. In previous releases, an exception would be raised if a page or container already contained a control with the same name as the newly added control. In 2.2.0 the replace method is automatically called when adding a control which name matches that of an existing control in the page or container. This behavior will likely only benefit stateful pages since stateless pages are recreated each request [CLK-666].
• Added methods to Fields for styling their labels. See new methods Field.setLabelStyle(String) and Field.setLabelStyleClass(String). This issue was raised by Stefax [CLK-595].
• Added methods to Fields for providing styling hints to their containing elements. See new methods Field.setParentStyleHint(String) and Field.setParentStyleClassHint(String). This issue was raised by Stefax [CLK-595].
• Added trim property to Field for controlling if the Field request parameter is trimmed or not. See new method Field.setTrim(boolean). This issue was raised by Andrey Rybin [CLK-627].
• Added new Context methods Context.hasRequestParameter(String) and Context.hasRequestAttribute(String).
• Added support to Select for a default option that can be used to validate non selection against and allows the Select to only populate its optionList at rendering time, instead of during onProcess event. [CLK-641].
• Improved default autobinding mode to bind both public fields and fields annotated with @Bindable. In previous versions the default autobinding mode only binded public Page fields [CLK-648].
• Added mock support for user principals and roles. This issue was raised and fixed by Sven Pfeiffer [CLK-585].
• Added localized Date format pattern support. This issue was raised by Andrey Rybin [CLK-610].
• Added Polish resource bundle for DateField. This issue was raised and fixed by Rafal Rusin [CLK-624].
• Migrated controls to import resources through Elements and the getHeadElements method [CLK-647].
• Improved SpringClickServlet to re-inject transient beans after stateful page deserialization. This feature is only supported when the stateful page instance is created by Click, not Spring [CLK-667].
• Replaced Page and Control getMessage methods with varargs equivalents [CLK-604].
• Removed Click core's dependency on Velocity. This issue was raised by by Andrey Rybin [CLK-606].
• Replaced multiple ClickUtils close methods with a single method accepting a Closeable. This issue was raised by Andrey Rybin [CLK-620].
• Improved ClickServlet to use the response's OutputStream if the Writer cannot be retrieved [CLK-644].
• Fixed issue where RadioGroup label referenced a non-existing ID. RadioGroup is now wrapped inside a span tag with the given ID. This issue was raised and fixed by Finn Bock [CLK-577].
• Fixed DateField to set seconds back to zero. This issue was raised by Andrey Rybin [CLK-664].
• The menu.dtd has been published to http://click.apache.org/dtds/menu-2.2.dtd. If you want your configuration to conform to the menu.dtd, include the following declaration in your menu.xml:

  <!DOCTYPE menu PUBLIC
         "-//Apache Software Foundation//DTD Click Menu 2.2//EN"
         "http://click.apache.org/dtds/menu-2.2.dtd"> 

• The new click-2.2.dtd has been published to http://click.apache.org/dtds/click-2.2.dtd. If you want your configuration to conform to the click.dtd, include the following declaration in your click.xml:

  <!DOCTYPE click-app PUBLIC
         "-//Apache Software Foundation//DTD Click Configuration 2.2//EN"
         "http://click.apache.org/dtds/click-2.2.dtd"> 

• Updated Velocity library to version 1.6.4.
• Updated Cayenne library to version 3.0.

Version 2.2.0-RC1 - 8 May 2010

See the release notes for 2.2.0.

Version 2.1.0 - 10 February 2010

IMPORTANT be sure to read the upgrade path when upgrading from previous releases.

Please Note: This release requires Java 1.5 or later.

New examples:

• Page HEAD elements demonstrates how to add JsImport, JsScript, CssImport and CssStyle HEAD elements to a Page.
• Control HEAD elements demonstrates how to add JsImport and CssImport HEAD elements to a custom Control.
• SubmitLink Demo shows how to use the new SubmitLink control.
• Large Dataset is an example of a Table with a large number of rows and how to lazily page through the rows using a custom data provider.
• Reusable Panel is an example of a reusable Panel which provides a Form for capturing Client details.
• Quartz Job Scheduler is an example demonstrating how to integrate the Quartz Job Scheduling framework into a Click application.
• Excel Table Exporter example demonstrates how to export a Click Table to an Excel spreadsheet using Apache POI.

New documentation:

• Documentation has been converted to Docbook and are made available in three different flavors: PDF, HTML (single page) and HTML (multiple pages). Thanks to Gilberto C Andrade for doing the conversion [482].
• Added documentation describing the new HEAD element support. Please see the new section on Page HEAD elements here and the section on Control HEAD elements here.
• Added a new section, Deploying resources in a restricted environment, describing how to deploy static resources in environments where WAR/EAR are not unpacked or where file system permissions are restricted, such as Google App Engine.

Deprecated:

• Deprecated methods: Control.getHtmlImports() and Page.getHtmlImports(). These methods have been deprecated in favor of Control.getHeadElements() and Page.getHeadElements().
• Deprecated methods: Page.getPageImports() and Page.setPageImports(). These methods have been deprecated in favor of Page.getHeadElements().

New features and issues resolved:

• Added support for Google App Engine, a free Java hosting environment from Google. This provides an ideal environment for students and startups to easily host their Click applications online. See GoogleAppEngineListener for details [560].
• Added support for an in-memory File Upload Service that can be used for uploading files in a Google App Engine environment.
• Added support for templates with custom extensions through the new ConfigService.isTemplate method. The default ConfigService implementation, XmlConfigService, provides support for the extensions .htm and .jsp, but new extensions can be provided in a subclass. See the JavaDoc for details [568].
• Added support to the Page class for conditionally including Control head elements through the new method includeControlHeadElements [571].
• Added support to deploy resources inside JARs from the Servlet 3.0 compliant location, META-INF/resources. Click's own pre-packaged resources are now also located in the JAR under META-INF/resources [570].
• Added new Calendar popup to DateField. This Calendar popup uses Calendar Date Select which is based on the Prototype JavaScript library.

  Please note if you don't want a dependency on the Prototype library you can use the third-party Click Calendar instead.

• Added first class support for HEAD elements such as JavaScript and Css. The following classes were added: Element, ResourceElement, JsImport, JsScript, CssImport and CssStyle. A new method was added to Page and Control: Control.getHeadElements() and Page.getHeadElements() [501].
• Added SubmitLink control that can submit a Form [519].
• Added HiddenList control for rendering and submitting a list of hidden fields [491].
• Added pluggable security access controller (AccessController) to Menu class. This pluggable interface enable use of security frameworks such as Spring Security (Acegi) or JSecurity to control user access to Menu items. This issue was raised by Demetrios Kyriakis [406].
• Added an Ant task, called DeployTask, for deploying static resources at build time. This task is useful when deploying Click applications in restricted environments. For more details see the section: deploying resources in a restricted environment.
• Added a ResourceService, for serving static resources at runtime. This service is useful when deploying Click applications in restricted environments. For more details see the section: deploying resources in a restricted environment [564].
• Added method, ClickUtils.createTemplateModel, which returns a template model containing objects such as the Context path, Page path, HTTP request, HTTP response, HTTP session etc.
• Added ability to specify a custom TreeNode icon through the new method TreeNode.setIcon(String). This issue was raised and fixed by Tim Hooper [494].
• Added method Format.url for encoding URL's in templates [399].
• Added method FieldColumn.setProperty that can be overriden to provide custom binding for complex domain objects. This issue was raised and fixed by WarnerJan Veldhuis [528].
• Added TypeConverter configuration option to ClickServlet. See getTypeConverter() method for details. This issue was raised Joseph Schmidt and fixed by Adrian A. [539].
• Added Slf4jLogService for supporting multiple application servers. This issue was raised Oliver Burn [555].
• Added @Bindable annotation support for page field autobinding. @Bindable supports public, protected and private Page variables [556, 599 ].
• Added property files with translation for the Russian language. This issue was raised and fixed by Andrey Rybin [607], [611].
• Added new Tree methods setWidth / getWidth and setHeight / getHeight. Also fixed rendering issues in IE6/7 for long node labels that overflow the tree width [616].
• The click.dtd has been published to http://click.apache.org/dtds/click-2.1.dtd. If you want your configuration to conform to the click.dtd, include the following declaration in your click.xml:

  <!DOCTYPE click-app PUBLIC
         "-//Apache Software Foundation//DTD Click Configuration 2.1//EN"
         "http://click.apache.org/dtds/click-2.1.dtd"> 

• Improved Form validation to allow Form subclasses to override the validate method and implement cross-field validation. The following changes were made: the previous validate method was renamed to validateFileUpload and a new empty validate method was introduced, that can safely be overridden in subclasses [572].
• Improved Page redirect to support parameters. See the new Page methods setRedirect(String, Map) and setRedirect(Class, Map) This issue was raised and fixed by Adrian [536].
• Improved Link Controls to support multivalued parameters through the new AbstractLink methods getParameterValues() and setParameterValues() [554].
• Improved Table to support very large datasets by promoting the methods getFirstRow() and getLastRow() as public. These methods provide the necessary information to only retrieve the displayed rows [504].
• Improved LinkDecorator to support target identifier property parameter names. This issue was raised by Demetrios Kyriakis and fixed by fixed by Adrian A. [400].
• Improved PickList methods getValueObject() and setValueObject(Object) to delegate to getSelectedValues() and addSelectedValue(String) respectively [490].
• Improved Spring integration with SpringClickServlet and PageScopeResolver, supporting Spring instantiated Pages with @Component configuration [534].
• Improved CompressionServletResponseWrapper and CompressionResponseStream classes to have public visibility to enable use in custom servlet Filters [547].
• Improved Menu control to render attribute class="selected" when the menu item is selected. This issue was raised and fixed by Frederic Daoud [551].
• Improved PerformanceFilter to implement exclude-paths filtering [498].
• Improved XmlConfigService to scan for deployable resources inside folders on the classpath [552].
• Improved Cayenne DataContextFilter, including adding support for LifecycleListener registration [559].
• Improved AbstractLink to allow rendering of both icon and label in Link controls (default behavior renders either a label or an icon) [535].
• Improved Page and Control message handling with null args. This issue was raised by WarnerJan Veldhuis [600].
• Fixed resource deployment on JBoss 5 and up. The solution is based on the work done by the Stripes Framework developers [589].
• Fixed Click Calendar memory leak in calendar popup with version 1.0.1 released [499].
• Fixed Column sorting to recognize numbers inside strings. This issue was raised by Venkatt Guhesan [489].
• Fixed a bug where FieldSet was not set as the parent of its child controls. This issue was raised by James P Brown [497].
• Fixed FormTable sorting bug. Added FormTable sort methods setSortedColumn, setSortedAscending, setPageNumber for programmatic sorting. This issue was raised and fixed by Ben Warner [527].
• Fixed a bug in AutoCompleteTextField where if the field was removed from a Form, its JavaScript resources would still be rendered. This issue was raised by Paul Zammit [546].
• Fixed extras pom.xml dependencies [492].
• Fixed a bug in control.js which caused the addLoadEvent event queue to be reset if multiple control.js scripts are imported in the same page. This issue was raised by Adrian [503].
• Fixed PerformanceFilter and CompressionFilter to properly handle <jsp:include> requests [557].
• Fixed SubmitLink to call Form javascript validation before submitting form. This issue was raised and fixed by Finn Bock [586].
• Fixed DateField not to render help property twice. This issue was raised by Finn Bock [574].
• Fixed bug where pages in the default package was not loaded. This issue was raised by Thiago Senna [575].
• Fixed bug in HibernateForm that did not apply required field constraints [583].
• Updated Velocity library to version 1.6.3.
• Updated Cayenne library to version 3.0M6.
• Updated Commons Collection library to version 3.2.1.
• Updated Prototype.js library to version 1.6.1.

Version 2.1.0-RC1 (Apache incubator) - 28 June 2009

See the release notes for 2.1.0.

Version 2.0.1 (Apache incubator) - 15 February 2009

IMPORTANT be sure to read the upgrade path when upgrading from Click 1.4 or earlier.

This is our first Apache Incubator release and is based on Click 1.5.1.

Please note that because of licensing issues, certain third-party libraries were removed and are hosted externally.

Version 1.5.1 (pre-Apache) - 23 January 2009

IMPORTANT be sure to read the upgrade path when upgrading from Click 1.4 or earlier.

Please note that this release is provided outside of the ASF and is not endorsed or approved by the Apache Software Foundation.

The following issues were resolved since 1.5:

• Added Turkish language support. This issue was raised and fixed by Ali Ok. [476].
• Improved exception handling when a Control name is not defined [473].
• Added new constructors to extra controls which accepts the size attribute. This issue was raised by Christophe Foiret [475].
• Added MessageFormat support to Format. New methods include message(String, Object) and message(String, List). This issue was raised by Yu Kobayashi [474].
• Added new methods to CheckboxTree to improve customization. The new methods include renderCheckbox and getInputType.
• Added csv mime type. This issue was raised by Alvin Townsend.
• Fixed URL rendering to encode ampersand characters. [483].
• Fixed HiddenField to work with java.sql.Timestamp, java.sql.Time and java.sql.Date. [484].
• Fixed WebappLoader to reload Velocity global macro's [467].
• Fixed Page.setRedirect to check if redirect path starts with context path. This issue was raised by Christophe Foiret [468].
• Fixed a regression when manually setting the Page path to a JSP. [141].
• Fixed DateField's French translation. This issue was raised by Alvin Townsend.

Version 1.5 - 2 November 2008

IMPORTANT be sure to read the upgrade path when upgrading from Click 1.4 or earlier.

The following issues were resolved since 1.5 RC3:

• Added Dutch language support, contributed by Christopher Highway.
• Improved Form to process controls even if their names is not defined. [463].
• Fixed ContainerUtils.copyTo where the wrong getter method could be used when a domain object contains multiple overloaded getter methods. This issue was raised by Alvin Townsend [461].
• Fixed Column internal Comparator which does not take sort order into consideration for non Comparable instances [462].
• Fixed Panel.getId() to return null if name is not defined [464].
• Fixed VelocityTemplateService to cater for custom defined Velocity loggers. This issue was raised by Vikram Natarajan [465].

Version 1.5 RC3 - 19 October 2008

IMPORTANT be sure to read the upgrade path when upgrading from Click 1.4 or earlier.

New examples:

• Wizard demo shows how to leverage a stateful page and Panels to create a process flow. Each Step in the process is represented by a Panel which is managed by the stateful Page.
• Populate on select shows how items in one combo box is populated based on the selected item in another using JavaScript.
• FormTable demo shows how a FormTable can be used together with an existing Form.
• Page link tree provides a demonstration of using the Tree component to link to different pages.

New documentation:

• Added a full configuration example containing all click.xml DTD elements and attributes.

The following issues were resolved:

• Added FormTable.properties containing a new property formtable-error. When adding FormTable to an external From, the formtable-error will be displayed if one of the FormTable fields contains an error.
• Renamed ContainerUtils method getFields to getInputFields which better reflect its behavior [457].
• Fixed TabbedForm and TabbedCayenneForm to import JavaScript and CSS from their superclass. This issue was raised by Christophe Foiret [450].
• Fixed CayenneForm performing multiple inserts [452].
• Fixed FormTable duplicate HTML imports [453].
• Fixed XmlConfigService not deploying JAR resources [454].
• Fixed Page.setRedirect to guard against duplicate context paths. This issue was raised and fixed by Ricardo Lecheta [456].
• Fixed CountrySelect to exclude duplicate countries. This issue was raised and fixed by Christopher Highway [458].

Development Release - Version 1.5 RC2 - 29 September 2008

IMPORTANT be sure to read the upgrade path when upgrading from Click 1.4 or earlier.

• Emergency Fix: Click throws FileNotFoundException when deploying click-extras.jar [448].
• Click should automatically remove a Control from its parent when adding it to another Container. This issue was raised and fixed by Ricardo Lecheta [449].
• Added utility methods ClickUtils.encodeURL and ClickUtils.decodeURL for encoding and decoding URL's using the "UTF-8" encoding scheme.

Development Release - Version 1.5 RC1 - 28 September 2008

IMPORTANT be sure to read the upgrade path when upgrading from Click 1.4 or earlier.

• Refactored Paginator into a more generic interface called Renderable which is independent of any specific Control [434].
• Add new LinkDecorator methods renderActionLink and renderActionButton. This allows more fine grained control over the rendered links, for example manipulating request parameters. [446].
• Add Table Row attribute support through new method addRowAttributes. This issue was raised by Hans Poo [431].
• Field error messages can now be specified per instance. See the JavaDoc for more details. This issue was raised and fixed by Ricardo Lecheta [433].
• Added new utility methods copyContainerToObject and copyObjectToContainer to selectively exclude or include form fields when populating domain objects. This issue was raised by Khalef Bessaih [440].
• Encapsulate conversion logic of template extensions inside Page.setRedirect(java.lang.String) which allows one to override or overload the default behavior. This issue was raised by David Ballard [429].
• Improved Table so that subclasses can specify a different controlLink implementation by overriding getControlLink(). This issue was raised and fixed by Ricardo Lecheta [442].
• Improved ClickUtils.toLabel to return empty String ("") if argument is null [441].
• Improved DateField to return a cached Date representation on subsequent retrievals. This issue was raised by Tore Halset [316].
• Fixed RegexField validation to ignore empty values. This issue was raised by Muzaffer Ozakca [436].
• Fixed TabbedPanel to trigger the registered tab listener. This issue was raised by Marcelo Grassi Franco Melgaço. [432].
• Improved redirect and forward to JSP templates. [435].
• Fixed HtmlFieldSet to properly close the fieldset end tag. This issue was raised by Gilberto C. Andrade [427].
• Fixed AbstractContainerField not to bind its request parameter. This issue was raised by Gilberto C. Andrade [428].
• Fixed Column which exposed its internal Comparator as public API through Column.setComparator(Comparator), instead of java.util.Comparator. [430].
• Fixed LinkDecorator not to add Table parameters to PageLink, as it is redundant. This issue was raised by Joel Schmidt [270].

Development Release - Version 1.5 M3 - 17 August 2008

IMPORTANT be sure to read the upgrade path when upgrading from Click 1.4 or earlier.

• Major refactoring to improve backward compatibility and upgrade path. This includes removing BasicForm which was included in 1.5-M1 and adding new Controls HtmlForm and HtmlFieldSet. You can find an example of HtmlForm in action here.
• Added support for multiple page package definitions in click.xml configuration. See the configuration topic Multiple Pages Packages for more details. This issue was raised by Ricardo R. Lecheta [328].
• Added configurable table Paginator support and an InlinePaginator. A new example shows the different Paginator options available. This issue was raised by Gustav Weber [390].
• Added readonly and disabled support to FieldSet. If enabled Fields contained in FieldSet will be disabled or made readonly. [423].
• Added Table footer rendering support, so that column totals can be rendered in a table [425].
• Improved Table rendering performance in the order of 25-45%.
• Improved rendering performance by caching the ClickUtils resource version indicator [412].
• Improved Page and PageImports to allow a Pages to optimize their HTML imports. Please see Click Examples for a demonstration [363].
• Fixed issue where Select validation can throw ClassCastException when option list contains an OptionGroup. This issue was identifier by Christophe Foiret [374].
• Fixed issue where Container can be added to itself. This issue was identifier by Harry Wissiak [414].
• Fixed Page serialization issues with non serializable Format and PageImport objects. This issue was identifier by Alexei Sokolov [416].
• Fixed issue where CayenneForm clearValues() was hidden data object classname. This issue was identifier by Wisking Ju Yu Wu [417].
• Fixed issue where TabbedPanel was invoking the activePanel's onInit() method twice. This issue was identifier by Wisking Ju Yu Wu [420].

Development Release - Version 1.5 M2 - 20 July 2008

IMPORTANT be sure to read the upgrade path when upgrading from Click 1.4 or earlier.

Click 1.5 M2 introduced major enhancements to Control listener support.

• New Control listener support through the ActionListener interface. This control listener style provides compile time safety and supports code refactoring tools.

  public class MyPage extends Page {
  
      public void onInit() {
          Submit submit = new Submit("submit");
          
          submit.setActionListener(new ActionListener() {
              public boolean onAction(Control source) {
                  // Perform submit action and return true to continue processing
                  return true;
              }
          });
      }
  } 

  Note that the source Control is passed in as an argument to the onAction method. For very complex scenarios it is useful to know which Control triggered the event [369].
• Introduce a two phase listener dispatch mechanism. During the onProcess event, Control listeners will be registered on the ActionEventDispatcher and triggered after the onProcess event finish. The net effect of this change is that when Control listeners are triggered, all request values have been bound to Controls, and can safely be referred to from the listener [365].
• Added button support to FieldSet, so that buttons can be rendered inside FieldSets. This change has been enabled by two phase processing which ensures all FieldSet fields are processed before button listeners are invoked [401].

The following is a list of enhancements and bugs fixes:

• Added a new PageButton control [392].
• Introduced a new resource deployment strategy for Jars containing Page and Control resources. When Click starts up, it scans each Jar found in the web lib folder (webapp/WEB-INF/lib) for entries starting with 'META-INF/web/'. All files found under 'META-INF/web/' will be copied verbatim to the web application folder.

  See the section Deploying Custom Resources for more detail. [393].

• Add new method CheckboxTree.setSelectChildNodes that enables selecting child nodes when parent is selected. This feature only works if the Tree's Javascript support is enabled. [209].
• Added property files with translation for the Romanian language. This issue was raised and fixed by Marius Petrus [361].
• Add width support to TabbedPanel control [376].
• Add static method Context.hasThreadLocalContext(). Useful for checking if a Context is available on the Context stack [382].
• Add ClickUtils autoPostRedirect() method to support SAML integration [398].
• Updated Container renaming method Container.add(int, Control) to Container.insert(Control, int) to better reflect the intention [381].
• Update Form to use control message bundles for label required prefix/suffix [383].
• Update HtmlStringBuffer to support method chaining. This issue was raised by Demetrios Kyriakis [396].
• Updated Menu so that it is now only cached in production or profile modes. In other development modes, changes to menu.xml is seen immediately. [408].
• Updated AbstractContainerField control moving it to Click Extras. [410].
• Fixed TabbedPanel bug whereby inactive panel HTML imports are included in page [366].
• Fixed FieldSet recursive remove bug [367].
• Fixed bug when manually invalidating HttpSession [371].
• Fixed PropertySelect add ordering to query bug [372].
• Fixed message properties to resolve all parent messages [373].
• Fixed Labels not rendering in a FieldSet bug [377].
• Fixed Form removeField throws IllegalArgumentException bug [378].
• Fixed FieldSet restoring FieldSet ability to set number of table columns the FieldSet is rendered with [379].
• Fixed bug where Format is not available in template of stateful pages. [409].

Development Release - Version 1.5 M1 - 18 May 2008

IMPORTANT be sure to read the upgrade path when upgrading from a previous version.

Click 1.5 (currently in development) introduces important new features including:

• Container - new interface for building arbitrary complex, hierarchical Controls.
• Services - Click core has been refactored into pluggable services.
• Mock Test Support - Unit and Functional Testing.
• AbstractControl - AbstractControl was extended to implement all Control methods, making it easier to create custom controls.

New examples and documentation were added:

• New examples:
  • Country Select field
  • Custom Form Layout using Containers
  • Virtual Keyboard field
  • Excel Export Demo
  • JSP - Edit Customer
  • JSP - Navigation
  • JSP - Multi Path Demo
• New documentation:
  • Container
  • Template vs Container layout
  • Click Runtime Services
  • Mock Test Support

A new Powered by Click section was added. If you want to enlist your site, please send a mail to one of our Mailing Lists or directly to "sabob1 at gmail.com".

The following is a list of enhancements and bugs fixes:

• Added Freemarker support as an alternative templating engine to Velocity, with new FreemarkerTemplateService.
• Added a Country Select control based on the JDK's own built in Country/Locale support.
• Added a Virtual Keyboard control using GreyWyvern JavaScript library.
• Added support for setting Form action URL attribute. This issue was raised by Erdem Gunay [319].
• Added support for Page HTML imports with a new getHtmlImports() method. This enables Pages to programmatically define HTML imports which will be included in a border template using the PageImports object. This issue was raised by David Frizelle [329].
• Add Page setTemplate(String) method to enable dynamic changing of a page border template. This issue was raised by Huy Do [353].
• Updated Page.setPath to handle JSP resources. This issue was raised and fixed by Huy Do. [141].
• Added support for Hibernate AnnocationConfiguration. This issue was fixed by Jean-Francois. [355].
• Improved FileUpload support. This issue was raised by Ricardo Lecheta [326].
• Improve File Upload support with new FileUploadService class. [326].
• Fixed PropertySelect which is not reset to original value. This is was raised by Tore Halset [317].
• Fixed Cayenne 3.0M3 DataObjectUtils issue in CayenneForm when using JDK 1.5. Added CayenneUtils helper class [342].
• Upgraded the following libraries:
  • commons-lang 2.1 -> commons-io 2.4
  • commons-io 1.3 -> commons-io 1.4
  • commons-fileupload 1.2 -> commons-fileupload 1.2.1
  • Hibernate 3.1.3 -> Hibernate 3.2.6
  • Spring 1.2.9 -> Spring 2.5.4
• Removed support for Cayenne 1.2.x.

Version 1.4.2 - 12 April 2008

• Fixed ExcludePage should be a public class [346].
• Fixed Maven artifacts packaging [348].
• Fixed slight performance degradation [349].
• Fixed PageLink to change extension jsp to htm [352].
• Fixed DateField and ChartFields to include the javascript control.js [354].
• Fixed DateField which produced duplicate stylesheet links. [356].

Version 1.4.1 - 30 March 2008

Developer Bob Schellink accepts new Project Leader role for the Click project.
New developer Ricardo Lecheta joins the Click project.

• Added new method Context.isAjaxRequest() which enables conditional checking for Ajax requests.
• Upgradeded to Scriptaculous 1.8.1 to fix auto form submit. This issue was raised by Andy Key. [336].
• Fixed deployment of resources when servlet container does not unpack war. [340].
• Fixed sendRedirect to convert .jsp extension to .htm when redirecting to a JSP page. [338].
• Fixed Form clearValues() to exclude certain HiddenFields from being cleared. [337].
• Fixed Form action incorrect when using JSP. This issue was raised by Chas Erickson. [334].
• Fixed Form.onSubmitCheck() to ignore Ajax calls. This issue was raised by Ivan Furdi. [333].
• Fixed Form and FieldSet column layout bug [331].
• Fixed Table column sorting issue with string values. This issue was raised by Ben Young [344].
• Fixed Table style issues with sorted columns [345].

Version 1.4 - 2 March 2008

• Updated Cayenne controls to support Cayenne version 3.0.
• Fixed CayenneForm save() method inserting multiple new entries bug. This issue was raised and fixed Tore Halset [307].
• Fixed Table invalid handling params bug. This issue was raised and fixed by Satoshi Takata [308].
• Fixed DateField readonly JavaScript bug. This issue was raised by Tore Halset [309].
• Fixed DateField Dutch Calendar translation. This issue was raised by Harry Wissiak [310].
• Fixed DateField $imports usage JavaScript bug. This issue was raised by Itou Akihiro [311].
• Fixed bug where charset encoding being set after request parameters are read. This issue was raised and fixed by Ricardo Lecheta [312].
• Fixed ThreadLocal Context forwarding bug on Jetty 5.1.*. This issue was raised by Ricardo Lecheta [314].
• Fixed 'script.aculo.us' Ajax.Autocompleter bug with IE. This issue was raised by Itou Akihiro [322].
• Fixed CompressionServletResponseWrapper NPE bugs on WebSphere and Jetty. This issue was raised by Ricardo Lecheta and Bob Schellink [323].
• Updated documentation and examples.

Version 1.4 RC3 - 6 February 2008

• Added PerformanceFilter to significantly improve the performance of Click applications [284, 290].

  Click Framework now supports Exceptional Performance best practices for speeding up your web site. This filter combined with framework changes enable Click applications to get an Grade A rating with Yahoo's YSlow.

• Added Stateful Pages topic and completed framework support for serializing stateful Pages and their controls.
• Added new AJAX AutoCompleteTextField which provides Google suggest style lookups.
• Added new Table CSS class styles: blue1, blue2, orange1, orange2
• Updated Form.copyFrom() to align with special Map handling of Form.copyTo(). This issue was raised and fixed by Bob Schellink [278].
• Updated Form submit check to handle multiple forms per page. This issue was raised and fixed by Bob Schellink [279].
• Updated Table to nullify rowList property. This issue was raised and fixed by Bob Schellink [283].
• Updated Controls to use the new API addStyleClass(String) and setStyle(String, String) [286].
• Updated JS addLoadEvent() to use Prototype Fixed exception when using Form.onSecurtyCheck in a stateful form. This issue was raised by Bob Schellink [245].
• Fixed Table isi style rendering problems. This issue was raised by J.F. Zarama [196].
• Fixed DateField JavaScript format pattern bug. This issue was raised by Itou Akihiro and fixed by Itou Akihiro and Naoki Takezoe [250].
• Fixed exception when using Form.onSecurtyCheck in a stateful form. This issue was raised by Joel Schmidt [267].
• Fixed PickList multiple selection bug. This issue was raised by Ricardo Lecheta [280].
• Fixed Context leak under heavy usage. This issue was raised and fixed by Bob Schellink [282].
• Fixed Page automapping bug. This issue was raised by Sep and Ricardo Lecheta [277, 294].
• Fixed Linux ResourceBundle classloading bug. This issue was raised by Victor [293].
• Fixed Tree encodeURL bug. This issue was identified by Thomas Bernhard [301].
• Fixed Table memory allocation bug for large paged rowLists. This issue was identified by Naoki Takezoe [305].
• Updated Cayenne library to version 2.0.4, which fixes a memory leak in version 2.03. This issue was raised by Bob Schellink [281].
• Updated the JavaScript Prototype library to version 1.5.0 and 'script.aculo.us' to version 1.7.0.
• Updated documentation and examples.

Version 1.4 RC2 - 2 January 2008

• Added property files with translation for the Czech language. This issue was raised and fixed by David Marko [242].
• Added facility to load click.xml from class path if not found user WEB-INF. This issue was raised and fixed by Andre Bremer [273].
• Added Calendar property and JS files with translation for the Dutch language. This issue was raised and fixed by Harry Wissiak [275].
• Added Table property clearRowListOnDestroy. This issue was raised by Joel Schmidt [268].
• Updated ExternalLink control renaming method setPageClass to setTargetPath. This issue was raised by Itou Akihiro [244].
• Updated FieldSet to support rendering without a Legend. This issue was raised by Joel Schmidt [257].
• Updated MessageMap to improve cache key. This issue was raised and fixed by Bob Schellink [274].
• Fixed bug where double "class" attributes are rendered in HTML for Field controls if validation is failed. This issue was raised Shuo Geng and fixed by Bob Schellink [233].
• Fixed translation errors for French properties. This issue was raised and fixed by Patrick Talbot [238].
• Fixed ClickUtils copyFormToObject() method Map support. This issue was raised by Harry Wissiak and fixed by Bob Schellink [239].
• Fixed JSP page recursion bug when not border template defined. This issue was raised and fixed by Ricardo Lecheta [237].
• Fixed DataContextFilter always creating HttpSession bug. This issue was raised by Florin T.PATRASCU [240].
• Fixed ClickApp NPE bug on OC4J application server. This issue was raised by Harry Wissiak [248].
• Fixed Context handling of multivalue parameters on multipart file upload requests. This issue was raised by Bob Schellink [252].
• Fixed classloader issue when click JARS not contained in web application. This issue was raised by Harry Wissiak [256].
• Fixed missing language properties. This issue was raised by Bob Schellink [269, 271].
• Fixed FormTable missing field imports bug. This issue was raised by François-Xavier Guillemette [CLK-272].
• Fixed ClickUtils getMimieType() not supporting upper case file extensions. This issue was raised by Ben Warner [CLK-276].
• Updated documentation and examples.

Version 1.4 RC1 - 15 September 2007

• Important Change the Page stateful property added to support persistence.
• Important Change the Context object is now available in Page and Control constructors.
• Important Change added Control onInit() initialization event handler. As the setContext() method has been removed any control initialization code contained in this method should be migrated to the new control onInit() method.
• Important Change the XML configured root Menu item is obtained via the static method getRootMenu().
• Important Change multipart file upload requests are now processed using a globally configured Commons FileUpload class. Please see the CommonsFileUploadService for more details. This change enables for request parameter auto binding on multipart file upload requests.
• Important Change Click Extras now supports Apache Cayenne 2.x rather than Objectstyle Cayenne 1.2.x by default. Note backward compatibility Cayenne 1.2.x JARS are provide in the dist directory.
• Added Control onRender() render event handler. This method is useful for Panel controls populating tables.
• Added Control onDestroy() destroy event handler. This method is useful for controls to free resources, when the controls are contained in stateful pages.
• Added ExternalLink control.
• Added AbstractControl getPage() method.
• Added Context getRequestParameterValues() method.
• Added Context isGet() method.
• Added Field help property to render help text to the right hand side of fields.
• Added Menu imageSrc property to support for rendering img icons in menus.
• Renamed Context method getRequestParameters to getRequestParameterMap.
• Update localization click-control_pt_BR.properties provided by Ricardo Lecheta [221].
• Updated Select, CheckList and PickList controls to use standard getSelectedValues() method. This issue was raised by Christophe FOIRET [226].
• Removed Page and Control setContext() methods.
• Removed FileField fileUpload property.
• Fixed Page control autobinding bug. This issue was raised Christophe FOIRET [195, 212].
• Fixed ClickApp not picking up new Page classes dynamically. This issue was raised and fixed by Bob Schellink [222].
• Fixed Form isFormSubmission() method fails when called twice with multi-part request bug [224].
• Fixed macro.vm is only available if war is unpacked bug. This issue was raised by Andrus Adamchik and fixed by Bob Schellink [230].
• Fixed OGNL Double to BigDecimal type conversion bug. This issue was raised by Ben Warner [OGNL-122].
• Updated Cayenne library to version 2.0.3.
• Updated documentation and examples.

Version 1.3.1 - 11 June 2007

• Updated CayenneForm to handle non integer primary key values. This issue was raised by Tore Halset [211].
• Fixed RadioGroup is still active when set it to disabled bug. This issue was raised by Christophe FOIRET [218].
• Fixed Form file upload character encoding NPE. This issue was raised by David Rosenstark [220].
• Updated Commons FileUpload library to version 1.2. Fixes bug where file names are being converted into lowercase.
• Updated Commons IO library to version 1.3.
• Updated Cayenne library to version 1.2.3.
• Updated Spring library to version 1.2.9.

Version 1.3 - 5 June 2007

• Important Change the Pages event execution order has changed with the onSecurityCheck() method now invoked before the onInit() method. The benefit of this is that the onInit() is only invoked if the request has passed the onSecurityCheck().
• Added PickList control. This control was created by Naoki Takezoe [194].
• Added Tree control client side javascript functionality. This was provided by Bob Schellink [186].
• Added autobinding configuration option. This issue was raised by Ahmed Mohombe [199].
• Added tabindex support to AbstractLink and Field controls.
• Added Form defaultFieldSize property.
• Improved trace level logging to detail Page event execution order.
• Improved EmailField validation.
• Changed default Form errorPostion from "middle" to "top".
• Fixed CayenneForm handling of new objects bug. This issue was raised by Andrus Adamchik [73].
• Fixed FileField configurations not be applied in certain scenarios. This issue was raised and fixed by Sadanori Ito [179].
• Fixed Page with two Table controls produces unneeded css style text bug. This issue was raised by J.F. Zarama [197].
• Fixed LinkDecorator table sorting support. This issue was raised by Louis Martin and fixed by Bob Schellink [207].
• Fixed Table column sorting bug. This issue was raised by Louis Martin and fixed by Naoki Takezoe [208].
• Updated documentation and examples.

Version 1.2 - 22nd March 2007

New developer Bob Schellink joins the Click project.

• Added controls Tree and CheckboxTree. These controls were created by Bob Schellink [160].
• Added controls JSBarChart, JSLineChart and JSPieChart. These controls were created by Ahmed Mohombe. Update: these controls were moved to the Click Charts project.
• Added Field convenience methods for setting style, text-align and width HTML attributes.
• Added support for multiple ActionButton parameters, see setParameter() for details.
• Added AbstractLink imageSrc property for rendering img icons inside links.
• Added class hierarchy messages inheritance to MessagesMap. This issue was raised by Andrus Adamchik [74].
• Added ActionButton support to LinkDecorator. This issue was raised by Ricardo Lecheta [135].
• Added ordering support to PropertySelect. This issue was raised by David Frizelle [154].
• Added FieldSet columns property. This issue was raised by Lorenzo Orselli [158].
• Added optional property to QuerySelect and PropertySelect controls. This issue was raised by Lorenzo Orselli [156].
• Added support for NamedQuery objects in PropertySelect. This issue was raised by David Frizelle [166].
• Added Italian and French ColorPicker and TelephoneField properties provided by Lorenzo Orselli [171].
• Added Chinese localization properties provided by Larry Li [177].
• Added ClickUtils cookie handling methods, and convenience methods in the Context class. These methods were derived from the Atlassian CookieUtils class.
• Added Menu properties external and target, and changed toString() method to render an HTML anchor tag. These changes simplify menu Velocity macros. Please note the isUserInRoles() method now returns false if there are no roles defined for the menu item.
• Added DataContextFilter support for session or request scope DataContext objects, and controlling the use of the Cayenne shared cache.
• Added Cayenne DAO/Service base class CayenneTemplate to Click Extras.
• Added automapping support for /click/error.htm pages.
• Added ClickServlet createClickLogger() method to support customizing Click runtime engine logging. This issue was raised by Bob Schellink.
• Added Column titleProperty attribute to support rendering <td> title attributes. This issue was raised by David Frizelle.
• Added ClickIDE documentation.
• Added Page Request Param Auto Binding documentation topic.
• Added Best Practices Packages and Classes documentation topic.
• Improved usability of Field labels, providing field label focus support. This issue was raise and fixed by Sadanori Ito [159].
• Improved ImageSubmit src rendering by prefixing context path [165].
• Improved Column i18n support for header titles. This issue was raised by Ricardo Lecheta [176].
• Improved Form endTag() rendering to include JavaScript focus and validation code.
• Improved Table column sorting.
• Improved error reporting for IllegalArgumentExceptions.
• Improved AbstractLink rendering of disabled links, now render as a span element.
• Refactored DoubleField, IntegerField and LongField to subclass NumberField. This issue was raised by Ahmed Mohombe [120].
• Removed support for logging to Servlet log.
• Fixed ActionLink setValueObject() not setting null values. This issue was raised by David Frizelle [150].
• Fixed multiple Form support in pages with an file upload form [152].
• Fixed readonly support in Checkbox, Radio and Select controls. These issues were raised by Lorenzo Orselli and David Frizelle [155, 164].
• Fixed error position support in TabbedForm control. This issue was raised by Lorenzo Orselli [157].
• Fixed differences of Java/JavaScript error message. This issue was raised and fixed by Sadanori Ito [161].
• Fixed first day of week bug in DateField control. This issue was raised and fixed by Sadanori Ito [170].
• Fixed Form copyTo Map support. This issue was raised by Louis Martin [172].
• Fixed FileField JavaScript validation bug. This issue was raised and fixed by Sadanori Ito [178].
• Fixed PropertySelect applies ordering twice bug. This issue was raised by Larry Bunton [183].
• Fixed wrong form HTML generation. This issue was raised by Ricardo Lecheta [189].
• Update Velocity library to version 1.5-beta2.
• Updated Cayenne library to version 1.2.2.
• Updated documentation and examples.

Version 1.1 - 22 November 2006

New developer Stephen Haberman joins the Click project.

• Added Form field width grid layout rendering option. See the Form add(field, width) method.
• Added Table Column sorting support. See the Column sortable property.
• Added Column convenience methods for setting width, text-align, vertical-align attributes, and setting data and header styles.
• Added auto binding of request values to public Page fields. See the ClickServlet method processPageRequestParams() for details. This addition was raised by Stephen Haberman.
• Added Form clearValues() method.
• Added ClickUtils getMimeType() method.
• Added support for overriding Click Application mode by defining a System property click.mode. For example: -Dclick.mode=trace
• Improved Table paging across very large lists.
• Improved Table rendering performance. [136].
• Improved OGNL form binding performance.
• Improved Click configuration defaults:
  • page automapping is enabled by default
  • global no cache headers are used if no headers defined
• Updated ClickServlet to use response Writer to support the MessAdmin session monitoring tool. This issue was identified by Sven Herschel and a patch was provided by Bob Schellink [146].
• Fixed NPE in PropertySelect when label is null. This issue was raised by David Frizelle [132].
• Fixed OgnlException in Column when evaluating null property paths. This issue was raised by David Frizelle [133].
• Fixed Ognl Null property evaluation bug when handling Date properties. This issue was raised by David Frizelle [137].
• Fixed JSP page automapping bug. This issue was identified and fixed by Bob Schellink [142].
• Fixed HibernateForm not working for CGLib proxies. This issue was identified and fixed by Caroline Briffa [144].
• Fixed CayenneForm bug where FOID was not being updated for recently committed DataObject. This issue was raised by David Frizelle [145].
• Added dependency on Dough Lea's Concurrent Utilities library version 1.3.4.
• Update Velocity 1.5-dev library to SVN revision 467179.
• Updated OGNL library to version 2.6.9.
• Updated documentation and examples. Click Quickstart has also been added as an example application.

Version 1.0 - 3rd October 2006

• Added Cheat Sheet guide. This feature was raised by Ahmed Mohombe and Ricardo Lecheta.
• Added Column maxLength property to limit the number characters displayed.
• Fixed NPE in Table ActionLink pagination. This issue was raised by Ricardo Lecheta [124].
• Fixed custom ErrorPage not resolving. This issue was raised by Glen Stampoultzis [126].
• Fixed NumberFormatException in LinkDecorator [127].
• Fixed NumberFormatException when using Form.onSubmitCheck() with a FileField. This issue was identified by Satoshi Takata [128].
• Fixed CayenneForm bug with required property set on Checkbox. This issue was identified by David Frizelle [129].
• Fixed PropertySelect bug where first item displays twice under certain conditions. This issue was identified by David Frizelle [130].
• Updated and verified Click Framework and Extras codebase against FindBugs.
• Updated Cayenne library to version 1.2.1.
• Updated documentation and examples.

Version 1.0 RC2 - 6th September 2006

• Added FlashAttribute class providing flash scope session attributes. Once a flash attribute has been accessed from the session it is removed.
• Added LinkDecorator class for rendering action links in column tables. This class was inspired by Richardo Lecheta's ViewDecorator pattern.
• Added paging support to FormTable control.
• Added Form startTag() and endTag() methods to support laying out forms manually.
• Added Form clearErrors() method.
• Added Page templating support for JSP pages. This issue was raise by Huy Do.
• Added Taiwan properties file provided by Huang.
• Added new Click Logo provided by Ahmed Mohombe.
• Improved Form client side JavaScript validation provided by Naoki Takezoe [115].
• Updated Column class to escape HTML characters by default. This issue was raised by Glen Stampoultzis [118].
• Updated HtmlStringBuffer to improve HTML character escaping performance, removing Apache Commons Lang's use.
• Updated FishEye project view provided by Cenqua.
• Updated Cayenne library to version 1.2.
• Updated Hibernate library to version 3.1.3.
• Fixed CompressionFilter to compress response by default and to automatically set any configured Click charset. These issues were raised by Ricardo Lecheta and Naoki Takezoe [119].
• Fixed NPE in DateField when setting value to null. This issue was raised by Geoff Hopson [121].
• Updated documentation and examples.

Version 1.0 RC1 - 31th July 2006

• Added FormTable data grid control and associated FieldColumn class.
• Added PageSubmit control for redirecting to target pages.
• Added Page setForward(Class) method.
• Added Quick Start topic to Click documentation.
• Modified Form isFormSubmission() method to only return true if the submission is from this form.
• Updated documentation and examples.

Version 0.21 - 19th July 2006

Final new features release for Click 1.0.

• Added Page onRender() method. This addition was raised by Stephen Haberman [105].
• Auto add public Page fields to the model. See the ClickServlet methods initPage() and createVelocityContext() for details. This addition was raised by Stephen Haberman [109, 112].
• Refactored panel package with BasicPanel renamed Panel and moved into the core control package, and removing the Panel interface. The ListPanel and TabbedPanel classes have been revised to take advantage of the new Panel capabilities.

  Panels are now rendered as $panel rather than #parse($panel)

  Panels can now define Velocity templates on the classpath as well as the web file system.

• Added PageLink control. This addition was raised by Stephen Haberman [106].
• Added OGNL support for rendering Column values.
• Added support for multiple ActionLink parameters, see setParameter() for details.
• Added Menu isUserInRoles() method.
• Added Best Practices topic to Click documentation.
• Fixed Tomcat deployment issue where Tomcat ClassLoader was locking Click JARs preventing application redeployment. Due locking on URL streams, the deployment technique has reverted back to using uniquely named files (pre 0.19). This issue was raised by Doychi [82].
• Fixed MessagesMap cache permissions issue. This issue was identified by David Felis [99].
• Fixed Field setFocus() bug. This issue was identified by David Felis [102].
• Fixed Context session Locale bug. This issue was identified by Steven Van Hoof [107].
• Fixed Select validation bug when no options are defined. This issue was identified by David Frizelle [110].
• Fixed DoubleField validation bug with "0" value. This issue was identified by David Frizelle [111].
• Moved ActionButton control from Click Extras to core controls package.
• Removed depreciated Context sessionObject methods.
• Updated documentation and examples.

Version 0.20 - 7th June 2006

• Added client side JavaScript Form Validation [16].
• Added new Click extras controls CheckList and ColorPicker. These controls were added by Christian Essel [81].
• Added support for a global page message bundle, see Page getMessage() for details. This issue raised by Claudio Rossetto [72].
• Added Control parent property [88].
• Added support table Column support for java.util.Map row objects. This issue raised by J.F. Zarama [91].
• Added option to place Table banner on top. See Table bannerPosition Javadoc for details. This issue raised by J.F. Zarama [92].
• Add configurable application Locale. See Click App for details [96].
• Added support for 'Page' suffix when automapping path -> classname. See automapping topic for details. This issue raised by Stephen Haberman.
• Added Page setRedirect(pageClass) method.
• Added Format currentDate() methods.
• Added request parameter to ClickServlet newPageInstance() method.
• Added Brazilian properties files provided by Ricardo Lecheta [86].
• Added Cayenne integration example to Examples.
• Added Spring integration example to Examples and improved SpringClickServlet documentation.
• Improved Velocity rendering performance. This issue was identified and fixed by Stephen Haberman [VELOCITY-438].
• Improved HtmlStringBuffer performance with unsynchronized append methods.
• Improved CSS link rendering to enable alternate style sheets. This issue was raised by Enrico Donelli [81].
• Fixed UnsupportedEncodingException in ClickUtils.encodeUrl() when application charset is undefined [87].
• Fixed file deployment issue on servers with restricted permissions. This issue was raised by David Felis [95].
• Removed Control parentMessages property which was effectively replaced by new parent and messages properties.
• Removed Form support for Struts style error message rendering.
• Updated Velocity 1.5-dev JAR snapshot to revision 390735, with patch VELOCITY-438 applied.
• Updated packaging: click-documentation.war replaced by documentation directory and webapps/click-examples moved to examples directory.
• Updated documentation and examples.

Version 0.19 - 8th April 2006

New developer Christian Essl joins the Click project.

• New ClickIDE Eclipse WTP plug-in released by Naoki Takezoe.
• Added new Click Extras controls ActionButton, LongField, NumberField, TabbedForm and TelephoneField.
• Added new Click Extras Cayenne controls PropertySelect, QuerySelect and TabbedCayenneForm. Also added web DataContextFilter.
• Added Context page path lookup method getPagePath(). This feature was suggested by Christian Essl [68].
• Added support for data binding of nested objects in form fields using OGNL library.
• Added Form buttonStyle, fieldStyle and labelStyle attributes to support customised form auto layouts.
• Added support for Control Velocity templates using new Context renderTemplate() methods. See Click Examples 'Rich Text Area' and 'Tabbed Form' for demonstrations.
• Added page automapping excludes. This issue was identified by Ahmed Mohombe [52].
• Added Table control mouseover row highlight. This issue was identified by Ahmed Mohombe and resolved by Christian Essl [57].
• Added French and Italian properties files provided by Lorenzo Orselli [65, 66].
• Improved SpringClickServlet configuration options and documentation.
• Improved Format class now uses request context Locale. Please note this change requires modification to Format subclass constructors. This issue was raised by Christian Essl [79].
• Updated Velocity library to latest 1.5-dev build.
• Updated Cayenne library to version 1.2B1.
• Fixed CayenneForm duplicate insert bug. This issue was identified by Bob Schellink [63].
• Fixed DateField internationalization bug. Issue identified by Lorenzo Orselli and fix provided by Naoki Takezoe [60].
• Fixed ClickUtils invokeListener on anonymous inner classes bug. This issue identified and fixed by Christian Essl [77].
• Fixed ActionLink parameter encoding bug. This issue was identified by Steven Van Hoof and fixed by Christian Essl [78].
• Removed example click-blank and click-cayenne applications from main distribution. These examples will be released as separate packages under sourceforge.
• Updated documentation and examples.

Version 0.18 - 15th January 2006

New developer Naoki Takezoe joins the Click project.

• Created new package org.apache.click.extras.control for extended HTML controls. The following controls have been moved into this package: CreditCardField, DateField, DoubleField, EmailField, IntegerField and Menu.

  Table control promoted to core org.apache.click.control.

  Added Control methods getHtmlImports() and onDeploy().

• Added PageImports object to automatically render control HTML header imports.
• Added form back button support. See Form onSubmitCheck() API for details.
• Added full JSP Click Page integration [24].
• Added RegexField provided by Naoki Takezoe [46].
• Added PropertySelect provided by Ahmed Mohombe. Please see Click Cayenne web application for a demonstration.
• Added Japanese message resources provided by Naoki Takezoe [44].
• Added German message resources provided by Christian Essl [55].
• Added click-examples Table with Form fields demonstration provided by Christian Essl.
• Improved UTF-8 charset handling provided by Naoki Takezoe [56].
• Improved Form <-> DAO auto-loading to handle primitive types. Provided by Christian Essl [53].
• Updated commons-fileupload to version 1.1 [49].
• Fixed null Column Decorator bug. This issue was identified by Geoff Hopson [40].
• Fixed Table paging bug. This issue was identified by Ahmed Mohombe [41].
• Fixed TextField constructor bug. This issue was identified by Bob Schellink [42].
• Fixed JSCalendar problem in Japanese. This fix was provided by Naoki Takezoe [43].
• Fixed Form FieldSet FileField enctype bug. This issue was identified by Christian Essl [48].
• Fixed session rewrite bug when using absolute redirects. This issue was identified by Maik Jablonski [51].
• Fixed Velocity RuntimeException handling bug [VELOCITY-424].
• Fixed Velocity 1.5-dev and Cayenne 1.2 interoperability bug [VELOCITY-426].
• Updated documentation and examples.

Version 0.17 - 5th December 2005

• Modified ClickServlet to enable direct ServletResponse handling by Pages. See Click Examples Direct Page for a demonstration.
• Modified SpringClickServlet to set Spring ApplicationContext in pages implementing ApplicationContextAware interface.
• Fixed Click 0.16 integration issues with Velocity 1.5-dev snapshot and Cayenne 1.2.
• Registered Click JARs with Ibiblio Maven Repository.

Version 0.16 - 2nd December 2005

• Improved control localization support, please see Field Javadoc and FAQ for details.

  This feature based on a concept developed by Ahmed Mohombe, and replaces the "msg:" prefix localization functionality introduced in release 0.13.

• Added Hibernate data aware Form control HibernateForm, and supporting SessionContext and SessionFilter classes.
• Added Menu pages property for selecting menu items. This feature was provided by Geoff Hopson [39].

  Refactored Menu to implement Control interface to improve Page subclassing.

• Improved Form rendering flexibility with new properties labelRequiredPrefix and labelRequiredSuffix.
• Added Select setMultipleValues() method. This issue was identified by Geoff Hopson [34].
• Added Context createPage() method enabling you to specify the target page by class.
• Added custom rich text area control demonstration in Click Examples Email Form page.
• Fixed Column null value handling bug. This issue was identified by Geoff Hopson [32].
• Fixed ActionLink value escaping bug. This issue was identified by Geoff Hopson [33].
• Fixed DateField I18N issue and improved rendering. These issues were identified by Antoni Aloy and Ahmed Mohombe [36, 27].
• Modified Format getEmptyString() to return "" strings to better support AJAX rendering. This issue was identified by Andrus Adamchik.
• Updated documentation and examples.

Version 0.15 - 25th October 2005

• Fixed escaping quote characters in controls. This issue was identified by Mike Organek [31].
  Added new HtmlStringBuffer class for control rendering.
• Added click-cayenne example web application. This application was contributed by Andrus Adamchik.
• Refactored Form align and position constants to remove ambiguity.
• Fixed ClickApp NPE when initializing [30], related Velocity Engine patches applied [412].
• Refactored Ant build system.
• Updated documentation and examples.

Version 0.14 - 17th October 2005

New developer Ahmed Mohombe joins the Click project.

• Fixed FieldSet Form processing bug. The bug was identified by by Paul Rule [25].
• Removed JDOM dependency.
• Velocity Engine error reporting patches applied [373].
• Modified Ant build script to download JAR dependencies from Ibiblio Maven repository.

Version 0.13 - 13th October 2005

• Added Spring integration servlet SpringClickServlet.
• Added Cayenne data aware Form control CayenneForm.
• Improved JSP support. See FAQ for details and Click Examples for a demonstration.
• Improved Field localization support, see FAQ for details. Based on a concept by Iain Shigeoka.
• Fixed FieldSet Form <-> DAO auto-loading bug. The fix was provided by Paul Rule [23].
• Fixed WebSphere's bundled JDOM 0.7 compatibility issue. This issue was identified by Oliver Burn [25].
• Updated Jakarta Commons JARs to latest versions to support Hibernate [19].
• Removed Commons Logging dependency in Click Extras to avoid WebSphere class loading issues [20].
• Updated Velocity 1.5 dev build to use recent snapshot [21].
• Fixed NPE bug in ErrorReport. This fix was provided by Steve Cowx.
• Updated documentation and examples.

Version 0.12 - 1st October 2005

• Added FieldSet control. See Javadoc for details and Click Examples for a demonstration [CLK-4].
• Add Field "name" and "label" constructors added to make Form <-> DAO auto-loading easier to use.
• Changed controls to render valid XHTML, instead of HTML 4.01, enabling Firefox and Mac OS X browsers to render AJAX responses containing Control HTML [CLK-3].
  For example the TextField HTML   <input type='text' disabled>   now renders as
  <input type='text' disabled='disabled'/>
• Fixed bug where multipart form parameters not available during Page.onInit() [CLK-1].
• Updated documentation and examples.

Version 0.11 - 16th September 2005

• Added Menu component. See Javadoc for details and Click Examples for a demonstration [CLK-12].
• Added runtime Page Auto Loading when the application is in "development", "debug" or "trace" mode [CLK-18].
• Added Form <-> DAO auto-loading feature. See Form Javadoc for details [CLK-2].
• Fixed blank page gzip compression bug. The Click embedded gzip compression functionality has been replaced with a CompressionFilter derived from Jarkata Tomcat [CLK-5].
• Added email() and link() formatter methods and getEmptyString() method to Format class [CLK-15].
• Modified Form control to render a class error attribute <label class="error"> in the labels of invalid fields. You can now override the control.css style label.error to modify the display of field error labels.
• Modified Form constructor to only require form name parameter. The context can be set later. Note this will require modifications to exiting code.
• Updated documentation and examples.

Version 0.10 - 1st September 2005

New developer Phil Barnes joins the Click project.

• Added Panel components by Phil Barnes. See Javadoc for details and Click Examples for a demonstration.
• Added Table control. See Javadoc for details and Click Examples for a demonstration [1243243].
• Added ImageSubmit control by Phil Barnes. See Javadoc for details and Click Examples for a demonstration.
• Localization/I18N changes include:
  Added Chinese localization properties (zh_CN) provided by Xi Ping Wang.
  Added Page MessagesMap adaptor to Velocity Context.

  Added new getLocale() and setLocale() methods to Context class to enable overriding the default request Locale.
• New Click Extras module and JAR provided for contributions and non-core framework components.
• New Rico inspired AJAX Live Grid example provided by Phil Barnes.
• Click Examples, Confluence WIKI and JIRA applications are now available online.
  Special thanks to Phil Barns for hosting these applications.
• Updated documentation and examples.

Version 0.9 - 7th August 2005

• Added application reloading feature to reload "click.xml" without restarting the web application. See ClickServlet Javadoc for details and the Click Examples for a demonstration [1237942].
  This concept was defined by Hans Baecker-Mayer.
• Updated documentation and examples.

Version 0.8 - 2nd August 2005

• Added LogService which logs to the console by default. See the Click and Velocity Logging topic.
• Updated documentation and examples.

Version 0.7 - 28th July 2005

• Added FileField control for uploading files and modified Form control to support "multipart/form-data" requests. See the Click Examples File Upload page for a demonstration [1237942].
• Added pages Auto Mapping configuration option. This feature can automatically map HTML page templates to Page classes so you don't have to declare them manually in the click.xml configuration file.
  This concept was defined by Ahmed Mohombe.
• Added Page Forwarding enabling you to configure the Page to forward the request to. This provides similar functionality as Tapestry's cycle.getPage() interpage calling technique. See the Examples Page Flow for a demonstration.
• Added ClickServlet newPageInstance() method to support IoC applications. See the Spring Integration FAQ topic for more details.
  This concept was defined by Phil Barnes.
• Form rendering improved to include CSS classes "fields", "errors" and "buttons" in the respective table <tr> and <td> elements. This enables greater control of Form display using CSS styles.
• Added "trace" application mode to provide more detailed logging. See the Configuration Mode topic.
• Added limitLength() methods to the Format class.
• Improved Submit controls processing of HTML characters.
• Updated documentation and examples.

Version 0.6 - 2nd July 2005

• Added AJAX Dynamic HTML and XML request example using the using Rico Ajax library. See the Click Examples AJAX page for a demonstration.
• Option and OptionGroup refactored into standalone classes.
• Added Page setHeader() method.
• Fixed NPE when Fields, with no parent Form, are processed and rendered.
• Added FAQ, and updated documentation and examples.

Version 0.5 - 1st June 2005

• Form control encodes the form "action" URL attribute using encodeURL(String) to ensure session ID is set.
• Added optional Form validation. A validate property has beed added to Form and a validate() method to Field. Field subclasses have been modified to support optional validation. See the Click Examples Form Properties page for a demonstration.
• Added Session Object utility methods to Context, see getSessionObject.
• Added error message block horizontal alignment property errorsAlign to Form.
• Updated documentation and examples.

Version 0.4 - May 2005

• Implemented Page Templating capability. Enabling you to create a standardized look and feel for your web application and greatly reducing the amount of HTML you need to maintain.
• Improved Error handling. Application exceptions render error source line when Java source available. For example a NullPointerException.
• Integrated the DHTML Calendar widget by Dyna.com into DateField control.
• Added Form and Field readonly property. Modified Field subclasses to render their HTML readonly attribute. If the Form is set to readonly all its fields will also be readonly.
• Added Control getId() method. Modified control classes to render their HTML id attribute.
• Added Form columns property to render forms in multi column table layout.
• Added page path property to Velocity context.
• Fixed SourceViewer missing resource bug which occurred on Orion server.
• Updated documentation and examples.

Version 0.3 - March 2005

Preliminary release for public review.

Version 0.2 - 2004

Major rewrite, replacing command pattern with Page oriented design. Click application descriptor rationalized and simplified.

Version 0.1 - 2003

Initial Click version. Uses Command pattern and Velocity templating engine.

Click team blogging application deployed on Tomcat 4.0 and Oracle 9i application servers.