Package io.helidon.config

Provides interfaces and classes for loading and working with immutable, tree-structured configuration data.

See: Description

Interface Summary

Interface	Description
Config	Immutable tree-structured configuration.
Config.Builder	Config Builder.
Config.Context	Context associated with specific Config node that allows to access the last loaded instance of the node or to request reloading of whole configuration.
Config.Key	Object represents fully-qualified key of config node.
Config.Value.None	Class that represents not-set default values.
ConfigMapper<T>	Contextual mapper of a configuration hierarchy to a Java type.
ConfigSources.MergingStrategy	An algorithm for combining multiple ConfigNode.ObjectNode root nodes into a single ConfigNode.ObjectNode root node.

Class Summary

Class	Description
ConfigFilters	Class provides access to built-in ConfigFilter implementations.
ConfigFilters.ValueResolvingBuilder	A builder for value reference resolving filter.
ConfigHelper	Common Configuration utilities.
ConfigMappers	Utility methods for converting configuration to Java types.
ConfigParsers	Provides access to built-in ConfigParser implementations.
ConfigSources	Provides access to built-in ConfigSource implementations.
ConfigSources.CompositeBuilder	Builder of a ConfigSource that encapsulates multiple separate ConfigSources.
ConfigSources.MapBuilder	Builder of a ConfigSource based on a Map containing config entries.
OverrideSources	Class provides access to built-in OverrideSource implementations.
PollingStrategies	Built-in PollingStrategy implementations.
PollingStrategies.FilesystemWatchBuilder	A builder for a filesystem watch polling strategy.
PollingStrategies.ScheduledBuilder	A builder for a scheduled polling strategy.
RetryPolicies	Class provides access to built-in RetryPolicy implementations.
RetryPolicies.Builder	A builder of the default RetryPolicy.

Enum Summary

Enum	Description
Config.Type	Configuration node types.

Exception Summary

Exception	Description
ConfigException	Exception is thrown by Config implementations.
ConfigMappingException	Configuration value mapping exception.
MissingValueException	Exception representing a specific failures related to a missing configuration value.

Annotation Types Summary

Annotation Type	Description
Config.Transient	Annotation used to exclude JavaBean property, method or constructor from JavaBean deserialization support.
Config.Value	Annotation used to customize behaviour of JavaBean deserialization support, generic ConfigMapper implementation.

Package io.helidon.config Description

Provides interfaces and classes for loading and working with immutable, tree-structured configuration data.

Loading a Configuration

The program loads a configuration from either the default sources (using Config.create()) or from specified ConfigSources (using Config.Builder).

The default sources include all of the following, in order:

1. environment variables
2. Java system properties
3. the first of the following (if any) on the classpath:
   1. application.yaml
   2. application.conf (HOCON format)
   3. application.json
   4. application.properties

The config implementation supports sources in the above formats. The program can add support for other formats by implementing ConfigParser.

See Config for further information.

Using a Configuration Tree

This overview summarizes how a program can use loaded configuration. For full details see the Config class.

Once loaded, configuration information is available to the program as Config nodes in a tree. Each node has:

• a name,
• a Config.Key representing the full path from the root to the node, and
• some content.

The Config.type() method returns an enum value Config.Type that tells how the program should interpret the content of the node.

Type	Meaning	Useful Config Methods
VALUE	value node with an optional String value	value()
LIST	list of indexed nodes	asList, asStringList, asNodeList
OBJECT	object node with, possibly, child nodes	nodeList, asNodeList

Configuration Values and Types

While each VALUE node's value is accessible as an Optional<String>, the program can also have the node convert its String value to a boolean, int, long, double, a List of any of these, or an Optional of any of these.

The program can provide its own ConfigMapper implementations to deal with more complicated value mapping needs. See also Config.Builder.addMapper(java.lang.Class<T>, io.helidon.config.ConfigMapper<T>).

Navigation

The program can retrieve a node's child nodes as a List.

The program can navigate directly to a given subnode using the Config.get(java.lang.String) method and passing the dotted path to the subnode.

The Config.traverse() methods return a stream of nodes in depth-first order.

Bulk Retrieval of Values

The program can retrieve a Map of dotted names to String values for a node's entire subtree using Config.asMap().

Monitoring Changes

The program can react to configuration changes by passing a FunctionalInterface to Config.onChange(java.util.function.Function<io.helidon.config.Config, java.lang.Boolean>).

Converting Configuration to Java Types

The Config class provides many methods for converting config String values to Java primitives and simple Java types, as well as mapping parts of the config tree to Lists and Maps.

The application can convert config data to arbitrary types using the Config#as method, and can provide its own conversions to handle custom types by implementing the ConfigMapper interface and registering the mapper with a Config.Builder using the addMapper method.

If the Config.as method finds no matching registered mapper it will follow the logic described in the ConfigMapperManager class to try to map the configuration automatically.

See Also:

Configuration SPI