Module io.inverno.mod.configuration
Class CommandLineConfigurationSource
java.lang.Object
io.inverno.mod.configuration.internal.AbstractConfigurationSource<io.inverno.mod.configuration.internal.AbstractHashConfigurationSource.HashConfigurationQuery<String,CommandLineConfigurationSource>,io.inverno.mod.configuration.internal.AbstractHashConfigurationSource.HashExecutableConfigurationQuery<String,CommandLineConfigurationSource>,io.inverno.mod.configuration.internal.AbstractHashConfigurationSource.HashListConfigurationQuery<String,CommandLineConfigurationSource>,String,CommandLineConfigurationSource>
io.inverno.mod.configuration.internal.AbstractHashConfigurationSource<String,CommandLineConfigurationSource>
io.inverno.mod.configuration.source.CommandLineConfigurationSource
- All Implemented Interfaces:
ConfigurationSource,DefaultableConfigurationSource
public class CommandLineConfigurationSource
extends io.inverno.mod.configuration.internal.AbstractHashConfigurationSource<String,CommandLineConfigurationSource>
A configuration source that looks up properties from command line arguments.
Configuration properties are specified as application arguments using the following syntax (ABNF):
argument = "--" {@literal property_name} [ "[" *(parameter ",") "]" ] "=" property_value
property_name = java_name
property_value = java_integer_literal
/ java_floating_point_literal
/ java_string_literal
/ java_boolean_literal
/ "unset"
/ "null"
parameter = parameter_name "=" parameter_value
parameter_name = java_identifier
parameter_value = java_integer_literal
/ java_floating_point_literal
/ java_string_literal
/ java_boolean_literal
The following are valid configuration properties passed as command line arguments:
--web.server_port=8080--web.server_port[profile="ssl"]=8443--db.url[env="dev"]="jdbc:oracle:thin:@dev.db.server:1521:sid"--db.url[env="prod",zone="eu"]="jdbc:oracle:thin:@prod_eu.db.server:1521:sid"--db.url[env="prod",zone="us"]="jdbc:oracle:thin:@prod_us.db.server:1521:sid"
- Since:
- 1.0
- Author:
- Jeremy Kuhn
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class io.inverno.mod.configuration.internal.AbstractHashConfigurationSource
io.inverno.mod.configuration.internal.AbstractHashConfigurationSource.HashConfigurationQuery<A,B extends io.inverno.mod.configuration.internal.AbstractHashConfigurationSource<A, B>>, io.inverno.mod.configuration.internal.AbstractHashConfigurationSource.HashConfigurationQueryResult<A, B extends io.inverno.mod.configuration.internal.AbstractHashConfigurationSource<A, B>>, io.inverno.mod.configuration.internal.AbstractHashConfigurationSource.HashExecutableConfigurationQuery<A, B extends io.inverno.mod.configuration.internal.AbstractHashConfigurationSource<A, B>>, io.inverno.mod.configuration.internal.AbstractHashConfigurationSource.HashListConfigurationQuery<A, B extends io.inverno.mod.configuration.internal.AbstractHashConfigurationSource<A, B>> -
Field Summary
Fields inherited from class io.inverno.mod.configuration.internal.AbstractHashConfigurationSource
defaultingStrategyFields inherited from class io.inverno.mod.configuration.internal.AbstractConfigurationSource
decoder, defaultParameters, original -
Constructor Summary
ConstructorsConstructorDescriptionCommandLineConfigurationSource(String[] args) Creates a command line configuration source with the specified arguments using a Java String value decoder.CommandLineConfigurationSource(String[] args, SplittablePrimitiveDecoder<String> decoder) Creates a command line configuration source with the specified arguments and the specified string value decoder. -
Method Summary
Modifier and TypeMethodDescriptionprotected Mono<List<ConfigurationProperty>> load()Loads the configuration properties.withDefaultingStrategy(DefaultingStrategy defaultingStrategy) Returns a proxy of the defaultable configuration source instance using the specified defaulting strategy.withParameters(List<ConfigurationKey.Parameter> parameters) Defines parameters that specify the context in which configuration properties are to be retrieved.Methods inherited from class io.inverno.mod.configuration.internal.AbstractHashConfigurationSource
get, listMethods inherited from class io.inverno.mod.configuration.internal.AbstractConfigurationSource
getDecoder, setDecoder, unwrap, withParameters, withParameters, withParameters, withParameters, withParameters, withParameters, withParameters, withParameters, withParameters, withParameters, withParametersMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface io.inverno.mod.configuration.ConfigurationSource
unwrap, withParameters, withParameters, withParameters, withParameters, withParameters, withParameters, withParameters, withParameters, withParameters, withParameters, withParameters
-
Constructor Details
-
CommandLineConfigurationSource
Creates a command line configuration source with the specified arguments using a Java String value decoder.
- Parameters:
args- the command line arguments
-
CommandLineConfigurationSource
Creates a command line configuration source with the specified arguments and the specified string value decoder.
- Parameters:
args- the command line argumentsdecoder- a string decoder
-
-
Method Details
-
withParameters
public CommandLineConfigurationSource withParameters(List<ConfigurationKey.Parameter> parameters) throws IllegalArgumentException Description copied from interface:ConfigurationSourceDefines parameters that specify the context in which configuration properties are to be retrieved.
- Specified by:
withParametersin interfaceConfigurationSource- Specified by:
withParametersin classio.inverno.mod.configuration.internal.AbstractConfigurationSource<io.inverno.mod.configuration.internal.AbstractHashConfigurationSource.HashConfigurationQuery<String,CommandLineConfigurationSource>, io.inverno.mod.configuration.internal.AbstractHashConfigurationSource.HashExecutableConfigurationQuery<String, CommandLineConfigurationSource>, io.inverno.mod.configuration.internal.AbstractHashConfigurationSource.HashListConfigurationQuery<String, CommandLineConfigurationSource>, String, CommandLineConfigurationSource> - Parameters:
parameters- a list of parameters- Returns:
- the executable configuration query
- Throws:
IllegalArgumentException- if parameters were specified more than once
-
withDefaultingStrategy
Description copied from interface:DefaultableConfigurationSourceReturns a proxy of the defaultable configuration source instance using the specified defaulting strategy.
- Parameters:
defaultingStrategy- a defaulting strategy- Returns:
- a new defaultable configuration source
-
load
Description copied from class:io.inverno.mod.configuration.internal.AbstractHashConfigurationSourceLoads the configuration properties.
- Specified by:
loadin classio.inverno.mod.configuration.internal.AbstractHashConfigurationSource<String,CommandLineConfigurationSource> - Returns:
- A mono emitting the list of configuration properties
-