Configuring Portlet Bridge for JavaServer Faces

Configure IBM Portlet Bridge for JavaServer Faces (JSF).

Before you begin

About this task

Note: 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. [9.0.0.2 or later]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. [9.0.0.2 or later]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 JSF Portlet Bridge.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: March 5, 2017 17:29
File name: tweb_portletbridge.html