net.morimekta.providence.config

Class ProvidenceConfig

java.lang.Object

net.morimekta.providence.config.ProvidenceConfig

All Implemented Interfaces:

ConfigResolver

public class ProvidenceConfig
extends Object
implements ConfigResolver

Providence config loader. This loads providence configs.

Constructor Summary

Constructors

Constructor and Description
ProvidenceConfig(TypeRegistry registry) Make a non-strict config instance.
ProvidenceConfig(TypeRegistry registry, net.morimekta.util.FileWatcher watcher, boolean strict) Make a config instance.
ProvidenceConfig(TypeRegistry registry, net.morimekta.util.FileWatcher watcher, boolean strict, Clock clock) Make a config instance.

Method Summary

Modifier and Type	Method and Description
<M extends PMessage<M,F>,F extends PField> M	getConfig(File configFile) Get config for the given file.
<M extends PMessage<M,F>,F extends PField> M	getConfig(File configFile, M parent) Get config for the given with parent.
<M extends PMessage<M,F>,F extends PField> ConfigSupplier<M,F>	resolveConfig(File configFile, ConfigSupplier<M,F> parentConfig) Resolve a config file like on config file includes.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.morimekta.providence.config.ConfigResolver

resolveConfig

Constructor Detail

ProvidenceConfig

public ProvidenceConfig(TypeRegistry registry)

Make a non-strict config instance.

Parameters:

registry - The type registry used to find message and enum types.

ProvidenceConfig

public ProvidenceConfig(@Nonnull
                        TypeRegistry registry,
                        @Nullable
                        net.morimekta.util.FileWatcher watcher,
                        boolean strict)

Make a config instance.

Parameters:

registry - The type registry used to find message and enum types.

watcher - File watcher used to detect config file updates.

strict - If the config should be parsed strictly.

ProvidenceConfig

public ProvidenceConfig(@Nonnull
                        TypeRegistry registry,
                        @Nullable
                        net.morimekta.util.FileWatcher watcher,
                        boolean strict,
                        @Nonnull
                        Clock clock)

Make a config instance.

Parameters:

registry - The type registry used to find message and enum types.

watcher - File watcher used to detect config file updates.

strict - If the config should be parsed strictly.

clock - The clock to use in timing config loads.

Method Detail

resolveConfig

@Nonnull
public <M extends PMessage<M,F>,F extends PField> ConfigSupplier<M,F> resolveConfig(@Nonnull
                                                                                             File configFile,
                                                                                             @Nullable
                                                                                             ConfigSupplier<M,F> parentConfig)
                                                                                      throws ProvidenceConfigException

Description copied from interface: ConfigResolver

Resolve a config file like on config file includes.

Specified by:

resolveConfig in interface ConfigResolver

Type Parameters:

M - The message type.

F - The message field type.

Parameters:

configFile - The file to resolve.

parentConfig - The parent config supplier if any.

Returns:

The resolved config.

Throws:

ProvidenceConfigException - If parsing of config failed.

getConfig

@Nonnull
public <M extends PMessage<M,F>,F extends PField> M getConfig(@Nonnull
                                                                       File configFile)
                                                                throws ProvidenceConfigException

Get config for the given file.

Type Parameters:

M - The config message type.

F - The config message field type.

Parameters:

configFile - The file to read config for.

Returns:

The config message.

Throws:

ProvidenceConfigException - On config load failure.

getConfig

@Nonnull
public <M extends PMessage<M,F>,F extends PField> M getConfig(@Nonnull
                                                                       File configFile,
                                                                       @Nonnull
                                                                       M parent)
                                                                throws ProvidenceConfigException

Get config for the given with parent.

Type Parameters:

M - The config message type.

F - The config message field type.

Parameters:

configFile - The file to read config for.

parent - The designated parent config.

Returns:

The config message.

Throws:

ProvidenceConfigException - On config load failure.