com.sapportals.wcm.util.controlstatus
Class ControlStatusService

[contained in: com.sap.netweaver.bc.util.par - bc.util.public_api.jar]

java.lang.Object
  |
  +--com.sapportals.wcm.util.controlstatus.ControlStatusService

public class ControlStatusService

extends java.lang.Object

Field Summary

static java.lang.String	CACHE
static java.lang.String	CSS
static int	MAX_SIZE

Method Summary

java.lang.String	addControlStatus(IControlStatus status) adds the given object and returns the key to retrieve the object again through the getControlStatus method.
boolean	deleteControlStatus(java.lang.String key) deletes an IControlStatus object with the given key from the service's persistence.
java.util.List	getCacheEntries(java.util.Locale locale)
IControlStatus	getControlStatus(java.lang.String key) returns the IControlStatus that has been saved with this key.
static ControlStatusService	getInstance() returns the singleton instance of this service.

Methods inherited from class java.lang.Object

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

Field Detail

CSS

public static final java.lang.String CSS

CACHE

public static final java.lang.String CACHE

MAX_SIZE

public static final int MAX_SIZE

Method Detail

getInstance

public static ControlStatusService getInstance()

returns the singleton instance of this service. If this method is called for the first time, the service will read its configuration to initialize its persistence layer, using the CacheFactory . If no configuration can be found or the configuration is invalid, the service will use a simple HashMap to store IControlStatus elements. This mode is unsafe and error messages will be provided in the log files.

Returns:

the singleton instance of this service

getControlStatus

public IControlStatus getControlStatus(java.lang.String key)
                                throws ControlStatusException

returns the IControlStatus that has been saved with this key.

Parameters:

key - TBD: Description of the incoming method parameter

Returns:

an IControlStatus object or null .

Throws:

ControlStatusException - if an exception in the persistence layer occurs. The original exception is nested within the thrown exception.

getCacheEntries

public java.util.List getCacheEntries(java.util.Locale locale)

addControlStatus

public java.lang.String addControlStatus(IControlStatus status)
                                  throws ControlStatusException

adds the given object and returns the key to retrieve the object again through the getControlStatus method. This method is synchronized because execution of this method might change the structure of the underlying persistence. The returned key is also added as an attribute to the status.

Parameters:

status - the object to store

Returns:

the key to retrieve the given object at a later time

Throws:

ControlStatusException - if an exception in the persistence layer occurs. The original exception is nested within the thrown exception.

deleteControlStatus

public boolean deleteControlStatus(java.lang.String key)
                            throws ControlStatusException

deletes an IControlStatus object with the given key from the service's persistence.

Parameters:

key - the key of the object to delete

Returns:

flag stating if a document was found and consequently deleted ( true ) or if no element could be found (false ).

Throws:

ControlStatusException - if an exception in the persistence layer occurs. The original exception is nested within the thrown exception. If the exception is thrown, it is unknown, if the object has been deleted or not.