The Web Services for Remote Portlets (WSRP) specification defines a web service interface for accessing and interacting with presentation-oriented web services in the form of portlets. What are presentation-oriented web services? These are web services that send user interfaces over the wire, rather than raw data like JSON objects or SOAP data envelopes. If an application is written as a portlet, this is an easy way to expose that application to end users on a completely different system, rather than sending just the data and having to craft an application to present that data. WSRP’s presentation-oriented web services allow portals to display remote portlets inside their pages, as if locally deployed, without requiring any additional programming by developers.
Here are the two main components for WSRP:
Producer: A web service that exposes one or more portlets and is described using a Web Services Description Language (WSDL) document.
Consumer: A web service client that receives the data from the Producer and presents it to the user in a portlet window.
Below, you’ll see how the components interact with each other. So without further ado, let’s explore WSRP in Liferay!
WSRP with Liferay
Liferay provides a deployable WSRP portlet that supports the 1.0 and 2.0 specifications. The portlet is available from Liferay Marketplace as a CE or EE app. Once you’ve downloaded and installed the WSRP app, you have instant access to the portlet by navigating to the Control Panel and, under Apps, selecting WSRP.
Liferay Portal can be used as a WSRP producer or consumer. As a producer, it hosts portlets that are consumed by other portal servers (Liferay or non-Liferay) acting as WSRP consumers. The image below illustrates WSRP producers and consumers and how they interact.
As we mentioned in the previous chapter, there are two main components of the WSRP process: producers and consumers. Let’s go through the basic process of how producers and consumers work together to bring the end user a remote portlet. First, the consumer portal server establishes a connection with its producer portal server counterpart. This connection is made possible by giving the consumer the producer portlet’s URL. The consumer then uses the URL to discover the producer’s portlet and establish a connection. After the connection is made, the consumer acquires the producer’s information and creates a consumer proxy portlet. The proxy portlet acts as an intermediary, relaying requests to and from the end user and the producer portlet.
For example, you can compare the proxy portlet to a TV satellite box. If you want to change the channel on your TV, you (end user) send the channel number you desire to the TV’s satellite box (consumer’s proxy portlet) via your TV’s remote. When the satellite box receives the request to change the channel, it relays the request to a TV satellite (producer’s portlet) which then sends the channel information back to the satellite box. Then, the satellite box displays the new channel to you on your TV. In this simple example, you’re not directly requesting the TV satellite to change the channel, but rather, you’re communicating with the satellite box, which acts as an intermediary between you and the satellite. This example directly relates to using WSRP with Liferay. Although the end users are sending requests to the consumer portlet, they’re not receiving feedback from the consumer portlet itself, but rather its producer portlet located remotely.
Now that you know a little bit about the WSRP process, let’s begin configuring WSRP on Liferay Portal. For this demonstration, we’ll assume you have two portal servers.
To create a producer, go to the Producers tab and click Add Producer. Give your producer a name and choose the appropriate version of WSRP to use. Liferay displays a list of available portlets your producer can use. For demonstration purposes, select the Hello World portlet and click the Save button. The portal generates a WSDL document to define your producer. To view the WSDL document, click the URL link provided.
Now that we’ve created a producer, let’s create a consumer on your second portal server.
On your consumer portal server, navigate to the Consumers tab and select the Add Consumer button. Give it a name and add the producer’s WSDL URL in the URL field. There are also additional fields:
Forward Cookies: Allows the WSRP consumer to forward specific cookies from the user’s browser session to the WSRP producer.
Forward Headers: Allows the WSRP consumer to forward specific HTTP headers from the user’s browser session to the WSRP producer.
Markup Character Sets: Markup character encodings supported for the consumer are shown in a comma delimited list. UTF-8 is assumed and will be added automatically as a supported encoding.
Leave these additional fields blank for our demonstration. Lastly, we need to define the portlets that the end-user can use from this consumer. To do this, go to Actions → Manage Portlets for your consumer. Add the remote portlets that you’ve configured for your producer portal server. In this case, select the Hello World remote portlet and give the new portlet an arbitrary name. Now end users can “consume” or use the remote portlet just like any local portlet in the portal.
Next, you’ll learn how to create custom remote portlets.
Creating Custom Remote Portlets
With the demand for dynamic portlets by end users, sometimes a finite, pre-selected list of remote portlets isn’t enough. Because of this, Liferay allows you to make custom developed portlets remotely accessible for WSRP.
To enable your custom portlet for WSRP, you’ll need to add the
<remoteable>true</remoteable> tag in your portlet’s
<liferay-portlet-app> <portlet> <portlet-name>RemoteSamplePortlet</portlet-name> <remoteable>true</remoteable> ... </portlet> ... </liferay-portlet-app>
After editing your portlet’s
liferay-portlet.xml file, your custom portlet
will appear in the list of portlets available when creating a WSRP producer.
Congratulations! Now you can share all your portlets to end users using WSRP!
Next, we’ll learn how to remotely access Liferay services.