lumis.portal.service
Class GenericService

Package class diagram package GenericService
java.lang.Object
  extended by 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:

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


Lumisportal  4.1.0.071221 - Copyright © 2001-2007, Lumis. All Rights Reserved.