Package lumis.portal.serviceinterface

Class GenericServiceInterface

    • Constructor Detail

      • GenericServiceInterface

        public GenericServiceInterface()

    • Method Detail

      • register

        public void register​(SessionConfig sessionConfig,
                     org.w3c.dom.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
        Parameters:
        sessionConfig - TODO
        transaction - TODO
        Throws:
        PortalException

      • load

        public void load​(ServiceInterfaceConfig config)
          throws ServiceInterfaceException,
                 PortalException
        Description copied from interface: IServiceInterface
        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.
        Specified by:
        load in interface IServiceInterface
        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

        public void unload()
            throws ServiceInterfaceException,
                   PortalException
        Description copied from interface: IServiceInterface
        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.
        Specified by:
        unload in interface IServiceInterface
        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

        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
        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

      • calculateIsRequestInitializerSupported

        protected boolean calculateIsRequestInitializerSupported​(ServiceInterfaceConfig serviceInterface)
                                                  throws PortalException
        Calculates whether the given service interface supports request initialization.
        Parameters:
        serviceInterface - the service interface
        Returns:
        whether the given service interface supports request initialization.
        Throws:
        PortalException
        Since:
        15.0.0