fr.sii.ogham.core.builder.context

Class EnvBuilderBasedContext

java.lang.Object

fr.sii.ogham.core.builder.context.EnvBuilderBasedContext

All Implemented Interfaces:

BuildContext

public class EnvBuilderBasedContext
extends Object
implements BuildContext

Context that uses a shared EnvironmentBuilder to evaluate the properties. The converter is the same as used by the EnvironmentBuilder.

This implementation delegates registration of instances to the provided registry. Any instance may be registered.

Author:

Aurélien Baudet

Constructor Summary

Constructors

Constructor and Description
EnvBuilderBasedContext(EnvironmentBuilder<?> environmentBuilder, Registry<Object> registry)

Method Summary

Modifier and Type	Method and Description
<T> T	evaluate(List<String> properties, Class<T> resultClass) Evaluate a list of properties that contains expressions.
Converter	getConverter() Access to the underlying Converter that is used for property value conversion.
PropertyResolver	getPropertyResolver() Access to the underlying PropertyResolver that is used for property resolution and evaluation.
<P,V,T extends ConfigurationValueBuilder<P,V>> T	newConfigurationValueBuilder(Function<BuildContext,T> factory) Create a new ConfigurationValueBuilder instance using a custom factory.
<P,V,T extends ConfigurationValueBuilder<P,V>> T	newConfigurationValueBuilder(P parent, Class<V> valueClass) Create a new ConfigurationValueBuilder instance associated to this BuildContext.
<T> T	register(T instance) Register an instance created by a builder.

Methods inherited from class java.lang.Object

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

Constructor Detail

EnvBuilderBasedContext

public EnvBuilderBasedContext(EnvironmentBuilder<?> environmentBuilder,
                              Registry<Object> registry)

Method Detail

register

public <T> T register(T instance)

Description copied from interface: BuildContext

Register an instance created by a builder. The instance is registered in a dedicated registry. The registry may be later used to handle registered instances. The registered instance may also be decorated at registration time.

Specified by:

register in interface BuildContext

Type Parameters:

T - the type of the registered instance (used for fluent chaining).

Parameters:

instance - the instance to register

Returns:

the registered instance

evaluate

public <T> T evaluate(List<String> properties,
                      Class<T> resultClass)

Description copied from interface: BuildContext

Evaluate a list of properties that contains expressions. It tries on first property in the list. If null value is returned then the next property is tried and so on until one property returns a non-null value.

If all properties return null, it returns null.

Specified by:

evaluate in interface BuildContext

Type Parameters:

T - the type of resulting value

Parameters:

properties - the list of properties to try in sequence

resultClass - the result class

Returns:

the resulting value or null

getPropertyResolver

public PropertyResolver getPropertyResolver()

Description copied from interface: BuildContext

Access to the underlying PropertyResolver that is used for property resolution and evaluation.

Specified by:

getPropertyResolver in interface BuildContext

Returns:

the property resolver

getConverter

public Converter getConverter()

Description copied from interface: BuildContext

Access to the underlying Converter that is used for property value conversion.

Specified by:

getConverter in interface BuildContext

Returns:

the converter

newConfigurationValueBuilder

public <P,V,T extends ConfigurationValueBuilder<P,V>> T newConfigurationValueBuilder(P parent,
                                                                                     Class<V> valueClass)

Description copied from interface: BuildContext

Create a new ConfigurationValueBuilder instance associated to this BuildContext.

Specified by:

newConfigurationValueBuilder in interface BuildContext

Type Parameters:

P - the type of the parent

V - the type of the value

T - the type of the ConfigurationValueBuilder

Parameters:

parent - the parent instance

valueClass - the class of the value

Returns:

the ConfigurationValueBuilder instance

newConfigurationValueBuilder

public <P,V,T extends ConfigurationValueBuilder<P,V>> T newConfigurationValueBuilder(Function<BuildContext,T> factory)

Description copied from interface: BuildContext

Create a new ConfigurationValueBuilder instance using a custom factory. The factory receives the current BuildContext instance in order to associate the ConfigurationValueBuilder with this BuildContext.

This can be useful for creating a derived instance instead of default one.

Specified by:

newConfigurationValueBuilder in interface BuildContext

Type Parameters:

P - the type of the parent

V - the type of the value

T - the type of the ConfigurationValueBuilder

Parameters:

factory - the factory used to create the instance

Returns:

the ConfigurationValueBuilder instance