Package cc.carm.lib.configuration.source

Class ConfigurationFactory<SOURCE extends ConfigureSource<?,?,SOURCE>,HOLDER extends ConfigurationHolder<SOURCE>,SELF>

java.lang.Object

cc.carm.lib.configuration.source.ConfigurationFactory<SOURCE,HOLDER,SELF>

Type Parameters:

SOURCE - The ConfigureSource type

HOLDER - The ConfigurationHolder type.

SELF - Self builder, for further implement support.

public abstract class ConfigurationFactory<SOURCE extends ConfigureSource<?,?,SOURCE>,HOLDER extends ConfigurationHolder<SOURCE>,SELF>
extends Object

ConfigurationFactory, used to create configuration holder.

Field Summary

Fields

Modifier and Type	Field	Description
protected @NotNull ValueAdapterRegistry	adapters
protected @NotNull ConfigExceptionHandler	exceptionHandler
protected @NotNull ConfigurationInitializer	initializer
protected @NotNull Map<String,ConfigurationMetaHolder>	metadata
protected @NotNull ConfigurationOptionHolder	options

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ConfigurationFactory()

Method Summary

Modifier and Type	Method	Description
<T> SELF	adapter(@NotNull ValueAdapter<T> adapter)
<FROM, TO> SELF	adapter(@NotNull ValueType<FROM> from, @NotNull ValueType<TO> to, @NotNull DataFunction<FROM,TO> parser, @NotNull DataFunction<TO,FROM> serializer)
<T> SELF	adapter(@NotNull ValueType<T> type, @NotNull ValueParser<T> parser)
<T> SELF	adapter(@NotNull ValueType<T> type, @NotNull ValueSerializer<T> serializer)
<T> SELF	adapter(@NotNull ValueType<T> type, @NotNull ValueSerializer<T> serializer, @NotNull ValueParser<T> parser)
<FROM, TO> SELF	adapter(@NotNull Class<FROM> from, @NotNull Class<TO> to, @NotNull DataFunction<FROM,TO> parser, @NotNull DataFunction<TO,FROM> serializer)
<T> SELF	adapter(@NotNull Class<T> type, @NotNull ValueSerializer<T> serializer, @NotNull ValueParser<T> parser)
SELF	adapter(Consumer<ValueAdapterRegistry> adapterRegistryConsumer)
SELF	adapters(ValueAdapterRegistry adapters)
abstract HOLDER	build()	Build the configuration holder.
SELF	exceptionally(@NotNull ConfigExceptionHandler handler)
SELF	initializer(ConfigurationInitializer initializer)
SELF	initializer(Consumer<ConfigurationInitializer> initializerConsumer)
<M, A extends Annotation> SELF	metaAnnotation(@NotNull Class<A> annotation, @NotNull ConfigurationMetadata<M> metadata, @NotNull Function<A,M> extractor)	Register a new annotation for metadata to the configuration loader
SELF	metadata(@Nullable String path, @NotNull ConfigurationMetaHolder meta)
SELF	metadata(@Nullable String path, @NotNull Consumer<ConfigurationMetaHolder> handler)
SELF	metadata(@NotNull Map<String,ConfigurationMetaHolder> metadata)
SELF	metadata(@NotNull Consumer<Map<String,ConfigurationMetaHolder>> handler)
<O> SELF	option(ConfigurationOption<O> type, Consumer<O> modifier)
<O> SELF	option(ConfigurationOption<O> type, Supplier<O> value)
<O> SELF	option(ConfigurationOption<O> type, O value)
SELF	option(Consumer<ConfigurationOptionHolder> modifier)
SELF	options(ConfigurationOptionHolder options)
SELF	pathGenerator(PathGenerator generator)	Supply the base path generator for this configuration holder
protected abstract SELF	self()
<A extends Annotation> SELF	validAnnotation(@NotNull Class<A> annotation, @NotNull Function<A,ValueValidator<Object>> builder)	Register a new annotation for ValueValidator to the configuration loader

Methods inherited from class java.lang.Object

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

Field Details

adapters

@NotNull
protected @NotNull ValueAdapterRegistry adapters

options

@NotNull
protected @NotNull ConfigurationOptionHolder options

metadata

@NotNull
protected @NotNull Map<String,ConfigurationMetaHolder> metadata

initializer

@NotNull
protected @NotNull ConfigurationInitializer initializer

exceptionHandler

@NotNull
protected @NotNull ConfigExceptionHandler exceptionHandler

Constructor Details

ConfigurationFactory

protected ConfigurationFactory()

Method Details

self

protected abstract SELF self()

adapters

public SELF adapters(ValueAdapterRegistry adapters)

adapter

public SELF adapter(Consumer<ValueAdapterRegistry> adapterRegistryConsumer)

adapter

public <T> SELF adapter(@NotNull
 @NotNull ValueAdapter<T> adapter)

adapter

public <T> SELF adapter(@NotNull
 @NotNull ValueType<T> type,
 @NotNull
 @NotNull ValueSerializer<T> serializer)

adapter

public <T> SELF adapter(@NotNull
 @NotNull ValueType<T> type,
 @NotNull
 @NotNull ValueParser<T> parser)

adapter

public <FROM,
TO> SELF adapter(@NotNull
 @NotNull Class<FROM> from,
 @NotNull
 @NotNull Class<TO> to,
 @NotNull
 @NotNull DataFunction<FROM,TO> parser,
 @NotNull
 @NotNull DataFunction<TO,FROM> serializer)

adapter

public <FROM,
TO> SELF adapter(@NotNull
 @NotNull ValueType<FROM> from,
 @NotNull
 @NotNull ValueType<TO> to,
 @NotNull
 @NotNull DataFunction<FROM,TO> parser,
 @NotNull
 @NotNull DataFunction<TO,FROM> serializer)

adapter

public <T> SELF adapter(@NotNull
 @NotNull ValueType<T> type,
 @NotNull
 @NotNull ValueSerializer<T> serializer,
 @NotNull
 @NotNull ValueParser<T> parser)

adapter

public <T> SELF adapter(@NotNull
 @NotNull Class<T> type,
 @NotNull
 @NotNull ValueSerializer<T> serializer,
 @NotNull
 @NotNull ValueParser<T> parser)

options

public SELF options(ConfigurationOptionHolder options)

option

public SELF option(Consumer<ConfigurationOptionHolder> modifier)

option

public <O> SELF option(ConfigurationOption<O> type,
 O value)

option

public <O> SELF option(ConfigurationOption<O> type,
 Supplier<O> value)

option

public <O> SELF option(ConfigurationOption<O> type,
 Consumer<O> modifier)

metadata

public SELF metadata(@NotNull
 @NotNull Map<String,ConfigurationMetaHolder> metadata)

metadata

public SELF metadata(@NotNull
 @NotNull Consumer<Map<String,ConfigurationMetaHolder>> handler)

metadata

public SELF metadata(@Nullable
 @Nullable String path,
 @NotNull
 @NotNull ConfigurationMetaHolder meta)

metadata

public SELF metadata(@Nullable
 @Nullable String path,
 @NotNull
 @NotNull Consumer<ConfigurationMetaHolder> handler)

initializer

public SELF initializer(ConfigurationInitializer initializer)

initializer

public SELF initializer(Consumer<ConfigurationInitializer> initializerConsumer)

exceptionally

public SELF exceptionally(@NotNull
 @NotNull ConfigExceptionHandler handler)

pathGenerator

public SELF pathGenerator(PathGenerator generator)

Supply the base path generator for this configuration holder

Parameters:

generator - PathGenerator

Returns:

this

metaAnnotation

public <M,
A extends Annotation> SELF metaAnnotation(@NotNull
 @NotNull Class<A> annotation,
 @NotNull
 @NotNull ConfigurationMetadata<M> metadata,
 @NotNull
 @NotNull Function<A,M> extractor)

Register a new annotation for metadata to the configuration loader

Type Parameters:

M - The metadata type

A - The annotation type

Parameters:

annotation - The Annotation

metadata - The ConfigurationMetadata type

extractor - The Function to extract the metadata from the annotation

Returns:

this

validAnnotation

public <A extends Annotation> SELF validAnnotation(@NotNull
 @NotNull Class<A> annotation,
 @NotNull
 @NotNull Function<A,ValueValidator<Object>> builder)

Register a new annotation for ValueValidator to the configuration loader

Type Parameters:

A - The annotation type

Parameters:

annotation - The Annotation

builder - The Function to build the ValueValidator from the annotation

Returns:

this

build

@NotNull
public abstract HOLDER build()

Build the configuration holder.

Returns:

The configuration holder