Skip to end of metadata
Go to start of metadata

Public Render Parameters (or PRPs) are one of the most powerful and simple Portlet 2.0 features. Several portlets (JSF or not) can share the same render parameters. This feature can be use to present a cohesive UI to the user across all portlets on the page (i.e. using an employee ID to display relative data).

Public Render Parameters can only be used to set/retrieve a String value, and not an object as Events can.

Portlet Configuration

The portlet that sets the Public Render Parameter, and also the one receiving it, need the following defined within their portlet.xml:

The portlet that will be retrieving the Public Render Parameter also needs to define a handler in the portlet.xml as below:

Set Parameter

Setting the Public Render Parameter only needs a Bean method, most likely called as part of an Action from the UI, that sets the render parameter onto the response, as below:

Retrieve Parameter

The portlet(s) retrieving the parameter will need a Bean with a getter/setter for the parameter so it can be set by the Bridge, such as below:

To set the value on the Bean, the Bridge needs to be informed which Public Render Parameter you want to retrieve and which Bean you want it set on. If the above Bean is defined with a EL name of bookingPRP, then the faces-config.xml would be:

In the preceding example, the namespace associated with the "bridge" prefix is "".


bookingMapPortlet:hotelName as the parameter above needs to represent the name of your portlet (within portlet.xml) and name of the render parameter concatenated with a colon. If the portlet name is omitted and only the render parameter specified, every portlet within the web application that supports that render parameter will have their model updated. Specifying the portlet name as well restricts model updates to just that portlet.

Finally, we need the handler that was specified in the portlet.xml earlier to process the updates to the model as a result of the Public Render Parameter. Below is an example handler:

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Jul 08, 2013

    Parameter <bridge:public-parameter-mappings>is written twice.

    1. Jul 09, 2013

      There is <bridge:public-parameter-mappings> with an 's' and then <bridge:public-parameter-mapping> without an 's'.

      So I don't believe it is written twice.

      1. Jul 09, 2013


        Sorry Ken.