Configuring Portlet Bridge for JavaServer Faces

Configure IBM Portlet Bridge for JavaServer Faces (JSF).

[9.0.5.2 or later]Removed feature: IBM Portlet Bridge for JavaServer Faces (JSF) 2.0 only applies to WebSphere® Application Server prior to Version 9.0.5.2.

Before you begin

  • For WebSphere Application Server Version 9.0 users, the JSF Portlet Bridge does not function when you use the default JavaServer Faces implementation, JSF 2.2.
  • The following procedure does not apply to Version 9.0 users without a fix pack.

Procedure

  1. Open the portlet.xml file and modify the portlet class for JSF Portlet Bridge. 
    <portlet-class>com.ibm.faces20.portlet.FacesPortlet</portlet-class>
		<init-param>
				<name>com.ibm.faces.portlet.page.view</name>
				<value>/TestProjectView.xhtml</value>
		<init-param>
    1. Open the portlet.xml file and modify the portlet class for JSF 2.2 Portlet Bridge. 
      <portlet-class>com.ibm.faces20.portlet.FacesPortlet</portlet-class>
		<init-param>
				<name>com.ibm.faces.portlet.page.view</name>
				<value>/TestProjectView.xhtml</value>
		<init-param>
  2. Open the faces-config.xml file and add the JSF portlet bridge variable resolver, view handler, and resource handler entry. 
    <application>
		<el-resolver>com.ibm.faces20.portlet.PortletELResolver</el-resolver>
		<view-handler>com.ibm.faces20.portlet.FaceletPortletViewHandler</view-handler>
		<resource-handler>com.ibm.faces20.portlet.httpbridge.PortletResourceHandler</resource-handler>
</application>
    1. Add the JSF 2.2 portlet bridge variable resolver, view handler, and resource handler entry. 
      <application>
             <el-resolver>com.ibm.faces20.portlet.PortletELResolver</el-resolver>
		<view-handler>com.ibm.faces20.portlet.FaceletPortletViewHandler</view-handler>
		<resource-handler>com.ibm.faces20.portlet.httpbridge.PortletResourceHandler</resource-handler>
</application>
  3. Register the listener in the web.xml file. 
    <listener>
		<listener-class>com.ibm.faces20.portlet.httpbridge.PortletRequestAttributesListener
		</listener-class>
</listener>

What to do next

If the portlet project has a custom portlet class, these changes are also necessary:
  • Point the portlet-class entry in the portlet.xml file to the particular custom portlet class used.
  • Modify the portlet class to extend the com.ibm.faces20.portlet.FacesPortlet class from the IBM Portlet Bridge for JavaServer Faces (JSF) 2.0.