me.zeroeightsix.fiber.builder

Class ConfigValueBuilder<T>

java.lang.Object

me.zeroeightsix.fiber.builder.ConfigValueBuilder<T>

Type Parameters:

T - the type of value the produced ConfigValue will hold

Direct Known Subclasses:

ConfigAggregateBuilder

public class ConfigValueBuilder<T>
extends java.lang.Object

A builder for scalar ConfigValues.

The settings created by this builder are considered atomic, and do not allow specifications at the component level. Settings with aggregate types, such as arrays and collections, should be created using ConfigAggregateBuilder.

See Also:

ConfigValue

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List<Constraint<? super T>>	constraintList
protected java.lang.Class<T>	type

Constructor Summary

Constructors

Constructor and Description
ConfigValueBuilder(java.lang.String name, java.lang.Class<T> type) Creates a new scalar ConfigValueBuilder.

Method Summary

Modifier and Type	Method and Description
ConfigValue<T>	build() Builds the ConfigValue.
ConstraintsBuilder<? extends ConfigValueBuilder<T>,T>	constraints() Creates a constraint builder for this ConfigValueBuilder.
ConfigValueBuilder<T>	setFinal() Marks a setting as final.
ConfigValueBuilder<T>	setFinal(boolean isFinal) Sets the finality.
ConfigValueBuilder<T>	withComment(java.lang.String comment) Sets the ConfigValue's comment.
ConfigValueBuilder<T>	withDefaultValue(T defaultValue) Sets the default value.
ConfigValueBuilder<T>	withListener(java.util.function.BiConsumer<T,T> consumer) Adds a listener to the ConfigValue.
ConfigValueBuilder<T>	withName(java.lang.String name) Sets the ConfigValue's name.
ConfigValueBuilder<T>	withParent(Node node) Sets the node that the ConfigValue will be registered to.

Methods inherited from class java.lang.Object

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

Field Detail

type

@Nonnull
protected final java.lang.Class<T> type

constraintList

protected java.util.List<Constraint<? super T>> constraintList

Constructor Detail

ConfigValueBuilder

public ConfigValueBuilder(@Nonnull
                          java.lang.String name,
                          @Nonnull
                          java.lang.Class<T> type)

Creates a new scalar ConfigValueBuilder.

Parameters:

name - the name of the ConfigValue produced by this builder

type - the class object representing the type of values this builder will create settings for

Method Detail

withName

public ConfigValueBuilder<T> withName(java.lang.String name)

Sets the ConfigValue's name.

If null, or if this method is never called, the ConfigValue won't have a name. Thus, it might be ignored during (de)serialisation. It also won't be able to be found by name in its parent node.

Parameters:

name - the name

Returns:

this builder

See Also:

Node.lookup(java.lang.String)

withComment

public ConfigValueBuilder<T> withComment(java.lang.String comment)

Sets the ConfigValue's comment.

If null, or if this method is never called, the ConfigValue won't have a comment. An empty comment (non null, but only consisting of whitespace) will be serialised.

Parameters:

comment - the comment

Returns:

this builder

withListener

public ConfigValueBuilder<T> withListener(java.util.function.BiConsumer<T,T> consumer)

Adds a listener to the ConfigValue.

Listeners are called when the value of a ConfigValue is changed. They are of type BiConsumer: the first argument being the old value, and the second argument being the new value.

Listeners set with this method are chained: if there was already one specified, a new listener is created that calls the old one first, and then the new one.

Parameters:

consumer - the listener

Returns:

this builder

withDefaultValue

public ConfigValueBuilder<T> withDefaultValue(T defaultValue)

Sets the default value.

If null, or if this method is never called, the ConfigValue will have no default value.

Parameters:

defaultValue - the default value

Returns:

this builder

setFinal

public ConfigValueBuilder<T> setFinal()

Marks a setting as final.

As a result of this method, any attempt to update the value of the resulting setting will fail. This method behaves as if: this.setFinal(true).

Returns:

this builder

See Also:

setFinal(boolean)

setFinal

public ConfigValueBuilder<T> setFinal(boolean isFinal)

Sets the finality.

If true, the produced setting can not be changed. It will be initialised with its default value, if there is one. Afterwards, it can not be changed again.

Parameters:

isFinal - the finality

Returns:

this builder

withParent

public ConfigValueBuilder<T> withParent(Node node)

Sets the node that the ConfigValue will be registered to.

Parameters:

node - The node the ConfigValue will be registered to.

Returns:

The builder

constraints

public ConstraintsBuilder<? extends ConfigValueBuilder<T>,T> constraints()

Creates a constraint builder for this ConfigValueBuilder.

Returns:

the created builder

See Also:

ConstraintsBuilder

build

public ConfigValue<T> build()

Builds the ConfigValue.

If a parent was specified using withParent(me.zeroeightsix.fiber.tree.Node), the ConfigValue will also be registered to its parent node.

Returns:

the ConfigValue