de.aristaflow.adept2.base.service

Interface ConfigurableService

All Superinterfaces:

ADEPT2Service

All Known Subinterfaces:

ExecutionManager

All Known Implementing Classes:

AbstractConfigurableAuthenticatedService, AbstractConfigurableService

public interface ConfigurableService
extends ADEPT2Service

This interface extends an ADEPT2Servic by the means to retrieve and change the configuration. Not all services allow to change their configuration at runtime and not all of the configuration may be changed at all and not by all users. This is reflected in this interface.

Author:

Ulrich Kreher

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CONF_RUNTIME_CONF_PREFIX A prefix for runtime configuration values that have defaults in the normal configuration to be overridden by the runtime configuration.

Method Summary

Modifier and Type	Method and Description
java.util.List<java.lang.String>	getChangeableConfigurationKeys(SessionToken session) Gets a list of configuration keys that may be changed by the owner of the designated session token.
Configuration	getConfiguration(SessionToken session) Gets the configuration of this service for displaying it.
void	setConfigurationValue(SessionToken session, java.lang.String key, java.lang.String value) Sets the designated configuration value.

Methods inherited from interface de.aristaflow.adept2.base.service.ADEPT2Service

getLocalUris, getRelease, getRuntimeRequiredServices, getServiceInstanceName, getStartupRequiredServices, getURIs, init, ping, preShutdown, shutdown, start

Field Detail

CONF_RUNTIME_CONF_PREFIX

static final java.lang.String CONF_RUNTIME_CONF_PREFIX

A prefix for runtime configuration values that have defaults in the normal configuration to be overridden by the runtime configuration. The default and the runtime configuration values need to have different keys otherwise deleting a value will also delete the default value. The default value will reappear after the next reboot.

See Also:

Constant Field Values

Method Detail

getConfiguration

Configuration getConfiguration(SessionToken session)

Gets the configuration of this service for displaying it. It usually contains all configuration values of a service. Not all of them may be changed and not all of them by all users! Therefore filter the configuration appropriately based on the changeable keys. The returned configuration must not be changed directly since it usually is a copy of the configuration. Use setConfigurationValue(SessionToken, String, String) for changing configuration values.

Note to implementors: As stated above return a copy of the configuration and not the configuration itself. Additionally make sure the returned configuration is serialisable since it may be transfered to a remote machine.

Parameters:

session - The session which is used to check for access rights on this method.

Returns:

The configuration of the service. Some of its values may be changed.

getChangeableConfigurationKeys

java.util.List<java.lang.String> getChangeableConfigurationKeys(SessionToken session)

Gets a list of configuration keys that may be changed by the owner of the designated session token. Note that these may contain keys that are not yet in the configuration.

Parameters:

session - The session which is used to check for access rights on this method and to determine which configuration keys can be changed by the designated user.

Returns:

A list of strings that represent the keys that may be changed by the user identified by the designated session token.

setConfigurationValue

void setConfigurationValue(SessionToken session,
                           java.lang.String key,
                           java.lang.String value)
                    throws ConfigurationException

Sets the designated configuration value. Be sure to use a valid key. The keys are specified by the service. The value has to conform to the key, for instance, if the value is a list, the string has to reflect this appropriately. Use the empty string as value to delete the configuration.

Note to implementors: Check the configuration value for validity and the session token for whether it is allowed to change the configuration.

Parameters:

session - The session which is used to check for access rights on this method.

key - The key for the configuration value.

value - The string representation of the configuration value to be set.

Throws:

ConfigurationException - If there are problems setting the designated value, for instance, the value does not conform to the designated key or is not a valid value at all, a ConfigurationException will be thrown.