lumis.portal.service
Class GenericService

java.lang.Object
  lumis.portal.service.GenericService

All Implemented Interfaces:

IService

Direct Known Subclasses:

DouiService, PortletService

@StableMinor(version="4.1",
             sinceVersion="4.0")
public class GenericService
extends Object
implements IService

A generic service implementation. May be used as a base class for custom service implementations.

Since:

4.0.0

Field Summary

protected ServiceConfig

serviceConfig

Constructor Summary

GenericService()

Method Summary

void	autoAddDependencies(SessionConfig sessionConfig, ServiceInstanceConfig config, ITransaction transaction) Adds service specific dependencies.
protected String	getResourceClassName()
void	instanceAdded(SessionConfig sessionConfig, ServiceInstanceConfig config, ITransaction transaction) Called by the service container to indicate that a service instance has been added.
void	instanceDeleted(SessionConfig sessionConfig, ServiceInstanceConfig config, ITransaction transaction) Called by the service container to indicate that a service instance is about to be deleted.
void	instanceDeserialized(ServiceInstanceDeserializationContext serviceInstanceDeserializationContext) Called after an service instance is deserialized.
void	instanceDeserialized(SessionConfig sessionConfig, String serviceInstanceId, DeserializationConfig deserializationConfig, Node accessControlListNode, ITransaction transaction) Called after an service instance is deserialized.
void	instanceLoaded(ServiceInstanceConfig config) Called by the service container to indicate that a service instance has been loaded
void	instanceSerialized(ServiceInstanceSerializationContext serviceInstanceSerializationContext) Called after the serialization of a service instance.
void	instanceSerialized(SessionConfig sessionConfig, String serviceInstanceId, OutputStream outputStream, ITransaction transaction) Called after the serialization of a service instance.
void	instanceUnloaded(ServiceInstanceConfig config) Called by the service container to indicate that a service instance is about to be unloaded
void	load(ServiceConfig config) Called by the service container to indicate to a service that the service is being activated.
void	postRegister(SessionConfig sessionConfig, ServiceConfig serviceConfig, ITransaction transaction) Called by the service manager after a service definition is registered.
void	postUnregister(SessionConfig sessionConfig, ITransaction transaction) Called by the service manager after a service has been unregistered.
void	preRegister(SessionConfig sessionConfig, Node serviceXmlNode, ITransaction transaction) Called by the service manager when a service definition is about to be registered.
void	preUnregister(SessionConfig sessionConfig, ITransaction transaction) Called by the service manager when a service is about to be unregistered.
void	unload(ServiceConfig config) Called by the service container to indicate to a service that the it is being de-activated.

Methods inherited from class java.lang.Object

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

Field Detail

serviceConfig

protected ServiceConfig serviceConfig

Constructor Detail

GenericService

public GenericService()

Method Detail

preUnregister

public void preUnregister(SessionConfig sessionConfig,
                          ITransaction transaction)
                   throws PortalException

Description copied from interface: IService

Called by the service manager when a service is about to be unregistered.

Specified by:

preUnregister in interface IService

Parameters:

sessionConfig - the user session information.

transaction - transaction for persistence access.

Throws:

PortalException

postUnregister

public void postUnregister(SessionConfig sessionConfig,
                           ITransaction transaction)
                    throws PortalException

Description copied from interface: IService

Called by the service manager after a service has been unregistered.

Specified by:

postUnregister in interface IService

Parameters:

sessionConfig - the user session information.

transaction - transaction for persistence access.

Throws:

PortalException

preRegister

public void preRegister(SessionConfig sessionConfig,
                        Node serviceXmlNode,
                        ITransaction transaction)
                 throws PortalException

Description copied from interface: IService

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

Specified by:

preRegister in interface IService

Parameters:

sessionConfig - TODO

transaction - TODO

Throws:

PortalException

postRegister

public void postRegister(SessionConfig sessionConfig,
                         ServiceConfig serviceConfig,
                         ITransaction transaction)
                  throws PortalException

Description copied from interface: IService

Called by the service manager after a service definition is registered. This method allows the Service implementation to perform any custom registration that the service may require.

Specified by:

postRegister in interface IService

Throws:

PortalException

getResourceClassName

protected String getResourceClassName()

load

public void load(ServiceConfig config)
          throws ServiceException,
                 PortalException

Description copied from interface: IService

Called by the service container to indicate to a service that the service is being activated.

The service container calls the init method exactly once after instantiating the service. The init method must complete successfully before any interfaces are created.

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

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

Specified by:

load in interface IService

Parameters:

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

Throws:

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

PortalException

unload

public void unload(ServiceConfig config)
            throws ServiceException,
                   PortalException

Description copied from interface: IService

Called by the service container to indicate to a service that the it is being de-activated.

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

This method enables the service 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 current state in memory.

Specified by:

unload in interface IService

Parameters:

config - a ServiceConfig object containing the service's configuration

Throws:

ServiceException

PortalException

instanceLoaded

public void instanceLoaded(ServiceInstanceConfig config)
                    throws ServiceException

Description copied from interface: IService

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

Specified by:

instanceLoaded in interface IService

Parameters:

config - a ServiceInstanceConfig object containing the service's configuration

Throws:

ServiceException

instanceUnloaded

public void instanceUnloaded(ServiceInstanceConfig config)
                      throws ServiceException

Description copied from interface: IService

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

Specified by:

instanceUnloaded in interface IService

Parameters:

config - a ServiceInstanceConfig object containing the service's configuration

Throws:

ServiceException

instanceDeleted

public void instanceDeleted(SessionConfig sessionConfig,
                            ServiceInstanceConfig config,
                            ITransaction transaction)
                     throws ServiceException,
                            PortalException

Description copied from interface: IService

Called by the service container to indicate that a service instance is about to be deleted.

Specified by:

instanceDeleted in interface IService

config - a ServiceInstanceConfig object containing the service's configuration

Throws:

ServiceException

PortalException

autoAddDependencies

public void autoAddDependencies(SessionConfig sessionConfig,
                                ServiceInstanceConfig config,
                                ITransaction transaction)
                         throws ServiceException,
                                PortalException

Description copied from interface: IService

Adds service specific dependencies. This is usually called when an instance of the service is created.

Specified by:

autoAddDependencies in interface IService

Throws:

ServiceException

PortalException

instanceDeserialized

public void instanceDeserialized(SessionConfig sessionConfig,
                                 String serviceInstanceId,
                                 DeserializationConfig deserializationConfig,
                                 Node accessControlListNode,
                                 ITransaction transaction)
                          throws PortalException

Description copied from interface: IService

Called after an service instance is deserialized.

Specified by:

instanceDeserialized in interface IService

Parameters:

sessionConfig - user session information.

serviceInstanceId - the service instance id.

deserializationConfig - the deserialization configuration.

accessControlListNode - the deserialized acl node.

transaction - the transaction for persistence access.

Throws:

PortalException

See Also:

IService.instanceSerialized(SessionConfig, String, OutputStream, ITransaction)

instanceSerialized

public void instanceSerialized(SessionConfig sessionConfig,
                               String serviceInstanceId,
                               OutputStream outputStream,
                               ITransaction transaction)
                        throws PortalException

Description copied from interface: IService

Called after the serialization of a service instance. The service may add custom information on the output stream, and they will be available during #aclDeserialized.

Specified by:

instanceSerialized in interface IService

Parameters:

sessionConfig - user session information.

serviceInstanceId - the service instance id.

outputStream - the serialization outputStream.

transaction - the transaction for persistence access.

Throws:

PortalException

See Also:

IService.instanceDeserialized(SessionConfig, String, DeserializationConfig, Node, ITransaction)

instanceAdded

public void instanceAdded(SessionConfig sessionConfig,
                          ServiceInstanceConfig config,
                          ITransaction transaction)
                   throws ServiceException,
                          PortalException

Description copied from interface: IService

Called by the service container to indicate that a service instance has been added. Dependencies between services must never be created inside this method. Dependencies must be created in the IService.autoAddDependencies(lumis.portal.authentication.SessionConfig, lumis.portal.serviceinstance.ServiceInstanceConfig, lumis.util.ITransaction) method.

Specified by:

instanceAdded in interface IService

config - a ServiceInstanceConfig object containing the service's configuration

Throws:

ServiceException

PortalException

instanceDeserialized

public void instanceDeserialized(ServiceInstanceDeserializationContext serviceInstanceDeserializationContext)
                          throws PortalException

Description copied from interface: IService

Called after an service instance is deserialized.

Specified by:

instanceDeserialized in interface IService

Throws:

PortalException

instanceSerialized

public void instanceSerialized(ServiceInstanceSerializationContext serviceInstanceSerializationContext)
                        throws PortalException

Description copied from interface: IService

Called after the serialization of a service instance. The service may serialize additional structure or data

Specified by:

instanceSerialized in interface IService

Throws:

PortalException