ClickIDE 2.1.0 released: support Click 1.5

A new version of ClickIDE is available. This release supports Click 1.5 and Eclipse 3.4/WTP 3.0.

Important links:

• ClickIDE Home
• Download ClickIDE 2.1.0
  

Enjoy Click!

Click 1.5 final is released!

Click 1.5 is production ready and available for download.

This is our biggest release yet with numerous new features, enhancements, documentation and examples.

We would like to thank everyone for their contributions to the 1.5 release.

Important links:

• Click Home
• Roadmap and Changes
• Upgrade Path - please see the upgrade path when upgrading from a previous release.
• Download Click 1.5
• Maven bundles
  
• Live examples

Highlights for 1.5 include:

• Container - new interface for building arbitrary complex, hierarchical Controls.
• ActionListener - new interface provides compile time safety and support for code refactoring tools.
• Performance have been enhanced by rendering markup from a single buffer. In previous releases each Control managed its own internal String buffer. Our tests indicate performance gains of up to 40%.
  
• Services - Click core has been refactored into pluggable services.
• Added Freemarker support as an alternative templating engine to Velocity. See FreemarkerTemplateService for configuration details.
• Provide three logging service implementations: ConsoleLogService, JdkLogService and Log4JLogService
  
• Mock Test Support - introduces an easy to use package to write Unit and Functional Tests.
• ControlRegistry - enables two phase listener dispatch, which allows Controls to bind request parameters before listeners are fired.
• A new deployment strategy allows deployment of resources directly from jars.
• New Renderable interface allows alternative paginator implementations for Table. Two implementations are available with Click 1.5: TablePaginator and TableInlinePaginator.
• A new Powered by Click section was added. If you would like to add your own site to this list, please drop us a mail at one of our Mailing Lists, or directly to "sabob1gmailcom".

New documentation:

• Container explains the new Container concept
  
• Template vs Programmatic layout explains different layout strategies
  
• Mock Test Support provides overview of the new testing support in 1.5
  
• Deploying custom resources describes how to deploy resources such as JavaScript, CSS and images
  
• Multiple pages packages allows you to host or integrate pages from separate packages
  

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.
• Table paginators shows the different paginators available
  
• Country Select field allows users to pick from a list of countries
  
• Custom Form Layout using Containers shows how to use a Container for laying out forms
  
• Virtual Keyboard provides a graphical Vitural Keyboard text field control

Issues resolved since 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].

Enjoy Click!

The Click team.

Click 1.5 RC 3 is here!

This marks the third (and final) release candidate as Click is rapidly progressing towards a stable 1.5.

We urge everyone to try out RC3 and provide feedback via our mailing lists and issue tracker.

• Click Home
• Roadmap and Changes
• Upgrade Path - please see the upgrade path when upgrading from 1.4 or earlier.
• Download Click 1.5
• Maven bundles
  
• Live examples

New examples for this release:

• 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.

Issues resolved for RC3:

• 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].

Enjoy Click.

The Click team.

Click 1.5 Release Candidate 2 is available!

RC1 introduced a severe bug which hampered Click from deploying properly. To resolve this issue we are making RC2 immediately available.

We apologize for the inconvenience.

Please try out RC2 and provide feedback via our mailing lists or issue tracker.

• Click Home
• Roadmap and Changes
• Upgrade Path - please see the upgrade path when upgrading from 1.4 or earlier.
• Download Click 1.5 RC2
• Maven bundles
  
• Live examples

Issues resolved for RC2:

• Emergency Fix: Click throws FileNotFoundException when deploying click-extras.jar [448].
• Added new method Page.removeControl which enables Click to 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.

The Click team.

Click 1.5 Release Candidate 1 is now available!

This should be the last release before 1.5 final. We have received good feedback and a large number of issues have been resolved. Thanks to everybody for their contributions in making this release possible.

We urge everybody to try out RC1 and provide feedback via our mailing lists and issue tracker.

Apache Incubation Status:

As you might know already Click was voted to undergo incubation at Apache Incubator. One of our tasks is to migrate current infrastructure to the new hosting. New mailing lists have been setup for users and developers. Information on subscribing to the new mailing lists can be found here. If you would like to unsubscribe from the existing SourceForge lists follow the instructions here.

• Click Home
• Roadmap and Changes
• Upgrade Path - please see the upgrade path when upgrading from 1.4 or earlier.
• Download Click1.5
• Maven bundles
  
• Live examples

Highlights for this release:

• Refactored Paginator into a more generic interface called Renderable which is independent of any specific Control
• Added Table Row attribute support through new method addRowAttributes.
• Field error messages can now be specified per instance. See the JavaDoc for more details.

Issues resolved for RC1:

• 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].

Enjoy Click.

The Click team.

Click 1.5 M3 is now available!

Milestone 3 is the final milestone in the 1.5 series and provides much improved backward compatibility.

• Click Home
• Roadmap and Changes
• Upgrade Path - please see the upgrade path when upgrading from 1.4 or earlier.
• Download Click1.5
• Maven bundles
  
• Live examples

Highlights for this release:

• New features include a pluggable Paginator for Table and two implementations: DefaultPaginator and InlinePaginator.
• Major refactoring to improve backward compatibility and upgrade path. This includes removing BasicForm and adding new Controls HtmlForm and HtmlFieldSet.
• Added support for multiple page package definitions in click.xml configuration

New documentation:

• Multiple pages packages

New examples:

• Table paginators
  

Issues resolved:

• 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].

Enjoy Click.

The Click team.

Click 1.5 M2 now available!

Click 1.5 Milestone 2 is available for download. This is the second installment in the 1.5 development branch and provides important new features and bug fixes.

• Click Home
• Roadmap and Changes
• Upgrade Path - please see the upgrade path when upgrading from 1.4 or earlier.
• Download Click1.5
• Maven bundles
  
• Live examples

Highlights for this release:

• ActionListener - new interface provides compile time safety and support for code refactoring tools.
• ControlRegistry - enables two phase listener dispatch, which allows Controls to bind request parameters before listeners are fired.
  
• Introduced a new resource deployment strategy for Jars containing Page and Control resources.
  

New documentation:

• Deploying custom resources
  

Issues resolved:

• Added a new PageButton control [392].
• 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 Romanian property files. This issue was raised and fixed by Marius Petrus [361].
• Add width support to TabbedPanel control [376].
• Add ClickUtils autoPostRedirect() method to support SAML integration [398].
• Renamed Container.add(int, Control) to Container.insert(Control, int) [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 to only be cached in production or profile modes. [408].
• Moved AbstractContainerField control to Click Extras. [410].
• Fixed TabbedPanel bug whereby inactive panel HTML imports are included in page [366].
• 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 bug where Format is not available in template of stateful pages. [409].

Enjoy Click.

The Click team.

Click 1.5 Milestone 1 released!

Click 1.5 Milestone 1 has been released yesterday. This is the first installment in the 1.5 development branch and provides a host of new features. Important links:

• Click Home
• Roadmap and Changes
• Upgrade Path - please see the upgrade path when upgrading from a previous release.
• Download Click1.5
• Maven bundles
  
• Live examples

Highlights for 1.5-M1 include:

• Container - new interface for building arbitrary complex, hierarchical Controls.
• Services - Click core has been refactored into pluggable services.
• Added Freemarker support as an alternative templating engine to Velocity. See FreemarkerTemplateService for configuration details.
  
• Mock Test Support - introduces an easy to use package to write Unit and Functional Tests.
• A new Powered by Click section was added. If you would like to add your own site to this list, please send us a mail to one of our Mailing Lists, or directly to "sabob1 at gmail.com".
• More examples and documentation.

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

Issues resolved:

• Improved performance by rendering from a single non-blocking buffer.
  
• 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 programatically 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 Cayenne 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].

Enjoy.

The Click team.

Click 1.4.2 maintenance release is available!

Click 1.4.2 is a minor maintenance release.

• Download Click1.4.2
• Click Home
  
• Live Examples
• Maven Bundles
  

This release fixes a problem when using SpringClickServlet and excluded urls. We have also fixed a slight performance degradation since the 1.4 release.

Changes include:

• Fix a slight performance degradation over the 1.4 release [349].
• Fixed ExcludePage - should be a public inner class [346].
• Fixed Maven artifact packaging [348].
  
• Fixed PageLink to work with JSP pages [352].
• Fix DateField and ChartFields to include control.js [354].
• Fix DateField which could produce duplicate stylesheet head includes [356].

Enjoy.

The Click team.

Click supports functional and unit testing!

One of the first features completed for the upcoming 1.5 release, was to revamp the mock package and add functional and unit testing support. There is no need to extend any classes or override methods. Testing works out of the box.

For testing purposes there are two classes of interest: MockContainer and MockContext.
(Since 1.5 has not yet publicly available I will just refer to the actual source code)

Which class to use depends on what you want to test.

If you want to test your pages (functional tests) use the MockContainer which simulates a servlet container such as Tomcat or Jetty. With the container one will be enable to mock page requests, form submissions, file uploads, navigation etc.

In order to use MockContainer you need to specify a web directory where the container can find resources such as javascript, stylesheets and images. The easiest way to achieve this is to point the container to your project's web directory.

Example usage:

public class IntegrationTest extends TestCase {
    public void testFirstPage() {
        // Specify the project web directory for example: 'c:/dev/web'
        MockContainer container = new MockContainer("c:/dev/web");

        // Bootstrap the container
        container.start();

        // Set a request parameter
        container.setParameter("myparam", "Some parameter");

        // Simulate a user requesting the page, FirstPage. FirstPage will forward to SecondPage.
        FirstPage page = (FirstPage) container.testPage(FirstPage.class);

        // Assert that FirstPage does indeed forward to SecondPage
        Assert.assertTrue(container.getForwardPageClass(), SecondPage.class);

        container.stop();
    }
}

MockContext on the other hand is useful for testing custom controls (components).

Note that it is not necessary to specify a web directory when using MockContext.

Example usage:

public class ValidationFieldTest extends TestCase {

    public void testValidationField() {

        // Initialize the context.
        MockContext context = MockContext.initContext();

        int maxLength = 10;
        String fieldName = "name";
        ValidationField field = new ValidationField(fieldName, maxLength);

        // Retrieve the request and set field request parameter.
        MockRequest request = context.getMockRequest();
        request.setParameter(fieldName, "value");

        // onProcess binds the request attribute and field value
        assertTrue(textField.onProcess());

        // Assert that the field is still valid.
        assertTrue(textField.isValid());
    }
}

That is all there is to it.

The API is still evolving and feedback is appreciated. Our mailing lists are available here:

Click 1.4.1 is available!

Click web framework version 1.4.1 is now available. First up the links:

• Download Click1.4.1
• Click Home
  
• Live Examples
  

This release fixes a number of important JSP and Ajax related bugs.

Changes include:

• Added new method Context.isAjaxRequest() which enables conditional checking for Ajax requests.
• Improved alphanumeric column sorting. This issue was raised by Ben Young. [344]
• Upgradeded to Scriptaculous 1.8.1 to fix auto form submit. This issue was raised by Andy Key. [336]
• 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].

For those interested in the latest development release (1.5M1) can view the roadmap below:

• 1.5M1 roadmap
  

Enjoy.

The Click team.

ClickIDE 2.0.0 released: now with Cayenne and Spring support

Naoki Takezoe has released the latest version of ClickIDE. This release supports Click Framework 1.4 and Eclipse 3.3/WTP 2.0.
Important links:

• ClickIDE Home
• Download ClickIDE 2.0.0
  

There have been a couple of important new features:

New Features:

• Generates Click project with Cayenne and Spring support.
  
• Added new Cayenne mapping project creation wizard.
  
• Added Cayenne Modeler launcher.
  
• Wizard generates an empty cayenne.xml and launches it with Cayenne Modeler.
  
• Added classpath variables "CAYENNE_LIB" and "CAYENNE_NODEPS_LIB". You can add cayenne.jar or cayenne-nodeps.jar to your project classpath using these variables from the project build path settings.
  
• Additional Velocity variables configuration for code completion in the project property page.
  

Enjoy Click!

Click 1.4 final released!

Click 1.4 has been released yesterday. A big thanks goes to all users and developers for their contributions in making this release possible. Important links:

• Download Click1.4
• Click Home
  
• Live examples

Click is a simple and intuitive page and component oriented Java web framework. There are no unnecessary abstractions or complex concepts to learn and understand. Pages and components are developed in Java while layouts are specified in Velocity or JSP. You don't have to repeat component hierarchies in your view as each component knows how to render itself.

Highlights for 1.4 includes:

• Stateful page support which really make developing complex pages and page flows much easier.
• New PerformanceFilter which gives your applications Yahoo style performance for very little effort.
• New AutoCompleteTextField control which gives you Ajax google suggest functionality.
  
• New Ant task to build quickly build application templates or scaffolding.
• Added support for Cayenne versions 2.x and 3.x.
• ThreadLocal Context support which giving you access to the Context in page constructors.
• New Control event methods, onInit(), onRender() and onDestroy().
• Lots more code examples and design patterns on click-examples.
• Performance improvements.
  

Since RC3 there have been a couple of important bug fixes:

Fixes:

• 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 [323].
  

Enjoy.

The Click team.

Click 1.4.-RC3 released: now with stateful page support

Click1.4-RC3 has been released today. Below are the related links:

• Download Click1.4-RC3
• Click Home
  
• Live examples
  

Click is a page and component oriented Java web framework. Pages are mostly developed in Java, while rendering is performed by Velocity or JSP.
A lot of thought went into making Click as simple as possible and developers should be up and running within a day.

Since RC2 there have been a number of new features and important bug fixes.

Improvements:

1. Pages can now be stateful:

public class MyPage extends Page {

public Form form = new Form("myForm");

public MyPage() {
setStateful(true); // Page will be persisted between requests.
form.add(new TextField("search-term");
form.add(new Submit("submit"));
}
...
}

More documentation on stateful pages can be found here.

2. Added a PerformanceFilter to significantly improve the performance of Click applications. The filter is based on Yahoo's 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 Firefox plugin: YSlow.

Also in this release:

• Added new AJAX AutoCompleteTextField which provides Google suggest style lookups.
• Added new Table CSS class styles: blue1, blue2, orange1, orange2
• Fixed Form.copyFrom() to align with special Map handling of Form.copyTo(). [278].
• Fixed Form submit check to handle multiple forms per page. [279].
• 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. [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].

For a complete list of changes visit the roadmap and changes.

Enjoy.

The Click team.