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.Polled
components.Similar to aPollingStrategy
a 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.ObjectNode
directly, with no need for parsing.Fluent API builder forConfigContent.NodeContent
.A content of anOverrideSource
.Fluent API builder forConfigContent
.Context created by aConfig.Builder
as it constructs aConfig
.Filter that can transform elementary configuration (String
) values before they are returned via theConfig
API.Config mapper is provided toConfigMapperProvider
to help transformation of complex structures.Provides mapping functions that convert aConfig
subtree to specific Java types.Marker interface identifying a config node implementation.ConfigNode-based list of configuration values.Builder to buildConfigNode.ListNode
instance.Base types of config nodes.Configuration node representing a hierarchical structure parsed by a suitableConfigParser
if necessary.Builder to buildConfigNode.ObjectNode
instance.Single string-based configuration value.Transforms configConfigParser.Content
into aConfigNode.ObjectNode
that 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.Source
of 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.ObjectNode
root nodes into a singleConfigNode.ObjectNode
root 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 aConfig
tree, as accessed throughPollableSource
s.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 aChangeWatcher
can use.A builder for a watchable source.