Module io.helidon.config
Package io.helidon.config.spi
package io.helidon.config.spi
Configuration SPI that defines the behavior developers can implement to extend the config system.
The most likely developer-implemented extension points:
| Interface | Purpose |
|---|---|
ConfigSource |
Loads configuration data from a type of source. |
ConfigParser |
Converts configuration data into a ConfigNode.ObjectNode. |
ConfigFilter |
Filters configuration values after they have been read from a
ConfigSource but before they are used in building a
Config tree. |
ConfigMapperProvider |
Converts Config nodes or subtrees to Java types. See
ConfigMappers for the built-in mappers. |
OverrideSource |
Replaces values pf config nodes whose keys match specified conditions with alternative values. |
PollingStrategy |
Notifies interested code when the data underlying a Source might
have changed. |
RetryPolicy |
Controls if and how a Source attempts to retry failed attempts to
load the underlying data. |
- See Also:
-
ClassDescriptionType of changes that can happen in a
PollingStrategy.Polledcomponents.Similar to aPollingStrategya change watcher is used to identify a change and trigger reload of aConfigSource.A change event, carrying the target, type of change and time of change.Java service loader service to create a polling strategy factory based on meta configuration.Config content as provided by a config source that can read all its data at once (an "eager" config source).ConfigContent.Builder<T extends ConfigContent.Builder<T>>Fluent API builder forConfigContent, common ancestor for parsable content builder and node content builder.Config content that provides anConfigNode.ObjectNodedirectly, with no need for parsing.Fluent API builder forConfigContent.NodeContent.A content of anOverrideSource.Fluent API builder forConfigContent.Context created by aConfig.Builderas it constructs aConfig.Filter that can transform elementary configuration (String) values before they are returned via theConfigAPI.Config mapper is provided toConfigMapperProviderto help transformation of complex structures.Provides mapping functions that convert aConfigsubtree to specific Java types.Marker interface identifying a config node implementation.ConfigNode-based list of configuration values.Builder to buildConfigNode.ListNodeinstance.Base types of config nodes.Configuration node representing a hierarchical structure parsed by a suitableConfigParserif necessary.Builder to buildConfigNode.ObjectNodeinstance.Single string-based configuration value.Transforms configConfigParser.Contentinto aConfigNode.ObjectNodethat represents the original structure and values from the content.Config content to be parsed by aConfigParser.Fluent API builder forConfigParser.Content.Root class for exceptions thrown during config parsing.Sourceof configuration.Java service loader service to provide a config source based on meta configuration.A source that supports notifications when changed.A source that is not capable of loading all keys at once.An algorithm for combining multipleConfigNode.ObjectNoderoot nodes into a singleConfigNode.ObjectNoderoot node.An eager source that can read all data from the underlying origin as a configuration node.Source of config override settings.Group of config override settings.Java service loader service to provide a override source based on meta configuration.An eager source that can read all data from the underlying origin as a stream that can be parsed based on its media type (or using an explicitConfigParser.ParsableSource.Builder<B extends ParsableSource.Builder<B>>A builder for a parsable source.A source implementing this interface provides support for polling using aPollingStrategy.PollableSource.Builder<T extends PollableSource.Builder<T>>A builder for pollable source.Mechanism for notifying interested listeners when they should check for changes that might have been made to the data used to create aConfigtree, as accessed throughPollableSources.A polled component.Java service loader service to create a polling strategy factory based on meta configuration.Mechanism for controlling retry of attempts to load data by aConfigSource.Java service loader service to create retry policy based on meta configuration.Source of data.Source.Builder<B extends Source.Builder<B>>Configurable options of aSource.A source implementing this interface provides a target that aChangeWatchercan use.A builder for a watchable source.