Announcement: Liferay Faces 4.x M1 Released

On March 1, 2014 Liferay released the 1st Milestone of Liferay Faces 4.x:

Liferay Faces 4.2.0-m1 JSF 2.2 + Liferay Portal 6.2 *NEW* Release Notes
Liferay Faces 4.1.0-m1 JSF 2.1 + Liferay Portal 6.1 *NEW* Release Notes

Download Instructions

Since the 4.2.0-m1 and 4.1.0-m1 releases are not General Availability (GA), the JAR artifacts are *not* published at Maven Central. Instead, they are published at the new Liferay Previews Nexus Repository along with the demo portlets.

Maven Project Dependencies


Ivy Project Dependencies

  <dependency org="com.liferay.faces" name="liferay-faces-alloy" rev="4.2.0-m1" />
  <dependency org="com.liferay.faces" name="liferay-faces-bridge-impl" rev="4.2.0-m1" />
  <dependency org="com.liferay.faces" name="liferay-faces-portal" rev="4.2.0-m1" />
  <ibiblio m2compatible="true" name="liferay-previews"
    root="" />

Version Scheme

Please refer to the Liferay Faces Version Scheme wiki article for a detailed explanation of the version numbering.


This 4.x M1 release is based off the stable codebase of the 3.x GA5 release. The main difference is support for JSF 2.2 and new demo portlets (see below). This M1 (Milestone) release is suitable for development purposes, however 4.x will not be supported under the Liferay EE subscription until it reaches GA (General Availability) status.

Support For JSF 2.2

  • This is the first release of Liferay Faces that is compatible with JSF 2.2

  • If deploying portlets to Liferay Portal 6.2, then developers should read the new Migrating From Liferay Faces 3.1 to Liferay Faces 3.2/4.2 section in the Developer's Guide. Specifically, JSF portlets require the following option in the WEB-INF/liferay-portlet.xml descriptor: <requires-namespaced-parameters>false</requires-namespaced-parameters>

Tomcat 7 Only

Developed under JSR 344, JSF 2.2 is part of the larger Java EE 7 specification from the JCP. Even though Java EE 7 includes technologies like CDI 1.1 and Servlet 3.1, JSF 2.2 only depends on Java EE 6 technologies like CDI 1.0 and Servlet 3.0. This means that JSF 2.2 webapps and portlets can be deployed in Java EE 6 (Servlet 3.0) servlet containers such as Tomcat 7. However, Java EE 6 full-profile application servers such as GlassFish 3.2, JBoss 7.1, and WebLogic 12c bundle JSF 2.1 and cannot be upgraded to JSF 2.2. At the time of this writing, Liferay, Inc. has not released any Liferay Portal 6.1/6.2 bundles with Java EE 7 servers such as Tomcat 8, GlassFish 4.0 or JBoss/WildFly 8. Therefore this milestone has only been tested for compatibility with Liferay Portal 6.1/6.2 on Tomcat 7.

JSF 2.2 Component Suites

Portlets can be developed with JSF 2.2 component suites including Liferay Faces Alloy and PrimeFaces 4.0. Future milestones will include planned support for ICEfaces 4.0 and RichFaces 5.0 portlets.

JSF 2.2 Feature Demos

In order to test JSF 2.2, we developed the following new demo portlets:


The Liferay Faces team is hard at work developing JSF components and a Showcase for AlloyUI 2.0. Stay tuned!

Feedback Requested

If you find any problems with this release, please post a message in the Liferay Faces forums.

Write a blog post too!

Write a deep dive into how you use Liferay projects in your technology stack. Or let people know useful tips and tricks for a particular functionality. The Liferay community needs you!

Login or Create an account