Subbu Allamaraju


These goals call out for a collaborative solution where in the portlet will use some portal provided means to dispatch asynchronous requests to the consumer.


  1. Define an XMLPortletRequest interface. Consumers implement this interface and provide it as part of the aggregated page.

  2. Keep this interface semantically and syntactically close to XMLHttpRequest ( for easier adoption and pluggability into JavaScript toolkits. For instance, portlets should be able to replace new XMLHttpRequest() with new XMLPortletRequest() and be able to do Ajax programming. The same applies JavaScript toolkits such as Dojo (

  3. Since XMLPortletRequest will most likely be implemented in JavaScript as a layer on top of XMLHttpRequest, in this proposal, some of the conformance statements have to be kept intentionally weaker than those specified for the XMLHttpRequest.

The XMLPortletRequest Interface

The XMLPortletRequest interface is a script interface implemented by Consumers to allow portlet scripts to perform HTTP client functionality similar to the functionality provided by XMLHttpRequest. The XMLPortletRequest is modeled after the XMLHttpRequest, and as such, unless stated otherwise, most of the concepts, behavior (including security constraints and considerations) of the XMLHttpRequest also apply to XMLPortletRequest.

The XMLPortletRequest is intended to be used by a portlets as a replacement of XMLHttpRequest so as to take advantage of the lifecycle and state management features offered by the WSRP protocol.

The XMLPortletRequest object has the following attributes:

The XMLPortletRequest has the following methods:

Consumer's Responsibilities


Portlet Using XMLPortletRequest Directly for Ajax Requests

    // The URL is created by using a container provided API - may be an action or render URL
    var url = '...';

    // This object is provided by the consumer/portal page
    var request = new XMLPortletRequest();
    request.onreadystatechange = function()
        if (request.readyState == 4 && request.status == 200) {
            if (request.responseText) {
                // Process
     }'GET', url, true);


  1. The URL above is generated by spec-defined means via consumer rewriting or producer writing.
  2. Whether the portlet receives responseText or responseXML depends on the markup returned by the portlet.

Portlets Using a Consumer-Provided Version of Dojo Toolkit

This example illustrates that Consumers can adopt well-known toolkits such as Dojo to XMLPortletRequest. Whether this is possible with other toolkits or not depends on the architecture of those toolkits.

    // The URL is created by using a container provided API - may be an action or render URL
    var url = '...';{
        url: url,
        load: function(type, data, evt) {
                // Process
        mimetype: "text/plain"


  1. In this example, the Consumer replaced the factory code used to create XMLHttpRequest to return an instance of XMLPortletRequest. People familiar with the architecture of Dojo would notice that this can done by replacing Dojo's XMLHTTPTransport transport layer.


  1. This is a pure script interface and does not require protocol changes except for any metadata exchange if desired. As such, the proposal is independent of the version of the WSRP protocol.
  2. The interface is syntactically equivalent and semantically weaker than XMLHttpRequest to allow easier adoption in weakly-typed scripting languages such as JavaScript. Except for the code used to obtain an instance of XMLPortletRequest, the rest of the script logic can remain the same, still allowing Consumers to perform browser level aggregation and state updates behind the scenes.


  1. [Rich] While I like the simplicity of this approach dropping in for Portlets already doing AJAX, I would rather not require that portlets adopt the AJAX programming style. Having the Consumer's framework provide APIs for registering onLoad and onRefresh handlers could allow normal portlet programming with the framework then providing the underlying AJAX usage. I think a fuller range of Portlet-Consumer cooperation to achieve the results of the AJAX style needs to be defined.

    • [Subbu] I considered that. While it may be possible to compe with such an API hiding the Ajax usage, one key issue is the latency. We can only follow what is already being done by web developers. More importantly, programming model decisions are already being made by various Ajax toolkits, and I'm motivated by a design to keep adoption simple/quick to achieve.

XMLPortletRequest_Proposal (last edited 2009-08-12 18:06:27 by localhost)