com.sapportals.wcm.service
Class AbstractService

[contained in: com.sap.netweaver.bc.sf.par - bc.sf.framework_api.jar]

java.lang.Object
  |
  +--com.sapportals.wcm.service.AbstractService

All Implemented Interfaces:

IComponent, IComponentInfo, IConfigurable, ILifecycleInfo, IService, IStartable

public abstract class AbstractService

extends java.lang.Object

implements IService, IComponent, IConfigurable, IStartable, IComponentInfo, ILifecycleInfo

The abstract base class for global Services.

Copyright (c) SAP AG 2001 - 2002

Inner Class Summary

static interface

AbstractService.CONFIG_ATTRIBUTE_NAME TBD: Description of the class.

Field Summary

protected IConfiguration	config This service's configuration
protected java.util.Properties	properties This service's configuration converted to a Properties object.
protected ComponentStateHandler	stateHandler

Constructor Summary

AbstractService()
The default constructor

AbstractService(java.util.Properties properties)
Deprecated. As of EP 5.0 SP5, replaced by default (public, no arguments) constructor.

Method Summary

void	configure(IConfiguration config) Passes the configuration data to the configurable.
static java.util.Properties	convertConfigToProperties(IConfiguration config) Helper method for conversion of configuration data into properties.
protected static java.util.Properties	convertConfigToProperties(IConfiguration config, java.lang.String prefix) Helper method for conversion of configuration data into properties.
java.util.Date	getCreationDate() Returns the date and time of the creation of the component instance.
java.lang.String	getDescription() Get a description for this service.
java.lang.String	getDescription(java.util.Locale locale) Get a description for this service.
java.lang.String	getID() Get a service identifier, unique for this instance.
ConfigurationException	getLastConfigurationException() Returns the exception thrown in the last call to IConfigurable.configure(IConfiguration), or IReconfigurable.reconfigure(IConfiguration).
java.util.Date	getLastReconfigurationDate() Returns the date and time of the last reconfiguration of this component.
java.lang.String	getName() Returns the component's human-readable name or null .
java.util.Date	getNextAutoRestartDate() Returns the date and time of the next automatic restart of the component.
java.util.Properties	getProperties() Returns some arbitrary properties with information about the component or null .
StartupException	getStartupException() Returns the exception thrown in the last call to IStartable.start(), Can be null .
ComponentState	getState() Returns the current life-cycle state of the component.
java.lang.String	getType() Deprecated. As of EP 5.0 SP5, The "service type" is the name of the configurable class.
protected void	postService()
protected void	preService()
protected void	shutDown() Deprecated. As of EP 5.0 SP5, replaced by startUpImpl().
protected void	shutDownImpl() The implementation must overwrite this method if it has to release resources acquired during shutdown.
void	start() A component must implement this method if it has initial startup handling to do before being accessible (acquire resources, open connections to remote systems, etc).
protected void	startUp() Deprecated. As of EP 5.0 SP5, replaced by shutDownImpl().
protected void	startUpImpl() The implementation must overwrite this method if it has initial startup handling to do (acquire resources, open connections to remote systems, etc).
void	stop() This method is only called once during the life-time of a component.

Methods inherited from class java.lang.Object

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

Field Detail

config

protected IConfiguration config

This service's configuration

properties

protected java.util.Properties properties

This service's configuration converted to a Properties object. This will be null unless the manager implementation calls the conversion method in startUp !!

stateHandler

protected final ComponentStateHandler stateHandler

Constructor Detail

AbstractService

public AbstractService()

The default constructor

AbstractService

public AbstractService(java.util.Properties properties)
                throws WcmException

Deprecated. As of EP 5.0 SP5, replaced by default (public, no arguments) constructor.

Parameters:

properties - TBD: Description of the incoming method parameter

Throws:

WcmException - Exception raised in failure situation

Method Detail

getID

public final java.lang.String getID()

Description copied from interface: IService

Get a service identifier, unique for this instance.

Specified by:

getID in interface IService

Following copied from interface: com.sapportals.wcm.service.IService

Returns:

The unique ID of this service.

getDescription

public java.lang.String getDescription()

Description copied from interface: IService

Get a description for this service.

Specified by:

getDescription in interface IService

Following copied from interface: com.sapportals.wcm.service.IService

Returns:

The discription of the service.

getType

public java.lang.String getType()

Deprecated. As of EP 5.0 SP5, The "service type" is the name of the configurable class.

Returns:

type

configure

public final void configure(IConfiguration config)
                     throws ConfigurationException

Description copied from interface: IConfigurable

Passes the configuration data to the configurable. This method will by called by the CRT only once. It is called after construction and contextualization and before startup (if implemented).

Specified by:

configure in interface IConfigurable

Following copied from interface: com.sapportals.wcm.crt.component.IConfigurable

Parameters:

configuration - the component's configuration data.

Throws:

ConfigurationException - Exception raised in failure situation

start

public final void start()
                 throws StartupException

Description copied from interface: IStartable

A component must implement this method if it has initial startup handling to do before being accessible (acquire resources, open connections to remote systems, etc). This method is only called once during the life-time of a component except an AutoRestartException was thrown.

Specified by:

start in interface IStartable

Following copied from interface: com.sapportals.wcm.crt.component.IStartable

Throws:

StartupException - If the initialization failed because neccessary resources could not be allocated.

stop

public final void stop()

Description copied from interface: IStartable

This method is only called once during the life-time of a component. It is called by the CRT when the component was removed from the configuration or the system shuts down. A stopped component can not be (re)started. After a shutdown the component instance will be finalized by the Java VM as soon as no other components in the system holds a reference to it.

Specified by:

stop in interface IStartable

getName

public java.lang.String getName()

Description copied from interface: IComponentInfo

Returns the component's human-readable name or null .

Specified by:

getName in interface IComponentInfo

Following copied from interface: com.sapportals.wcm.crt.component.IComponentInfo

Returns:

the component's human-readable name or null .

getDescription

public java.lang.String getDescription(java.util.Locale locale)

Description copied from interface: IService

Get a description for this service.

Specified by:

getDescription in interface IService

Following copied from interface: com.sapportals.wcm.service.IService

Parameters:

locale - TBD: Description of the incoming method parameter

Returns:

The discription of the service.

getProperties

public java.util.Properties getProperties()

Description copied from interface: IComponentInfo

Returns some arbitrary properties with information about the component or null .

Specified by:

getProperties in interface IComponentInfo

Following copied from interface: com.sapportals.wcm.crt.component.IComponentInfo

Returns:

some arbitrary properties with information about the component or null .

getState

public ComponentState getState()

Description copied from interface: ILifecycleInfo

Returns the current life-cycle state of the component. Can be null .

Specified by:

getState in interface ILifecycleInfo

Following copied from interface: com.sapportals.wcm.crt.component.ILifecycleInfo

Returns:

the current life-cycle state of the component. Can be null .

getLastConfigurationException

public ConfigurationException getLastConfigurationException()

Description copied from interface: ILifecycleInfo

Returns the exception thrown in the last call to IConfigurable.configure(IConfiguration), or IReconfigurable.reconfigure(IConfiguration). Can be null .

Specified by:

getLastConfigurationException in interface ILifecycleInfo

Following copied from interface: com.sapportals.wcm.crt.component.ILifecycleInfo

Returns:

lastConfigurationException

getStartupException

public StartupException getStartupException()

Description copied from interface: ILifecycleInfo

Returns the exception thrown in the last call to IStartable.start(), Can be null .

Specified by:

getStartupException in interface ILifecycleInfo

Following copied from interface: com.sapportals.wcm.crt.component.ILifecycleInfo

Returns:

startupException

getCreationDate

public final java.util.Date getCreationDate()

Description copied from interface: ILifecycleInfo

Returns the date and time of the creation of the component instance. Can be null . This property usually makes sense only for components that implement the IThreadSafe interface.

Specified by:

getCreationDate in interface ILifecycleInfo

Following copied from interface: com.sapportals.wcm.crt.component.ILifecycleInfo

Returns:

the date and time of the creation of the component instance. Can be null .

getLastReconfigurationDate

public java.util.Date getLastReconfigurationDate()

Description copied from interface: ILifecycleInfo

Returns the date and time of the last reconfiguration of this component. Can be null .

Specified by:

getLastReconfigurationDate in interface ILifecycleInfo

Following copied from interface: com.sapportals.wcm.crt.component.ILifecycleInfo

Returns:

the date and time of the last reconfiguration of this component. Can be null .

getNextAutoRestartDate

public java.util.Date getNextAutoRestartDate()

Description copied from interface: ILifecycleInfo

Returns the date and time of the next automatic restart of the component. Can be null .

Specified by:

getNextAutoRestartDate in interface ILifecycleInfo

Following copied from interface: com.sapportals.wcm.crt.component.ILifecycleInfo

Returns:

the date and time of the next automatic restart of the component. Can be null .

See Also:

AutoRestartException

preService

protected void preService()
                   throws WcmException

postService

protected void postService()

startUpImpl

protected void startUpImpl()
                    throws ConfigurationException,
                           StartupException

The implementation must overwrite this method if it has initial startup handling to do (acquire resources, open connections to remote systems, etc). Accoring to the contract of the IStartable interface of the CRT this method will be called only once. It will be called on systen start up or when a new instance of this component is added to the persistence configuration.

Throws:

ConfigurationException - Exception raised in failure situation

StartupException - Exception raised in failure situation

shutDownImpl

protected void shutDownImpl()

The implementation must overwrite this method if it has to release resources acquired during shutdown. Accoring to the contract of the IStartable interface of the CRT this method will be called only once. It will be called when the component is removed from the persistent configuration or when the system shuts down.

startUp

protected void startUp()
                throws WcmException

Deprecated. As of EP 5.0 SP5, replaced by shutDownImpl().

The implementation must overwrite this method if it has initial startup handling to do (acquire resources, open connections to remote systems, etc).

Throws:

WcmException - Exception raised in failure situation

shutDown

protected void shutDown()
                 throws WcmException

Deprecated. As of EP 5.0 SP5, replaced by startUpImpl().

The implementation must overwrite this method if it has to release resources acquired during shutdown.

Throws:

WcmException - Exception raised in failure situation

convertConfigToProperties

public static final java.util.Properties convertConfigToProperties(IConfiguration config)

Helper method for conversion of configuration data into properties.

Parameters:

config - which attributes should be converted to properties

Returns:

converted config as properties

convertConfigToProperties

protected static final java.util.Properties convertConfigToProperties(IConfiguration config,
                                                                      java.lang.String prefix)

Helper method for conversion of configuration data into properties.

Parameters:

config - which attributes should be converted to properties

prefix - to prepend to config attribute names

Returns:

converted config as properties