The documentation in this section pertains specifically to use of the pre-2012 PortletFaces Bridge. If you are using the Liferay Faces Bridge, this documentation does not apply. Separate documentation for that bridge will be provided at a future date.
IPC or inter-portlet communication is a feature of the Portlet 2.0 specification that allows the sending and receiving of custom event between portlets. The portlet bridge makes it possible to use this features with JSF and ICEfaces with certain constraints.
In order to use standard IPC with ICEfaces and the PortletFaces Bridge, you need to do the following:
The component interaction that triggers the sending of an IPC event needs to have Ajax disabled so that the request is processed as an ActionRequest rather than a ResourceRequest. This can be done in several different ways. Refer to the section on Disabling Ajax for more detailed information.
To enable the portlet bridge to properly handle and direct incoming events, you need to provide and configure a BridgeEventHandler. The portlet bridge will use instances of this class and forward incoming events to it. This requires two things:
1) Create a class that implements the BridgeEventHandler interface. For example:
2) Configure the portlet that needs to receive the messages to use the event handler. This is done by specifying an init-param with the standard key for the BridgeEventHandler and the fully qualified name of the class that implements the interface:
3) The rest of the configuration involves standard IPC settings. How you add them may depend on the portal container you are running on. On Liferay, you modify the portlet.xml file and add the appropriate settings. For instance, in the portlet.xml file, you define your events and which portlets create and consume them:
© Copyright 2021 ICEsoft Technologies Canada Corp.