Merge 2 configurations.
Returns every path as a set of key to value pairs, by recursively iterating through the config objects.
Retrieves a configuration value as a Boolean
.
Retrieves a configuration value as a Boolean
.
For example:
val configuration = Configuration.load() val isEnabled = configuration.getBoolean("engine.isEnabled")
A configuration error will be thrown if the configuration value is not a valid Boolean
.
Authorized values are yes
/no
or true
/false
.
the configuration key, relative to the configuration root key
a configuration value
Retrieves a configuration value as a List of Boolean
.
Retrieves a configuration value as a List of Boolean
.
For example:
val configuration = Configuration.load() val switches = configuration.getBooleanList("board.switches")
The configuration must be provided as:
board.switches = [true, true, false]
A configuration error will be thrown if the configuration value is not a valid Boolean
.
Authorized values are yes
/no
or true
/false
.
Retrieves a configuration value as a Seq of Boolean
.
Retrieves a configuration value as a Seq of Boolean
.
For example:
val configuration = Configuration.load() val switches = configuration.getBooleanSeq("board.switches")
The configuration must be provided as:
board.switches = [true, true, false]
A configuration error will be thrown if the configuration value is not a valid Boolean
.
Authorized values are yes
/no
or true
/false
.
Retrieves a configuration value as Bytes
.
Retrieves a configuration value as Bytes
.
For example:
val configuration = Configuration.load() val maxSize = configuration.getString("engine.maxSize")
The configuration must be provided as:
engine.maxSize = 512k
Retrieves a configuration value as a List of Bytes
.
Retrieves a configuration value as a List of Bytes
.
For example:
val configuration = Configuration.load() val maxSizes = configuration.getBytesList("engine.maxSizes")
The configuration must be provided as:
engine.maxSizes = [512k, 256k, 256k]
Retrieves a configuration value as a Seq of Bytes
.
Retrieves a configuration value as a Seq of Bytes
.
For example:
val configuration = Configuration.load() val maxSizes = configuration.getBytesSeq("engine.maxSizes")
The configuration must be provided as:
engine.maxSizes = [512k, 256k, 256k]
Retrieves a sub-configuration, i.e.
Retrieves a sub-configuration, i.e. a configuration instance containing all keys starting with a given prefix.
For example:
val configuration = Configuration.load() val engineConfig = configuration.getConfig("engine")
The root key of this new configuration will be ‘engine’, and you can access any sub-keys relatively.
the root prefix for this sub-configuration
a new configuration
Retrieves a List of sub-configurations, i.e.
Retrieves a List of sub-configurations, i.e. a configuration instance for each key that matches the path.
For example:
val configuration = Configuration.load() val engineConfigs = configuration.getConfigList("engine")
The root key of this new configuration will be "engine", and you can access any sub-keys relatively.
Retrieves a Seq of sub-configurations, i.e.
Retrieves a Seq of sub-configurations, i.e. a configuration instance for each key that matches the path.
For example:
val configuration = Configuration.load() val engineConfigs = configuration.getConfigSeq("engine")
The root key of this new configuration will be "engine", and you can access any sub-keys relatively.
Retrieves a configuration value as a Double
.
Retrieves a configuration value as a Double
.
For example:
val configuration = Configuration.load() val population = configuration.getDouble("world.population")
A configuration error will be thrown if the configuration value is not a valid Double
.
the configuration key, relative to the configuration root key
a configuration value
Retrieves a configuration value as a List of Double
.
Retrieves a configuration value as a List of Double
.
For example:
val configuration = Configuration.load() val maxSizes = configuration.getDoubleList("engine.maxSizes")
The configuration must be provided as:
engine.maxSizes = [5.0, 3.34, 2.6]
Retrieves a configuration value as a Seq of Double
.
Retrieves a configuration value as a Seq of Double
.
For example:
val configuration = Configuration.load() val maxSizes = configuration.getDoubleSeq("engine.maxSizes")
The configuration must be provided as:
engine.maxSizes = [5.0, 3.34, 2.6]
Retrieves a configuration value as an Int
.
Retrieves a configuration value as an Int
.
For example:
val configuration = Configuration.load() val poolSize = configuration.getInt("engine.pool.size")
A configuration error will be thrown if the configuration value is not a valid Int
.
the configuration key, relative to the configuration root key
a configuration value
Retrieves a configuration value as a List of Integer
.
Retrieves a configuration value as a List of Integer
.
For example:
val configuration = Configuration.load() val maxSizes = configuration.getIntList("engine.maxSizes")
The configuration must be provided as:
engine.maxSizes = [100, 500, 2]
Retrieves a configuration value as a Seq of Integer
.
Retrieves a configuration value as a Seq of Integer
.
For example:
val configuration = Configuration.load() val maxSizes = configuration.getIntSeq("engine.maxSizes")
The configuration must be provided as:
engine.maxSizes = [100, 500, 2]
Gets a list value (with any element type) as a ConfigList, which implements java.util.List<ConfigValue>.
Gets a list value (with any element type) as a ConfigList, which implements java.util.List<ConfigValue>.
For example:
val configuration = Configuration.load() val maxSizes = configuration.getList("engine.maxSizes")
The configuration must be provided as:
engine.maxSizes = ["foo", "bar"]
Retrieves a configuration value as a Long
.
Retrieves a configuration value as a Long
.
For example:
val configuration = Configuration.load() val duration = configuration.getLong("timeout.duration")
A configuration error will be thrown if the configuration value is not a valid Long
.
the configuration key, relative to the configuration root key
a configuration value
Retrieves a configuration value as a List of Long
.
Retrieves a configuration value as a List of Long
.
For example:
val configuration = Configuration.load() val maxSizes = configuration.getLongList("engine.maxSizes")
The configuration must be provided as:
engine.maxSizes = [10000000000000, 500, 2000]
Retrieves a configuration value as a Seq of Long
.
Retrieves a configuration value as a Seq of Long
.
For example:
val configuration = Configuration.load() val maxSizes = configuration.getLongSeq("engine.maxSizes")
The configuration must be provided as:
engine.maxSizes = [10000000000000, 500, 2000]
Retrieves a configuration value as Milliseconds
.
Retrieves a configuration value as Milliseconds
.
For example:
val configuration = Configuration.load() val timeout = configuration.getMilliseconds("engine.timeout")
The configuration must be provided as:
engine.timeout = 1 second
Retrieves a configuration value as List of Milliseconds
.
Retrieves a configuration value as List of Milliseconds
.
For example:
val configuration = Configuration.load() val timeouts = configuration.getMillisecondsList("engine.timeouts")
The configuration must be provided as:
engine.timeouts = [1 second, 1 second]
Retrieves a configuration value as Seq of Milliseconds
.
Retrieves a configuration value as Seq of Milliseconds
.
For example:
val configuration = Configuration.load() val timeouts = configuration.getMillisecondsSeq("engine.timeouts")
The configuration must be provided as:
engine.timeouts = [1 second, 1 second]
Retrieves a configuration value as Nanoseconds
.
Retrieves a configuration value as Nanoseconds
.
For example:
val configuration = Configuration.load() val timeout = configuration.getNanoseconds("engine.timeout")
The configuration must be provided as:
engine.timeout = 1 second
Retrieves a configuration value as List of Nanoseconds
.
Retrieves a configuration value as List of Nanoseconds
.
For example:
val configuration = Configuration.load() val timeouts = configuration.getNanosecondsList("engine.timeouts")
The configuration must be provided as:
engine.timeouts = [1 second, 1 second]
Retrieves a configuration value as Seq of Nanoseconds
.
Retrieves a configuration value as Seq of Nanoseconds
.
For example:
val configuration = Configuration.load() val timeouts = configuration.getNanosecondsSeq("engine.timeouts")
The configuration must be provided as:
engine.timeouts = [1 second, 1 second]
Retrieves a configuration value as a Number
.
Retrieves a configuration value as a Number
.
For example:
val configuration = Configuration.load() val counter = configuration.getNumber("foo.counter")
A configuration error will be thrown if the configuration value is not a valid Number
.
the configuration key, relative to the configuration root key
a configuration value
Retrieves a configuration value as a List of Number
.
Retrieves a configuration value as a List of Number
.
For example:
val configuration = Configuration.load() val maxSizes = configuration.getNumberList("engine.maxSizes")
The configuration must be provided as:
engine.maxSizes = [50, 500, 5000]
Retrieves a configuration value as a Seq of Number
.
Retrieves a configuration value as a Seq of Number
.
For example:
val configuration = Configuration.load() val maxSizes = configuration.getNumberSeq("engine.maxSizes")
The configuration must be provided as:
engine.maxSizes = [50, 500, 5000]
Retrieves a ConfigObject for this path, which implements Map<String,ConfigValue>
Retrieves a ConfigObject for this path, which implements Map<String,ConfigValue>
For example:
val configuration = Configuration.load() val engineProperties = configuration.getObject("engine.properties")
The configuration must be provided as:
engine.properties = {id: 1, power: 5}
Retrieves a configuration value as a List of ConfigObject
.
Retrieves a configuration value as a List of ConfigObject
.
For example:
val configuration = Configuration.load() val engineProperties = configuration.getObjectList("engine.properties")
The configuration must be provided as:
engine.properties = [{id: 5, power: 3}, {id: 6, power: 20}]
Retrieves a configuration value as a String
.
Retrieves a configuration value as a String
.
This method supports an optional set of valid values:
val config = Configuration.load() val mode = config.getString("engine.mode", Some(Set("dev","prod")))
A configuration error will be thrown if the configuration value does not match any of the required values.
the configuration key, relative to configuration root key
valid values for this configuration
a configuration value
Retrieves a configuration value as a List of String
.
Retrieves a configuration value as a List of String
.
For example:
val configuration = Configuration.load() val names = configuration.getStringList("names")
The configuration must be provided as:
names = ["Jim", "Bob", "Steve"]
Retrieves a configuration value as a Seq of String
.
Retrieves a configuration value as a Seq of String
.
For example:
val configuration = Configuration.load() val names = configuration.getStringSeq("names")
The configuration must be provided as:
names = ["Jim", "Bob", "Steve"]
Creates a configuration error for this configuration.
Creates a configuration error for this configuration.
For example:
val configuration = Configuration.load() throw configuration.globalError("Missing configuration key: [yop.url]")
the error message
the related exception
a configuration exception
Returns available keys.
Returns available keys.
For example:
val configuration = Configuration.load() val keys = configuration.keys
the set of keys available in this configuration
Creates a configuration error for a specific configuration key.
Creates a configuration error for a specific configuration key.
For example:
val configuration = Configuration.load() throw configuration.reportError("engine.connectionUrl", "Cannot connect!")
the configuration key, related to this error
the error message
the related exception
a configuration exception
Returns sub-keys.
Returns sub-keys.
For example:
val configuration = Configuration.load() val subKeys = configuration.subKeys
the set of direct sub-keys available in this configuration
the underlying Config implementation
A full configuration set.
The underlying implementation is provided by https://github.com/typesafehub/config.
the underlying Config implementation