lumis.doui.service
Class DouiServiceInterface

java.lang.Object
  lumis.portal.serviceinterface.GenericServiceInterface
      lumis.doui.service.DouiServiceInterface

All Implemented Interfaces:

IDouiServiceInterface, IServiceInterface, IServiceInterfaceMenu

Direct Known Subclasses:

BannerDouiInterface, ContentServiceInterface, DouiAdministrationPropertyPageServiceInterface, DouiDetailsServiceInterface, DouiGenericListServiceInterface, LocalGroupDouiInterface, LocalUserDouiInterface, LoginInterface, LogoutInterface, UserSubscriptionInterface, UserSubscriptionInterface

@StableMinor(version="4.1",
             sinceVersion="4.0")
public class DouiServiceInterface
extends GenericServiceInterface
implements IServiceInterfaceMenu, IDouiServiceInterface

Base service interface implementation for the doui framework.

Since:

4.0.0

Field Summary

protected IServiceInterfaceRequest	request
protected IServiceInterfaceResponse	response
static String	VALIDATE_RENDER_PARAMETER

Constructor Summary

DouiServiceInterface()

Method Summary

protected boolean	addDefaultControls(Node serviceInterfaceDouiDefinitionNode, Node serviceDouiDefinitionNode, Node serviceInterfaceXmlNode)
void	addDefaultDouiDefinitionValues(SessionConfig sessionConfig, ServiceInterfaceConfig serviceInterfaceConfig, Node douiDefinitionNode, ITransaction transaction)
protected boolean	addDefaultFields(Node serviceInterfaceSourceNode, Node serviceDouiDefinitionNode, Node serviceInterfaceXmlNode)
protected boolean	addDefaultFilters(Node serviceInterfaceSourceNode, Node serviceDouiDefinitionNode, Node serviceInterfaceXmlNode)
protected boolean	addDefaultHyperLinks(Node serviceInterfaceDouiDefinitionNode, Node serviceDouiDefinitionNode, ITransaction transaction)
protected Node	addDefaultInterfaceDouiDefinitionNode(String serviceInterfaceId, Node serviceDouiDefinitionNode)
protected boolean	addDefaultMaxRows(Node serviceInterfaceSourceNode, Node serviceDouiDefinitionNode, Node serviceInterfaceXmlNode)
protected boolean	addDefaultOrderBy(Node serviceInterfaceSourceNode, Node serviceDouiDefinitionNode, Node serviceInterfaceXmlNode)
protected boolean	addDefaultProcessActions(Node serviceInterfaceDouiDefinitionNode, Node serviceDouiDefinitionNode, Node serviceInterfaceXmlNode)
protected boolean	addDefaultSources(Node serviceInterfaceDouiDefinitionNode, Node serviceDouiDefinitionNode, Node serviceInterfaceXmlNode)
protected boolean	addDetailsHyperLink(Node serviceInterfaceDouiDefinitionNode, Node serviceDouiDefinitionNode, ITransaction transaction)
protected boolean	addPrimaryKeyFilter(Node serviceInterfaceSourceNode, Node serviceDouiDefinitionNode, Node serviceInterfaceXmlNode)
protected DouiContext	getContext(IServiceInterfaceRequest request, IServiceInterfaceResponse response, ITransaction transaction)
protected String	getCustomMenu(SessionConfig sessionConfig, ServiceInterfaceInstanceConfig config, ITransaction transaction)
protected String	getDefaultStyle()
protected Node	getInterfaceSourceFieldsNode(Node serviceDouiDefinitionNode, Node serviceInterfaceSourceNode) Utility method that merges the fields in the given nodes and returns the merged resultant node.
Node	getMenu(SessionConfig sessionConfig, ServiceInterfaceInstanceConfig config, ITransaction transaction)
String	getRepositoryMenus(SessionConfig sessionConfig, ServiceInterfaceInstanceConfig config, ITransaction transaction)
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.
protected void	renderData(IServiceInterfaceRenderResponse response, DouiContext douiContext)

Methods inherited from class lumis.portal.serviceinterface.GenericServiceInterface

instanceAdded, instanceDeleted, instanceLoaded, instanceUnLoaded, load, unload

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

VALIDATE_RENDER_PARAMETER

public static final String VALIDATE_RENDER_PARAMETER

See Also:

Constant Field Values

request

protected IServiceInterfaceRequest request

response

protected IServiceInterfaceResponse response

Constructor Detail

DouiServiceInterface

public DouiServiceInterface()

Method Detail

render

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

Description copied from interface: IServiceInterface

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

Specified by:

render in interface IServiceInterface

Overrides:

render in class GenericServiceInterface

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

processAction

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

Description copied from interface: IServiceInterface

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.

Specified by:

processAction in interface IServiceInterface

Overrides:

processAction in class GenericServiceInterface

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

renderBefore

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

Description copied from interface: IServiceInterface

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.

Specified by:

renderBefore in interface IServiceInterface

Overrides:

renderBefore in class GenericServiceInterface

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

getContext

protected DouiContext getContext(IServiceInterfaceRequest request,
                                 IServiceInterfaceResponse response,
                                 ITransaction transaction)
                          throws PortalException

Throws:

PortalException

renderData

protected void renderData(IServiceInterfaceRenderResponse response,
                          DouiContext douiContext)
                   throws PortalException

Throws:

PortalException

getDefaultStyle

protected String getDefaultStyle()

getMenu

public Node getMenu(SessionConfig sessionConfig,
                    ServiceInterfaceInstanceConfig config,
                    ITransaction transaction)
             throws PortalException

Specified by:

getMenu in interface IServiceInterfaceMenu

Throws:

PortalException

getCustomMenu

protected String getCustomMenu(SessionConfig sessionConfig,
                               ServiceInterfaceInstanceConfig config,
                               ITransaction transaction)
                        throws PortalException

Throws:

PortalException

getRepositoryMenus

public String getRepositoryMenus(SessionConfig sessionConfig,
                                 ServiceInterfaceInstanceConfig config,
                                 ITransaction transaction)
                          throws PortalException

Throws:

PortalException

register

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

Description copied from interface: IServiceInterface

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.

Specified by:

register in interface IServiceInterface

Overrides:

register in class GenericServiceInterface

Parameters:

sessionConfig - TODO

transaction - TODO

Throws:

PortalException

addDefaultDouiDefinitionValues

public void addDefaultDouiDefinitionValues(SessionConfig sessionConfig,
                                           ServiceInterfaceConfig serviceInterfaceConfig,
                                           Node douiDefinitionNode,
                                           ITransaction transaction)
                                    throws PortalException

Specified by:

addDefaultDouiDefinitionValues in interface IDouiServiceInterface

Throws:

PortalException

getInterfaceSourceFieldsNode

protected Node getInterfaceSourceFieldsNode(Node serviceDouiDefinitionNode,
                                            Node serviceInterfaceSourceNode)
                                     throws PortalException

Utility method that merges the fields in the given nodes and returns the merged resultant node. This method is intented to be used as a way to have access to the fields definition that will exist in the final interface source (that consists in this merge).

Parameters:

serviceDouiDefinitionNode - the service doui definition node.

serviceInterfaceSourceNode - the service interface source node.

Returns:

a fields node, with the merged information.

Throws:

PortalException

Since:

4.0.5

addDefaultInterfaceDouiDefinitionNode

protected Node addDefaultInterfaceDouiDefinitionNode(String serviceInterfaceId,
                                                     Node serviceDouiDefinitionNode)
                                              throws PortalException

Throws:

PortalException

addDefaultSources

protected boolean addDefaultSources(Node serviceInterfaceDouiDefinitionNode,
                                    Node serviceDouiDefinitionNode,
                                    Node serviceInterfaceXmlNode)
                             throws PortalException

Throws:

PortalException

addDefaultFields

protected boolean addDefaultFields(Node serviceInterfaceSourceNode,
                                   Node serviceDouiDefinitionNode,
                                   Node serviceInterfaceXmlNode)
                            throws PortalException

Throws:

PortalException

addDefaultFilters

protected boolean addDefaultFilters(Node serviceInterfaceSourceNode,
                                    Node serviceDouiDefinitionNode,
                                    Node serviceInterfaceXmlNode)
                             throws PortalException

Throws:

PortalException

addDefaultOrderBy

protected boolean addDefaultOrderBy(Node serviceInterfaceSourceNode,
                                    Node serviceDouiDefinitionNode,
                                    Node serviceInterfaceXmlNode)
                             throws PortalException

Throws:

PortalException

addDefaultMaxRows

protected boolean addDefaultMaxRows(Node serviceInterfaceSourceNode,
                                    Node serviceDouiDefinitionNode,
                                    Node serviceInterfaceXmlNode)
                             throws PortalException

Throws:

PortalException

addDefaultControls

protected boolean addDefaultControls(Node serviceInterfaceDouiDefinitionNode,
                                     Node serviceDouiDefinitionNode,
                                     Node serviceInterfaceXmlNode)
                              throws PortalException

Throws:

PortalException

addDefaultHyperLinks

protected boolean addDefaultHyperLinks(Node serviceInterfaceDouiDefinitionNode,
                                       Node serviceDouiDefinitionNode,
                                       ITransaction transaction)
                                throws PortalException

Throws:

PortalException

addDefaultProcessActions

protected boolean addDefaultProcessActions(Node serviceInterfaceDouiDefinitionNode,
                                           Node serviceDouiDefinitionNode,
                                           Node serviceInterfaceXmlNode)
                                    throws PortalException

Throws:

PortalException

addDetailsHyperLink

protected boolean addDetailsHyperLink(Node serviceInterfaceDouiDefinitionNode,
                                      Node serviceDouiDefinitionNode,
                                      ITransaction transaction)
                               throws PortalException

Throws:

PortalException

addPrimaryKeyFilter

protected boolean addPrimaryKeyFilter(Node serviceInterfaceSourceNode,
                                      Node serviceDouiDefinitionNode,
                                      Node serviceInterfaceXmlNode)
                               throws PortalException

Throws:

PortalException