lumis.portal.serviceinterface
Interface IServiceInterface

All Known Implementing Classes:

BannerDouiInterface, ChatRoomHistoryInterface, ChatRoomParticipateInterface, CommentListServiceInterface, CommentQuickListServiceInterface, ContentAdministrationAddPropertyPageServiceInterface, ContentAdministrationEditPropertyPageServiceInterface, ContentAdministrationEmbeddedAddPropertyPageServiceInterface, ContentAdministrationListServiceInterface, ContentAdministrationPropertyPageServiceInterface, ContentDetailsServiceInterface, ContentGenericListServiceInterface, ContentListServiceInterface, ContentQuickListServiceInterface, ContentServiceInterface, ContentWizardAddServiceInterface, DisplayHtml, DocumentEditServiceInterface, DouiAdministrationAddPropertyPageServiceInterface, DouiAdministrationEditPropertyPageServiceInterface, DouiAdministrationEmbeddedAddPropertyPageServiceInterface, DouiAdministrationListServiceInterface, DouiAdministrationPropertyPageServiceInterface, DouiDetailsServiceInterface, DouiGenericListServiceInterface, DouiListServiceInterface, DouiQuickListServiceInterface, DouiServiceInterface, GenericServiceInterface, ImageEditServiceInterface, LocalGroupDouiInterface, LocalUserDouiInterface, LoginInterface, LogoutInterface, PortletServiceInterface, RemotePortletServiceInterface, ServiceInterfaceHolder, UserSubscriptionInterface, UserSubscriptionInterface, WebPage, WebServiceViewer

@StableMinor(version="5.5",
             sinceVersion="4.0")
public interface IServiceInterface

The ServiceInterface interface is used by the service interface container to invoke the service interfaces. Every service interface has to implement this interface, either by directly implementing it, or by using an existing class implementing the ServiceInterface interface.

A service interface is a Java technology-based web component. It is managed by the service interface container and processes requests and generates dynamic content as response. ServiceInterfaces are used by portals as pluggable user interface components.

The content generated by a service interface is called a fragment. A fragment is a piece of markup (e.g. HTML, XHTML, WML) adhering to certain rules and can be aggregated with other fragments into a complete document. The content of a service interface is normally aggregated with the content of other service interfaces into the portal page.

The service interface container instanciates service interfaces, manages their lifecycle and invoking them to process requests. The lifecycle consists of:

• initializing the service interface using using the init method
• request processsing
• taking the service interface out of service using the destroy method

Request processing is divided into two types:

• action requests handled through the processAction method, to perform actions targeted to the service interface
• render requests handled through the render method, to perform the render operation

Since:

4.0.9

Method Summary

void	instanceAdded(ServiceInterfaceInstanceConfig config, ITransaction transaction) Called by the service container to indicate that a service interface instance has been added
void	instanceDeleted(ServiceInterfaceInstanceConfig config) Called by the service container to indicate that a service interface instance has been deleted
void	instanceLoaded(ServiceInterfaceInstanceConfig config)
void	instanceUnLoaded(ServiceInterfaceInstanceConfig config) Called by the service container to indicate that a service interface instance is about to be destroyed
void	load(ServiceInterfaceConfig config) Called by the service interface container to indicate to a service interface that the service interface is being placed into service.
void	processAction(IServiceInterfaceActionRequest request, IServiceInterfaceActionResponse response) Called by the service interface container to allow the service interface to process an action request.
void	register(SessionConfig sessionConfig, Node serviceInterfaceXmlNode, ITransaction transaction) Called by the service interface manager when a service interface definition is registered.
void	render(IServiceInterfaceRenderRequest request, IServiceInterfaceRenderResponse response) Called by the service interface container to allow the service interface to generate the content of the response based on its current state.
void	renderBefore(IServiceInterfaceRenderRequest request, IServiceInterfaceRenderResponse response) Called by the service interface container before rendering the interface client side.
void	unload() Called by the service interface container to indicate to a service interface that the service interface is being taken out of service.

Method Detail

register

void register(SessionConfig sessionConfig,
              Node serviceInterfaceXmlNode,
              ITransaction transaction)
              throws PortalException

Called by the service interface manager when a service interface definition is registered. This method allows the Service Interface implementation to set its default values into the service interface definition xml.

Parameters:

sessionConfig - TODO

serviceInterfaceXmlNode -

transaction - TODO

Throws:

PortalException

load

void load(ServiceInterfaceConfig config)
          throws ServiceInterfaceException,
                 PortalException

Called by the service interface container to indicate to a service interface that the service interface is being placed into service.

The service interface container calls the init method exactly once after instantiating the service interface. The init method must complete successfully before the service interface can receive any requests.

The service interface container cannot place the service interface into service if the init method

1. Throws a ServiceInterfaceException
2. Does not return within a time period defined by the service interface container.

Parameters:

config - a ServiceInterfaceConfig object containing the service interface's configuration and initialization parameters

Throws:

ServiceInterfaceException - if an exception has occurred that interferes with the service interface's normal operation.

PortalException - if the service interface cannot perform the initialization at this time.

unload

void unload()
            throws ServiceInterfaceException,
                   PortalException

Called by the service interface container to indicate to a service interface that the service interface is being taken out of service.

Before the service interface container calls the destroy method, it should allow any threads that are currently processing requests within the service interface object to complete execution. To avoid waiting forever, the service interface container can optionally wait for a predefined time before destroying the service interface object.

This method enables the service interface to do the following:

• clean up any resources that it holds (for example, memory, file handles, threads)
• make sure that any persistent state is synchronized with the service interface current state in memory.

Throws:

ServiceInterfaceException - if the service interface has problems fulfilling the request

PortalException - if the service interface is unavailable to process the action at this time

instanceLoaded

void instanceLoaded(ServiceInterfaceInstanceConfig config)
                    throws ServiceInterfaceException,
                           PortalException

Parameters:

config - a ServiceInterfaceInstanceConfig object containing the service interface instance's configuration and initialization parameters

Throws:

ServiceInterfaceException - if the service interface has problems fulfilling the request

PortalException - if the service interface is unavailable to process the action at this time

instanceUnLoaded

void instanceUnLoaded(ServiceInterfaceInstanceConfig config)
                      throws ServiceInterfaceException,
                             PortalException

Called by the service container to indicate that a service interface instance is about to be destroyed

Parameters:

config - a ServiceInterfaceInstanceConfig object containing the service interface instance's configuration and initialization parameters

Throws:

ServiceInterfaceException - if the service interface has problems fulfilling the request

PortalException - if the service interface is unavailable to process the action at this time

instanceAdded

void instanceAdded(ServiceInterfaceInstanceConfig config,
                   ITransaction transaction)
                   throws ServiceInterfaceException,
                          PortalException

Called by the service container to indicate that a service interface instance has been added

Parameters:

config - a ServiceInterfaceInstanceConfig object containing the service interface instance's configuration and initialization parameters

Throws:

ServiceInterfaceException - if the service interface has problems fulfilling the request

PortalException - if the service interface is unavailable to process the action at this time

instanceDeleted

void instanceDeleted(ServiceInterfaceInstanceConfig config)
                     throws ServiceInterfaceException,
                            PortalException

Called by the service container to indicate that a service interface instance has been deleted

Parameters:

config - a ServiceInterfaceInstanceConfig object containing the service interface instance's configuration and initialization parameters

Throws:

ServiceInterfaceException - if the service interface has problems fulfilling the request

PortalException - if the service interface is unavailable to process the action at this time

processAction

void processAction(IServiceInterfaceActionRequest request,
                   IServiceInterfaceActionResponse response)
                   throws ServiceInterfaceException,
                          PortalException

Called by the service interface container to allow the service interface to process an action request. This method is called if the client request was originated by a URL created (by the service interface) with the RenderResponse.createActionURL() method.

Typically, in response to an action request, a service interface updates state based on the information sent in the action request parameters. In an action the service interface may:

• issue a redirect
• change its window state
• change its service interface mode
• modify its persistent state
• set render parameters

A client request triggered by an action URL translates into one action request and many render requests, one per service interface in the portal page. The action processing must be finished before the render requests can be issued.

Parameters:

request - the action request

response - the action response

Throws:

ServiceInterfaceException - if the service interface has problems fulfilling the request

PortalException - if the service interface is unavailable to process the action at this time

render

void render(IServiceInterfaceRenderRequest request,
            IServiceInterfaceRenderResponse response)
            throws ServiceInterfaceException,
                   PortalException

Called by the service interface container to allow the service interface to generate the content of the response based on its current state.

Parameters:

request - the render request

response - the render response

Throws:

ServiceInterfaceException - if the service interface has problems fulfilling the rendering request

PortalException - if the service interface is unavailable to perform render at this time

renderBefore

void renderBefore(IServiceInterfaceRenderRequest request,
                  IServiceInterfaceRenderResponse response)
                  throws ServiceInterfaceException,
                         PortalException

Called by the service interface container before rendering the interface client side. This method would generally print to the beforeWriter any client side scripts that must be loaded before rendering the interface.

Parameters:

request - the render request

response - the render response

Throws:

ServiceInterfaceException - if the service interface has problems fulfilling the rendering request

PortalException - if the service interface is unavailable to perform render at this time