globals

Interface GlobalAccessible

All Superinterfaces:

PropertySupplying

All Known Subinterfaces:

GlobalGrouping, ParameterClustering

All Known Implementing Classes:

AbstractGlobalGroup, GlobalSet, ParameterSet

public interface GlobalAccessible
extends PropertySupplying

A generic interface for querying and manipulating global parameters. Each parameter served by this parameter watching instance must be wrapped into a Parameter. All initialization must already occur during the construction phase of the appropriate object.

As some parameters may refer to astrometric target properties, a TargetDefinition can be registered at the paramter set with #setTarget.

Field Summary

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Method Summary

Modifier and Type	Method and Description
void	addParameter(Parameter add) Adds a parameter to the parameter watching instance.
Map<String,Object>	change(Map<String,Object> all) Sets multiple parameter values.
long	currentTimeMillis() Gets the current time as defined in the cluster.
Object	get(String name) Gets the value of the parameter, regardless of type.
Set<String>	getAllParameterNames() Returns a set of all global parameter names served by this parameter watcher.
Collection<Parameter>	getAllParameters() Returns a collection of all global parameters served by this parameter watcher.
Parameter	getParameter(String name) Gets a global parameter by its name, returns null if undefined.
Boolean	getTrigger(String name) Returns the boolean of a specified Trigger instance.
Number	getValue(String name) Returns the value of a specified global parameter.
Parameter	removeParameter(String name) Removes a paramter from the parameter watching instance.
Object	set(String name, Object val) Sets the value of the parameter, regardless of type.
Boolean	setTrigger(String name, Boolean newval) Tries to set a trigger parameter identified with its name.
Number	setValue(String name, Number newval) Tries to set a global parameter.
Boolean	toggleTrigger(String name) Toggles a trigger given by its name.

Methods inherited from interface util.PropertySupplying

defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, parseObject, removeProperty, setObject, setProperty, stringProperties

Method Detail

getParameter

Parameter getParameter(String name)

Gets a global parameter by its name, returns null if undefined.

getAllParameters

Collection<Parameter> getAllParameters()

Returns a collection of all global parameters served by this parameter watcher. The returned collection consists of objects of Parameters.

getAllParameterNames

Set<String> getAllParameterNames()

Returns a set of all global parameter names served by this parameter watcher. Only reference to the names are returned.

currentTimeMillis

long currentTimeMillis()

Gets the current time as defined in the cluster. Use instead of System.currentTimeMillis

get

Object get(String name)

Gets the value of the parameter, regardless of type.

set

Object set(String name,
           Object val)

Sets the value of the parameter, regardless of type.

change

Map<String,Object> change(Map<String,Object> all)

Sets multiple parameter values. The argument map is treated such that its keys are matched to parameter names, their mapping values are directly passed to the parameters Parameter.set(java.lang.Object) method.

Returns:

A map with values equivalent to the old parameter values.

getValue

Number getValue(String name)

Returns the value of a specified global parameter. The parameter is identified with its name. The underlying parameter instance must be of type Value, otherwise null is returned.

setValue

Number setValue(String name,
                Number newval)

Tries to set a global parameter. The parameter is identified with its name. This method can result in an UnsupportedOperationException to be thrown.

getTrigger

Boolean getTrigger(String name)

Returns the boolean of a specified Trigger instance. The trigger is identified with its name.The underlying parameter instance must be of type Trigger, otherwise null is returned.

setTrigger

Boolean setTrigger(String name,
                   Boolean newval)

Tries to set a trigger parameter identified with its name. This method can result in an UnsupportedOperationException to be thrown.

toggleTrigger

Boolean toggleTrigger(String name)

Toggles a trigger given by its name. Returns the new trigger value. This method can result in an UnsupportedOperationException to be thrown.

addParameter

void addParameter(Parameter add)

Adds a parameter to the parameter watching instance. Useful for parameters like device triggers that require a very special setup and cannot be constructed from a properties set.
Any parameter that is added must spawn a search for other parameters that need it as an adiitional info.

removeParameter

Parameter removeParameter(String name)

Removes a paramter from the parameter watching instance. The parameter to remove is qualified by its name.

Returns:

The removed parameter or null if not served.