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.