org.yamcs

Class YConfiguration

java.lang.Object

org.yamcs.YConfiguration

public class YConfiguration
extends Object

A configuration object is a wrapper around a Map<String, Object> which keeps track to a parent and its original file (if any). This class loads yamcs configurations. There are a number of "subsystems", each using a corresponding subsystem.yaml file There are three places where a configuration file is looked up in order:

• in the prefix/file.yaml via the classpath if the prefix is set in the setup method (used in the unittests)
• in the userConfigDirectory .yamcs/etc/file.yaml
• in the file.yaml via the classpath.

Author:

nm

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	YConfiguration.ConfigurationNotFoundException Introduced to be able to detect when a configuration file was not specified (as opposed to when there's a validation error inside).
static class	YConfiguration.DefaultConfigurationResolver Default config file resolver.

Constructor Summary

Constructors

Constructor and Description
YConfiguration(String subsystem, InputStream is, String confpath) Constructs a new configuration object parsing the input stream
YConfiguration(YConfiguration parent, String parentKey, Map<String,Object> root)

Method Summary

Modifier and Type	Method and Description
boolean	containsKey(String key)
boolean	containsKey(String key, String key1)
static YConfiguration	emptyConfig()
Object	get(String key)
static boolean	getBoolean(Map<String,Object> m, String key)
static boolean	getBoolean(Map<String,Object> m, String key, boolean defaultValue) Returns m.get(key) if it exists and is of type boolean, if m.get(key) exists and is not boolean, throw an exception.
boolean	getBoolean(String key)
boolean	getBoolean(String key, boolean defaultValue)
boolean	getBoolean(String key, String key1)
YConfiguration	getConfig(String key) If the key is pointing to a map, creates and returns a configuration object out of that map
List<YConfiguration>	getConfigList(String key)
static YConfiguration	getConfiguration(String subsystem) Loads (if not already loaded) and returns a configuration corresponding to a file <subsystem>.yaml This method does not reload the configuration file if it has changed.
static YConfiguration	getConfiguration(String subsystem, boolean reload) Loads and returns a configuration corresponding to a file <subsystem>.yaml This method reloads the configuration file always.
static double	getDouble(Map<String,Object> m, String key, double v)
double	getDouble(String key)
double	getDouble(String key, double defaultValue)
static <T extends Enum<T>> T	getEnum(Map<String,Object> config, String key, Class<T> enumClass) Returns a value of an enumeration that matches ignoring case the string obtained from the config with the given key.
<T extends Enum<T>> T	getEnum(String key, Class<T> enumClass)
String	getFirstEntry() returns the first entry(key) in the config file.
Map<String,Object>	getFirstMap() returns the first entry in the config file if it's a map.
static String	getGlobalProperty(String key)
static int	getInt(Map<String,Object> m, String key)
static int	getInt(Map<String,Object> m, String key, int defaultValue) return the m.get(key) as an int if it's present or v if it is not.
int	getInt(String key) int configs
int	getInt(String key, int defaultValue)
int	getInt(String key, String key1)
int	getInt(String key, String key1, int defaultValue)
Set<String>	getKeys()
static <T> List<T>	getList(Map<String,Object> m, String key)
<T> List<T>	getList(String key) List configs
static long	getLong(Map<String,Object> m, String key)
static long	getLong(Map<String,Object> m, String key, long v) return the m.get(key) as an long if it's present or v if it is not.
long	getLong(String key) long configs
long	getLong(String key, long defaultValue)
static Map<String,Object>	getMap(Map<String,Object> m, String key) Map configs
Map<String,Object>	getMap(String key) Deprecated.
String	getPath()
static YConfigurationResolver	getResolver()
Map<String,Object>	getRoot()
List<YConfiguration>	getServiceConfigList(String key) This is the same like the method above but will create a {class: "string"} for strings rather than throwing an exception.
static String	getString(Map m, String key) Returns m.get(key) if it exists and is of type string, otherwise throws an exception
static String	getString(Map m, String key, String defaultValue)
String	getString(String key)
String	getString(String key, String defaultValue)
<T> List<T>	getSubList(String key, String key1)
Map<String,Object>	getSubMap(String key, String key1)
String	getSubString(String key, String subkey)
static boolean	isDefined(String subsystem)
static boolean	isList(Map m, String key)
boolean	isList(String key)
static boolean	isNull(Map m, String key)
static void	setResolver(YConfigurationResolver resolver)
static void	setup() calls setup(null)
static void	setup(String configPrefix) If configPrefix is not null, sets up the configuration to search the classpath for files like "configPrefix/xyz.properties" Also sets up the TimeEncoding configuration
static void	setup(String configPrefix, String userConfigDirectory)
String	toJson()
static YConfiguration	wrap(Map<String,Object> m) Create a new configuration wrapping around a map The resulting config will have no parent

Methods inherited from class java.lang.Object

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

Constructor Detail

YConfiguration

public YConfiguration(String subsystem,
                      InputStream is,
                      String confpath)

Constructs a new configuration object parsing the input stream

Parameters:

is - - input stream where the configuration is loaded from

confpath - - configuration path - it is remembered together with the configuration in case of error to indicate where it is coming from (i.e. which file)

YConfiguration

public YConfiguration(YConfiguration parent,
                      String parentKey,
                      Map<String,Object> root)

Parameters:

parent -

parentKey -

root -

Method Detail

setup

public static void setup(String configPrefix)
                  throws ConfigurationException

If configPrefix is not null, sets up the configuration to search the classpath for files like "configPrefix/xyz.properties" Also sets up the TimeEncoding configuration

Parameters:

configPrefix -

Throws:

ConfigurationException

setup

public static void setup(String configPrefix,
                         String userConfigDirectory)

setup

public static void setup()
                  throws ConfigurationException

calls setup(null)

Throws:

ConfigurationException

getConfiguration

public static YConfiguration getConfiguration(String subsystem)
                                       throws ConfigurationException

Loads (if not already loaded) and returns a configuration corresponding to a file <subsystem>.yaml This method does not reload the configuration file if it has changed.

Parameters:

subsystem -

Returns:

the loaded configuration

Throws:

ConfigurationException - if the configuration file could not be found or not loaded (e.g. error in yaml formatting)

getConfiguration

public static YConfiguration getConfiguration(String subsystem,
                                              boolean reload)
                                       throws ConfigurationException

Loads and returns a configuration corresponding to a file <subsystem>.yaml This method reloads the configuration file always.

Parameters:

subsystem -

reload -

Returns:

the loaded configuration

Throws:

ConfigurationException - if the configuration file could not be found or not loaded (e.g. error in yaml formatting)

isDefined

public static boolean isDefined(String subsystem)
                         throws ConfigurationException

Throws:

ConfigurationException

isNull

public static boolean isNull(Map m,
                             String key)

getGlobalProperty

public static String getGlobalProperty(String key)

containsKey

public boolean containsKey(String key)

containsKey

public boolean containsKey(String key,
                           String key1)
                    throws ConfigurationException

Throws:

ConfigurationException

getFirstMap

public Map<String,Object> getFirstMap()
                               throws ConfigurationException

returns the first entry in the config file if it's a map. Otherwise throws an error

Throws:

ConfigurationException

getFirstEntry

public String getFirstEntry()
                     throws ConfigurationException

returns the first entry(key) in the config file.

Returns:

Throws:

ConfigurationException

getKeys

public Set<String> getKeys()

getRoot

public Map<String,Object> getRoot()

getConfig

public YConfiguration getConfig(String key)

If the key is pointing to a map, creates and returns a configuration object out of that map

The returned object will have its parent set to this object

Parameters:

key -

Returns:

getMap

public static Map<String,Object> getMap(Map<String,Object> m,
                                        String key)
                                 throws ConfigurationException

Map configs

Throws:

ConfigurationException

getMap

@Deprecated
public Map<String,Object> getMap(String key)
                                      throws ConfigurationException

Deprecated.

Please use getConfig(java.lang.String) to get a child config instead of accessing the map directly

Throws:

ConfigurationException

getSubMap

public Map<String,Object> getSubMap(String key,
                                    String key1)
                             throws ConfigurationException

Throws:

ConfigurationException

getString

public static String getString(Map m,
                               String key)
                        throws ConfigurationException

Returns m.get(key) if it exists and is of type string, otherwise throws an exception

Parameters:

m -

key -

Returns:

Throws:

ConfigurationException

getString

public static String getString(Map m,
                               String key,
                               String defaultValue)
                        throws ConfigurationException

Throws:

ConfigurationException

getString

public String getString(String key)
                 throws ConfigurationException

Throws:

ConfigurationException

getString

public String getString(String key,
                        String defaultValue)
                 throws ConfigurationException

Throws:

ConfigurationException

getSubString

public String getSubString(String key,
                           String subkey)
                    throws ConfigurationException

Throws:

ConfigurationException

getList

public <T> List<T> getList(String key)
                    throws ConfigurationException

List configs

Throws:

ConfigurationException

getConfigList

public List<YConfiguration> getConfigList(String key)
                                   throws ConfigurationException

Throws:

ConfigurationException

getDouble

public double getDouble(String key)
                 throws ConfigurationException

Throws:

ConfigurationException

getDouble

public double getDouble(String key,
                        double defaultValue)
                 throws ConfigurationException

Throws:

ConfigurationException

getServiceConfigList

public List<YConfiguration> getServiceConfigList(String key)
                                          throws ConfigurationException

This is the same like the method above but will create a {class: "string"} for strings rather than throwing an exception. It is to be used when loading service list which can be specified just by the class name.

Parameters:

key -

Returns:

Throws:

ConfigurationException

getSubList

public <T> List<T> getSubList(String key,
                              String key1)
                       throws ConfigurationException

Throws:

ConfigurationException

getBoolean

public static boolean getBoolean(Map<String,Object> m,
                                 String key,
                                 boolean defaultValue)
                          throws ConfigurationException

Returns m.get(key) if it exists and is of type boolean, if m.get(key) exists and is not boolean, throw an exception. if m.get(key) does not exist, return the default value.

Parameters:

m -

key -

defaultValue - - the default value to return if m.get(key) does not exist.

Returns:

the boolean config value

Throws:

ConfigurationException

getBoolean

public static boolean getBoolean(Map<String,Object> m,
                                 String key)
                          throws ConfigurationException

Throws:

ConfigurationException

getBoolean

public boolean getBoolean(String key)
                   throws ConfigurationException

Throws:

ConfigurationException

getBoolean

public boolean getBoolean(String key,
                          String key1)
                   throws ConfigurationException

Throws:

ConfigurationException

getBoolean

public boolean getBoolean(String key,
                          boolean defaultValue)

getInt

public int getInt(String key)
           throws ConfigurationException

int configs

Throws:

ConfigurationException

getInt

public int getInt(String key,
                  int defaultValue)
           throws ConfigurationException

Throws:

ConfigurationException

getInt

public int getInt(String key,
                  String key1)
           throws ConfigurationException

Throws:

ConfigurationException

getInt

public int getInt(String key,
                  String key1,
                  int defaultValue)
           throws ConfigurationException

Throws:

ConfigurationException

getInt

public static int getInt(Map<String,Object> m,
                         String key)
                  throws ConfigurationException

Throws:

ConfigurationException

getInt

public static int getInt(Map<String,Object> m,
                         String key,
                         int defaultValue)
                  throws ConfigurationException

return the m.get(key) as an int if it's present or v if it is not. If the key is present but the value is not an integer, a ConfigurationException is thrown.

Parameters:

m -

key -

defaultValue -

Returns:

the value from the map or the passed value if the map does not contain the key

Throws:

ConfigurationException - if the key is present but it's not an int

getLong

public long getLong(String key)

long configs

getLong

public long getLong(String key,
                    long defaultValue)

getLong

public static long getLong(Map<String,Object> m,
                           String key)
                    throws ConfigurationException

Throws:

ConfigurationException

getLong

public static long getLong(Map<String,Object> m,
                           String key,
                           long v)
                    throws ConfigurationException

return the m.get(key) as an long if it's present or v if it is not.

Parameters:

m -

key -

v -

Returns:

the value from the map or the passed value if the map does not contain the key

Throws:

ConfigurationException - if the key is present but it's not an long

getDouble

public static double getDouble(Map<String,Object> m,
                               String key,
                               double v)
                        throws ConfigurationException

Throws:

ConfigurationException

isList

public boolean isList(String key)

isList

public static boolean isList(Map m,
                             String key)

setResolver

public static void setResolver(YConfigurationResolver resolver)

getResolver

public static YConfigurationResolver getResolver()

getEnum

public <T extends Enum<T>> T getEnum(String key,
                                     Class<T> enumClass)

getEnum

public static <T extends Enum<T>> T getEnum(Map<String,Object> config,
                                            String key,
                                            Class<T> enumClass)

Returns a value of an enumeration that matches ignoring case the string obtained from the config with the given key. Throws an Configurationexception if the key does not exist in config or if it does not map to a valid enumeration value

Parameters:

config -

key -

enumClass -

Returns:

get

public Object get(String key)

Parameters:

key -

Returns:

root.get(key)

wrap

public static YConfiguration wrap(Map<String,Object> m)

Create a new configuration wrapping around a map The resulting config will have no parent

Parameters:

m -

Returns:

emptyConfig

public static YConfiguration emptyConfig()

toJson

public String toJson()

Returns:

json representation of the cconfiguration

getPath

public String getPath()

getList

public static <T> List<T> getList(Map<String,Object> m,
                                  String key)
                           throws ConfigurationException

Throws:

ConfigurationException