portletspec3
  1. portletspec3
  2. PORTLETSPEC3-31

Provide a mechanism to automatically copy render parameters to the StateAwareResponse during action requests and event requests

    Details

      Description

      A common portlet programming use case is to copy the render parameters representing the portlet state from the ActionRequest or EventRequest to the ActionResponse or EventResponse (StateAwareResponse), respectively. To improve the portlet API usability, a mechanism should be implemented that would allow the render parameters to be automatically added to the StateAwareResponse to that programmers would only need to set parameters to reflect the changes that need to take place due to action or event request handling.

      This represents a break compared with the JSR 286 programming model, so a runtime option to control this behavior should be added as well.

      javax.portlet.copyRenderParametersToResponse
      TRUE - The render parameters are automatically copied to the response
      FALSE - The render parameters are not copied to the response, implementing the JSR 286 behavior.

      Use of this parameter would make migration of JSR 286 portlets to the JSR 362 programming model easier.

      We would need to decide on the default setting for this parameter.

      1) On the one hand, the portlet container could recognize the portlet version based on the deployment descriptor. The portlet container could (logically) set the parameter to TRUE when a JSR 362 portlet is loaded and to FALSE when a JSR 286 portlet is loaded. For the migration case where a major JSR 286 portlet application is migrated to JSR 362 in order to use new features, but it would be too much work to change the parameter handling, the programmer could explicitly set the runtime setting to FALSE in the deployment descriptor to facilitate migration.

      2) On the other hand, an experienced portlet programmer might not realize that there is a major difference in this area, and be completely surprised and irritated by the new behavior. To prevent such surprises, it might be better to have the default setting to always be FALSE, and allow programmers who wish to take advantage of the new behavior to explicitly set the runtime option in the deployment descriptor to TRUE.

        Activity

          People

          • Assignee:
            msnicklous
            Reporter:
            msnicklous
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated: