Module io.helidon.config.etcd

Package io.helidon.config.etcd

Class EtcdConfigSourceBuilder

java.lang.Object

io.helidon.config.AbstractSourceBuilder<B,U>

io.helidon.config.AbstractConfigSourceBuilder<EtcdConfigSourceBuilder,EtcdConfigSourceBuilder.EtcdEndpoint>

io.helidon.config.etcd.EtcdConfigSourceBuilder

All Implemented Interfaces:

Builder<EtcdConfigSourceBuilder,EtcdConfigSource>, ParsableSource.Builder<EtcdConfigSourceBuilder>, PollableSource.Builder<EtcdConfigSourceBuilder>, Source.Builder<EtcdConfigSourceBuilder>, WatchableSource.Builder<EtcdConfigSourceBuilder,EtcdConfigSourceBuilder.EtcdEndpoint>, Supplier<EtcdConfigSource>

public final class EtcdConfigSourceBuilder
extends AbstractConfigSourceBuilder<EtcdConfigSourceBuilder,EtcdConfigSourceBuilder.EtcdEndpoint>
implements PollableSource.Builder<EtcdConfigSourceBuilder>, WatchableSource.Builder<EtcdConfigSourceBuilder,EtcdConfigSourceBuilder.EtcdEndpoint>, ParsableSource.Builder<EtcdConfigSourceBuilder>, Builder<EtcdConfigSourceBuilder,EtcdConfigSource>

Etcd ConfigSource builder.

It allows to configure following properties:

• uri - etcd endpoint
• key - an etcd key that is associated to value with configuration
• version - an etcd API version
• mandatory - is existence of configuration resource mandatory (by default) or is optional?
• media-type - configuration content media type to be used to look for appropriate ConfigParser;
• parser - or directly set ConfigParser instance to be used to parse the source;

One of media-type and parser properties must be set to be clear how to parse the content. If both of them are set, then parser has precedence.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	EtcdConfigSourceBuilder.EtcdApi	EtcdApi determines which etcd API version will be used.
static class	EtcdConfigSourceBuilder.EtcdEndpoint	Etcd endpoint remote descriptor.

Field Summary

Fields

Modifier and Type	Field	Description
static final URI	DEFAULT_URI	Default Etcd endpoint (http://localhost:2379).
static final EtcdConfigSourceBuilder.EtcdApi	DEFAULT_VERSION	Default Etcd API version (EtcdConfigSourceBuilder.EtcdApi.v2).

Method Summary

Modifier and Type	Method	Description
EtcdConfigSourceBuilder	api(EtcdConfigSourceBuilder.EtcdApi version)	Etcd API version.
EtcdConfigSource	build()	Builds new instance of Etcd ConfigSource.
EtcdConfigSourceBuilder	changeWatcher(ChangeWatcher<EtcdConfigSourceBuilder.EtcdEndpoint> changeWatcher)	Configure a change watcher.
EtcdConfigSourceBuilder	config(Config metaConfig)	Configure builder from meta configuration.
EtcdConfigSourceBuilder	key(String key)	Etcd key with which the value containing the configuration is associated.
EtcdConfigSourceBuilder	mediaType(String mediaType)	Media type if this is a ParsableSource and explicit media type is configured.
EtcdConfigSourceBuilder	parser(ConfigParser parser)	A parser if this is a ParsableSource and explicit parser is configured.
EtcdConfigSourceBuilder	pollingStrategy(PollingStrategy pollingStrategy)	Configure a polling strategy.
EtcdConfigSourceBuilder	uri(URI... uris)	Etcd endpoint remote URI.

Methods inherited from class io.helidon.config.AbstractConfigSourceBuilder

mediaTypeMapping, parserMapping

Methods inherited from class io.helidon.config.AbstractSourceBuilder

optional, retryPolicy

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.helidon.common.Builder

get, identity, update

Methods inherited from interface io.helidon.config.spi.PollableSource.Builder

pollingStrategy

Methods inherited from interface io.helidon.config.spi.Source.Builder

optional, optional, retryPolicy

Field Details

DEFAULT_VERSION

public static final EtcdConfigSourceBuilder.EtcdApi DEFAULT_VERSION

Default Etcd API version (EtcdConfigSourceBuilder.EtcdApi.v2).

DEFAULT_URI

public static final URI DEFAULT_URI

Default Etcd endpoint (http://localhost:2379).

Method Details

build

public EtcdConfigSource build()

Builds new instance of Etcd ConfigSource.

Specified by:

build in interface Builder<EtcdConfigSourceBuilder,EtcdConfigSource>

Returns:

new instance of Etcd ConfigSource.

config

public EtcdConfigSourceBuilder config(Config metaConfig)

Configure builder from meta configuration.

The following configuration options are supported:

Optional configuration parameters

key	default value	description
optional	false	Configure to true if this source should not fail configuration setup when underlying data is missing.
polling-strategy	No polling strategy is added by default	Meta configuration of a polling strategy to be used with this source, add configuration to properties sub node.
change-watcher	No change watcher is added by default	Meta configuration of a change watcher to be used with this source, add configuration to properties sub node.
retry-policy	No retry policy is added by default	Meta configuration of a retry policy to be used to load this source, add configuration to properties sub node.

Media type and type mapping

media-type	Media type from loaded data is used by default for parsable config sources	Explicit media type to use, such as when a file has invalid suffix, or when we need to explicitly mark the media type.
media-type-mapping	No media type mapping is done by default	A mapping of key to a media type, allowing us to have a key that contains a sub-tree (e.g. a key that contains json data) - when we configure a mapping of the key to application/json, the data would be expanded into config as a proper tree structure

• uri - type URI - Etcd instance remote URI
• key - type String - Etcd key the configuration is associated with
• api - type EtcdConfigSourceBuilder.EtcdApi - Etcd API version such as v3

Optional properties: see config(Config).

Overrides:

config in class AbstractConfigSourceBuilder<EtcdConfigSourceBuilder,EtcdConfigSourceBuilder.EtcdEndpoint>

Parameters:

metaConfig - meta-configuration used to update the builder instance from

Returns:

updated builder instance

See Also:

• config(Config)

parser

public EtcdConfigSourceBuilder parser(ConfigParser parser)

Description copied from class: AbstractConfigSourceBuilder

A parser if this is a ParsableSource and explicit parser is configured.

Specified by:

parser in interface ParsableSource.Builder<EtcdConfigSourceBuilder>

Overrides:

parser in class AbstractConfigSourceBuilder<EtcdConfigSourceBuilder,EtcdConfigSourceBuilder.EtcdEndpoint>

Parameters:

parser - parser configured for this source

Returns:

updated builder instance

mediaType

public EtcdConfigSourceBuilder mediaType(String mediaType)

Description copied from class: AbstractConfigSourceBuilder

Media type if this is a ParsableSource and explicit media type is configured.

Specified by:

mediaType in interface ParsableSource.Builder<EtcdConfigSourceBuilder>

Overrides:

mediaType in class AbstractConfigSourceBuilder<EtcdConfigSourceBuilder,EtcdConfigSourceBuilder.EtcdEndpoint>

Parameters:

mediaType - media type configured for this source

Returns:

updated builder instance

pollingStrategy

public EtcdConfigSourceBuilder pollingStrategy(PollingStrategy pollingStrategy)

Description copied from class: AbstractSourceBuilder

Configure a polling strategy. This method must be exposed by builders of sources that support polling. If you see this method as being protected in your builder, the source has removed support for polling, such as ClasspathConfigSource.

Specified by:

pollingStrategy in interface PollableSource.Builder<EtcdConfigSourceBuilder>

Overrides:

pollingStrategy in class AbstractSourceBuilder<EtcdConfigSourceBuilder,EtcdConfigSourceBuilder.EtcdEndpoint>

Parameters:

pollingStrategy - polling strategy to use

Returns:

updated builder instance

changeWatcher

public EtcdConfigSourceBuilder changeWatcher(ChangeWatcher<EtcdConfigSourceBuilder.EtcdEndpoint> changeWatcher)

Description copied from class: AbstractSourceBuilder

Configure a change watcher. This method must be exposed by builders of sources that change watching (WatchableSource). The type of the change watcher must match the type of the target of this source.

Specified by:

changeWatcher in interface WatchableSource.Builder<EtcdConfigSourceBuilder,EtcdConfigSourceBuilder.EtcdEndpoint>

Overrides:

changeWatcher in class AbstractSourceBuilder<EtcdConfigSourceBuilder,EtcdConfigSourceBuilder.EtcdEndpoint>

Parameters:

changeWatcher - change watcher to use, such as FileSystemWatcher

Returns:

updated builder instance

uri

public EtcdConfigSourceBuilder uri(URI... uris)

Etcd endpoint remote URI.

Parameters:

uris - endpoint URIs

Returns:

updated builder instance

key

public EtcdConfigSourceBuilder key(String key)

Etcd key with which the value containing the configuration is associated.

Parameters:

key - key

Returns:

updated builder instance

api

public EtcdConfigSourceBuilder api(EtcdConfigSourceBuilder.EtcdApi version)

Etcd API version.

Parameters:

version - version, defaults to EtcdConfigSourceBuilder.EtcdApi.v3

Returns:

updated builder instance