Liferay Faces Bridge
You can use Liferay Faces Bridge to deploy JSF web apps as portlets without writing portlet-specific code. It also includes features that support JSF 2.x inside a portlet application.
Liferay Faces Bridge is distributed in a .jar file. You can add Liferay Faces Bridge as a dependency to your portlet projects to deploy your JSF web applications as portlets within JSR 286 (Portlet 2.0) and JSR 362 (Portlet 3.0) compliant portlet containers.
The Liferay Faces Bridge source is available on GitHub.
To fully understand Liferay Faces Bridge, you must first understand the portlet bridge standard. Because the Portlet 1.0 and JSF 1.0 specs were being created at essentially the same time, the Expert Group (EG) for the JSF specification constructed the JSF framework to be compliant with portlets. For example, the ExternalContext.getRequest() method returns an Object instead of an javax.servlet.http.HttpServletRequest. When this method is used in a portal, the Object can be cast to a javax.portlet.PortletRequest. Despite the EG’s consciousness of portlet compatibility within the design of JSF, the gap between the portlet and JSF lifecycles had to be bridged.
Starting in 2004, several different JSF portlet bridge implementations were developed in order to provide JSF developers with the ability to deploy their JSF web apps as portlets. In 2006, the JCP formed the Portlet Bridge 1.0 (JSR 301) EG in order to define a standard bridge API, as well as detailed requirements for bridge implementations. JSR 301 was released in 2010, targeting Portlet 1.0 and JSF
When the Portlet 2.0 (JSR 286) standard was released in 2008, it became necessary for the JCP to form the Portlet Bridge 2.0 (JSR 329) EG. JSR
- was also released in 2010, targeting Portlet 2.0 and JSF 1.2.
After the JSR 314 EG released JSF 2.0 in 2009 and JSF 2.1 in 2010, it became evident that a Portlet Bridge 3.0 standard would be beneficial. In 2015 the JCP formed JSR 378, which defined a bridge for Portlet 3.0 and JSF 2.2. There are also variants of Liferay Faces Bridge that support Portlet 2.0 and JSF 1.2/2.1/2.2.
A JSF portlet bridge aligns the correct phases of the JSF lifecycle with each phase of the portlet lifecycle. For instance, if a browser sends an HTTP GET request to a portal page with a JSF portlet in it, the RENDER_PHASE is performed in the portlet’s lifecycle. The JSF portlet bridge then initiates the RESTORE_VIEW and RENDER_RESPONSE phases in the JSF lifecycle. Likewise, when an HTTP POST is executed on a portlet and the portlet enters the ACTION_PHASE, then the full JSF lifecycle is initiated by the bridge.
Besides ensuring that the two lifecycles connect correctly, the JSF portlet bridge also acts as a mediator between the portal URL generator and JSF navigation rules. JSF portlet bridges ensure that URLs created by the portal comply with JSF navigation rules, so that a JSF portlet is able to switch to different views.
The JSR 329/378 standards define several configuration options prefixed with the javax.portlet.faces namespace. Liferay Faces Bridge defines additional implementation-specific options prefixed with the com.liferay.faces.bridge namespace.
Liferay Faces Bridge is an essential part of the JSF development process for Liferay DXP.