Home
User Guide
The information contained in this section applies to IBM WebSphere Commerce Version 7.0.0.9 and Feautre Pack 8. The documentation also applies to all subsequent releases and modifications until otherwise indicated in new editions.
Developing
The topics in the Developing section describe tasks performed by an application developer.
Presentation layer
WebSphere Commerce uses Java Server Pages (JSP) to implement the view layer of the Model-View-Controller (MVC) design pattern. The view layer is in charge of retrieving data from the database through the use of data beans and formatting it to meet the display requirements. The view layers determines whether the request is sent to a browser or streamed out as XML. JSP files present a clean separation between data content and presentation.
WebSphere Commerce integration with WebSphere Portal
You can integrate WebSphere Commerce, a Business Application Service with WebSphere Portal, an Interaction Service. The Interaction Service provides core portal services (WebSphere Portal) that aggregate applications and content and deliver them as role-based applications. The Enterprise Service Bus (ESB) pattern is used for communication, mediation, transformation and integration with external systems. Using an ESB to integrate the Web services exposed from WebSphere Commerce to the WebSphere Portal promotes a loosely coupled design where the ESB manages the interactions styles between the WebSphere Commerce services and the presentation layer. You do not need to alter your presentation layer to support the protocol and format used by the WebSphere Commerce services. Instead, you rely on the ESB to perform tasks such as message transformation and protocol mediation. Neither WebSphere Commerce nor WebSphere Portal needs to change in order to communicate with one another. The ESB is used to act as an interpreter between the two systems and will translate the messages into a format the receiving system understands.
Customizing WebSphere Commerce Portal integration
There are two main approaches to Customizing WebSphere Commerce Portal integration. Using the provided WebSphere Commerce MVCPortlet class (MVC style), and Using WebSphere Portal general programming techniques (Web service style).
Using the provided WebSphere Commerce MVCPortlet class (MVC style)
The WebSphere Commerce Portlet, MVCPortlet, is a generic implementation of the MVC pattern. It allows you to set up one or more portlets, each with its own configuration, to call various WebSphere Commerce services. The goal of this MVCPortlet is to cleanly separate the model (application logic that interacts with a database) from the view (HTML pages that are presented to the client) and the controller (instance that passes information between view and model). This programming pattern greatly reduces code redundancy and maintains a consistent behavior across all WebSphere Commerce portlet actions.
WebSphere Commerce Portal integration event handlers
The MVCPortlet framework is designed in a flexible way so that each portlet request can be handled differently using an event handler. For each action event and render event, it is possible to define a corresponding event handler in the portlet MVC configuration file.
WebSphere Commerce portlet render handler
The WebSphere Commerce Portlet render handler has only one task. It simply checks for the current state and mode of the portlet to determine the appropriate JSP path to be used when calling the request dispatcher.

WebSphere Commerce portlet render handler

The WebSphere Commerce Portlet render handler has only one task. It simply checks for the current state and mode of the portlet to determine the appropriate JSP path to be used when calling the request dispatcher.

Note: It is not recommended to make any WebSphere Commerce service call directly from this render handler, especially service calls that involve update operations. This handler is called upon every render request, even upon refreshing the portlet content. To optimize the response time, it is better to delegate all the read-only type service requests to be issued by the JSP instead by the controller. This is to allow the caching service to intercept any cachable request upon a cache hit and avoid unnecessary service calls to the WebSphere Commerce server.

A generic render handler, com.ibm.commerce.foundation.client.portal.handlers.MVCPortletRenderHandler, has been provided with the MVCPortlet. See the JavaDoc for MVCPortletRenderHandler for more information.

To create a new customized version of the WebSphere Commerce Portlet render handler, the new code must implement the com.ibm.commerce.foundation.client.portal.handlers.PortletRenderHandler interface.