org.yamcs

Class YConfiguration

java.lang.Object

org.yamcs.YConfiguration

public class YConfiguration
extends Object

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.

Method Summary

Modifier and Type	Method and Description
boolean	containsKey(String key)
boolean	containsKey(String key, String key1)
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)
boolean	getBoolean(String key, String key1, String key2)
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.
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) int configs
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	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) List configs
<T> List<T>	getList(String key)
<T> List<T>	getList(String key, String key1)
<T> List<T>	getList(String key, String key1, String key2)
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.
static Map<String,Object>	getMap(Map<String,Object> m, String key) Map configs
Map<String,Object>	getMap(String key)
Map<String,Object>	getMap(String key, String key1)
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 subkey)
String	getString(String key, String key1, String key2)
static boolean	isDefined(String subsystem)
static boolean	isList(Map m, String key)
boolean	isList(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)

Methods inherited from class java.lang.Object

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

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

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()

getMap

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

Map configs

Throws:

ConfigurationException

getMap

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

Throws:

ConfigurationException

getMap

public Map<String,Object> getMap(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 subkey)
                 throws ConfigurationException

Throws:

ConfigurationException

getString

public String getString(String key,
                        String key1,
                        String key2)
                 throws ConfigurationException

Throws:

ConfigurationException

getList

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

Throws:

ConfigurationException

getList

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

List configs

Throws:

ConfigurationException

getList

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

Throws:

ConfigurationException

getList

public <T> List<T> getList(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,
                          String key1,
                          String key2)
                   throws ConfigurationException

Throws:

ConfigurationException

getBoolean

public boolean getBoolean(String key,
                          boolean defaultValue)

getInt

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

int configs

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 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

getInt

public int getInt(String key)
           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

isList

public boolean isList(String key)

isList

public static boolean isList(Map m,
                             String key)

setResolver

public static void setResolver(YConfigurationResolver resolver)