Brian Leathem

6 minute read


The first milestone release of RichFaces 4.3 (4.3.0.M1) is now available. This is a significant release, with primary focus on improving the RichFaces Component Development Kit (CDK) - the tool we use to author our JSF components. A second goal of the release was to improve our “MyFaces”: support, which we accomplished by fixing a number of issues, and identifying some further issues to be addressed in a subsequent 4.3 milestone release.

div(alert alert-info). To try out this release: You can download the distribution “directly”:, or for maven users, increment the RichFaces version in your pom.xml to For more information on setting up a RichFaces 4 application, refer to our getting started guide.

h2. CDK Improvements

RichFaces Component Development Kit (“CDK”: is a heavy-lifter in the RichFaces Framework. The CDK is the tool we use to author our JSF components. Improvements we make to the CDK improve our ability to deliver components, and will reduce our “turnaround”: on delivering new features for developing web applications.

RichFaces developer “Paul Dijou”: has written up a “great summary”: of the recent CDK improvements. For further details on what has changed, you can refer to the list of individual “issues addressed”: While the bulk of CDK changes have landed in M1, we will undoubtedly introduce further improvements throughout the rest of the 4.3 release cycle as we push the boundaries on what’s possible with the CDK in our “RichFaces Bootstrap”: sandbox project.

h2. “Real” Tests

Testing of our components and framework has always been a primary concern of the RichFaces project. All our releases to date have been tested not only with unit tests, but also with a large battery of significant number of “functional tests”: However, functional tests treat the JSF servlet as a black box - we know what we put it and we can test what comes out. On the other hand, unit tests mock the environment where our implementation runs, hiding any issues that would occur only in a real environment. If you think about it, these tests operate in a blind-folded manner: what’s happening as the container executes our application logic?

To this end, the RichFaces project has co-ordinated with the “Arquillian”: project in the development of a new extension: ““Arquillian Warp”:". With Warp, we can write tests that assert state simultaneously on both the client and the server. For JSF, this means our tests can assert state at arbitrary points throughout the JSF lifecycle. As you can imagine, this opens up a whole new category of tests we can write, as we can not only assert that our application logic has the desired effect, but also that it executes as we expect.

Warp reuses outstanding Arquillian integration with various containers, which allows us to test the integration of RichFaces with many application servers and servlet containers. Furthermore, Warp leverages the “Arquillian Drone”: extension for running Selenium-based tests. Arquillian’s flexibility together with Drone’s ability to drive both real and mocked browsers (ie. HtmlUnit), allows us to run tests using minimal resources in continuous integration, and we can run those same tests in “real” environments to verify integration with many real containers.

Our integration tests makes heavy use of “ShrinkWrap”: to create micro-deployments allowing us to separate the project into small testable pieces. ShrinkWrap Resolvers provides support for resolving various modules from our multi-module project, while ShrinkWrap Descriptors allows us to programatically describe configuration files (like faces-config.xml and web.xml), property files, and Facelet files - which enable us to write tests once and run them in many different configurations.

So far we’ve used this new capability within the framework to harden our RichFaces Push and Resource Mapping implementation, and we will continue to develop new cross-container integration tests of our components and frameworks to complement our already impressive test suite.

h2. Issue highlights

This milestone release addresses a number of bugs as well as new features. For a full list of issues addressed, be sure to check out the “Release Notes”: However, there are a couple of issues I would like to call out in this blog.

The “rich:jQuery“: function in EL to call a jQuery object from a JSF id as in: #{rich:jquery(‘your-id’]}

This is a convenience method introduced as a short-hand for the current: $(‘##{rich:clientId(‘your-id’)}‘)

The RichFaces “a4j:push“: feature now has a “max inactive timeout”:, that specifies the maximum amount of time a session is allowed to be inactive. This is an experimental feature, put in place as a workaround while we resolve the underlying issue “RF-12219”: Try it out, let us know what you think!

h2. Component Upgrades

The RichFaces project is very much an open source project, and leverages other open source projects wherever possible. In this milestone release, we updated the version dependency of some of our upstream projects. These include:

h2. MyFaces Issues

With this release, we’ve also turned our attention to a number of “MyFaces”: issues that we hadn’t addressed with our recent releases. In order to co-ordinate with the “JBoss EAP 6”: release, we focused predominantly on “Mojarra”: compatibility. However RichFaces is a container agnostic project, and we’re making a concerted effort to improve our MyFaces compatibility with our 4.3 release.

This effort is being facilitated both by the “Arquillian Warp”: project mentioned above, as well as by the “TomEE”: project. TomEE gives us an excellent pre-bundled/pre-configured Tomcat and MyFaces environment against which we can both develop and debug our components - without requiring us to assemble the required jars, and “roll our own appserver”.

As with our CDK improvements, fixing MyFaces issues will continue throughout the 4.3 release. M1 is just a first step in this direction.

h2. What’s Next?

In a recent RichFaces “community meeting”:, we set some goals for the M2 release of RichFaces 4.3. These goals include:

Also, be sure to follow the “RichFaces Bootstrap”: project:

div(alert alert-success). In the “RichFaces Bootstrap”: Sandbox project, we are developing our next-generation component set based on top of the “Twitter bootstrap”: project. RichFaces developer Paul Dijou has an excellent write-up on the “latest bootstrap updates”: Also, check out “JSF+LESS blog”: by RichFaces developer “Lukas Fryc”:, showcasing the real-time CSS/LESS development going on in our Bootstrap project - JSF component styling at it’s best!