net.morimekta.providence.config.impl

Class UpdatingConfigSupplier<M extends PMessage<M,F>,F extends PField>

java.lang.Object

net.morimekta.providence.config.impl.UpdatingConfigSupplier<M,F>

All Implemented Interfaces:

Supplier<M>, ConfigSupplier<M,F>

Direct Known Subclasses:

OverrideConfigSupplier, ProvidenceConfigSupplier, ReferenceConfigSupplier, TestConfigSupplier

public abstract class UpdatingConfigSupplier<M extends PMessage<M,F>,F extends PField>
extends Object
implements ConfigSupplier<M,F>

A supplier and instance holder for config objects. This supplier can be listened to for changes in the config object. When something triggers a change (supplier.set(config)) that will cause a config change call to each listener regardless of if the config values actually did change.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	UpdatingConfigSupplier() Initialize supplier with empty config.
protected	UpdatingConfigSupplier(Clock clock) Initialize supplier with empty config.

Method Summary

Modifier and Type	Method and Description
void	addListener(ConfigListener<M,F> listener) Add a listener to changes to this config.
long	configTimestamp() Get the last update time as a millisecond timestamp.
M	get()
void	removeListener(ConfigListener<M,F> listener) Remove a config change listener.
protected void	set(M config) Set a new config value to the supplier.

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.ConfigSupplier

getName, snapshot

Constructor Detail

UpdatingConfigSupplier

protected UpdatingConfigSupplier()

Initialize supplier with empty config.

UpdatingConfigSupplier

protected UpdatingConfigSupplier(Clock clock)

Initialize supplier with empty config.

Method Detail

get

@Nonnull
public final M get()

Specified by:

get in interface Supplier<M extends PMessage<M,F>>

addListener

public void addListener(ConfigListener<M,F> listener)

Description copied from interface: ConfigSupplier

Add a listener to changes to this config. Note that this will store a weak reference to the listener instance, so the one adding the listener must make sure the listener is not GC'd.

Specified by:

addListener in interface ConfigSupplier<M extends PMessage<M,F>,F extends PField>

Parameters:

listener - The config change listener to be added.

removeListener

public void removeListener(ConfigListener<M,F> listener)

Description copied from interface: ConfigSupplier

Remove a config change listener.

Specified by:

removeListener in interface ConfigSupplier<M extends PMessage<M,F>,F extends PField>

Parameters:

listener - The config change listener to be removed.

configTimestamp

public long configTimestamp()

Description copied from interface: ConfigSupplier

Get the last update time as a millisecond timestamp.

Specified by:

configTimestamp in interface ConfigSupplier<M extends PMessage<M,F>,F extends PField>

Returns:

The timestamp of last update of the config.

set

protected final void set(M config)

Set a new config value to the supplier. This is protected as it is usually up to the supplier implementation to enable updating the config at later stages.

Parameters:

config - The new config instance.