org.springframework.boot.context.properties.bind

Class Binder

java.lang.Object

org.springframework.boot.context.properties.bind.Binder

public class Binder
extends Object

A container object which Binds objects from one or more ConfigurationPropertySources.

Since:

2.0.0

Author:

Phillip Webb, Madhura Bhave

Constructor Summary

Constructors

Constructor and Description
Binder(ConfigurationPropertySource... sources) Create a new Binder instance for the specified sources.
Binder(Iterable<ConfigurationPropertySource> sources) Create a new Binder instance for the specified sources.
Binder(Iterable<ConfigurationPropertySource> sources, PlaceholdersResolver placeholdersResolver) Create a new Binder instance for the specified sources.
Binder(Iterable<ConfigurationPropertySource> sources, PlaceholdersResolver placeholdersResolver, ConversionService conversionService) Create a new Binder instance for the specified sources.
Binder(Iterable<ConfigurationPropertySource> sources, PlaceholdersResolver placeholdersResolver, ConversionService conversionService, Consumer<PropertyEditorRegistry> propertyEditorInitializer) Create a new Binder instance for the specified sources.

Method Summary

Modifier and Type	Method and Description
<T> BindResult<T>	bind(ConfigurationPropertyName name, Bindable<T> target) Bind the specified target Bindable using this binder's property sources.
<T> BindResult<T>	bind(ConfigurationPropertyName name, Bindable<T> target, BindHandler handler) Bind the specified target Bindable using this binder's property sources.
protected <T> T	bind(ConfigurationPropertyName name, Bindable<T> target, BindHandler handler, org.springframework.boot.context.properties.bind.Binder.Context context, boolean allowRecursiveBinding)
<T> BindResult<T>	bind(String name, Bindable<T> target) Bind the specified target Bindable using this binder's property sources.
<T> BindResult<T>	bind(String name, Bindable<T> target, BindHandler handler) Bind the specified target Bindable using this binder's property sources.
<T> BindResult<T>	bind(String name, Class<T> target) Bind the specified target Class using this binder's property sources.
static Binder	get(Environment environment) Create a new Binder instance from the specified environment.

Methods inherited from class java.lang.Object

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

Constructor Detail

Binder

public Binder(ConfigurationPropertySource... sources)

Create a new Binder instance for the specified sources. A DefaultFormattingConversionService will be used for all conversion.

Parameters:

sources - the sources used for binding

Binder

public Binder(Iterable<ConfigurationPropertySource> sources)

Create a new Binder instance for the specified sources. A DefaultFormattingConversionService will be used for all conversion.

Parameters:

sources - the sources used for binding

Binder

public Binder(Iterable<ConfigurationPropertySource> sources,
              PlaceholdersResolver placeholdersResolver)

Create a new Binder instance for the specified sources.

Parameters:

sources - the sources used for binding

placeholdersResolver - strategy to resolve any property placeholders

Binder

public Binder(Iterable<ConfigurationPropertySource> sources,
              PlaceholdersResolver placeholdersResolver,
              ConversionService conversionService)

Create a new Binder instance for the specified sources.

Parameters:

sources - the sources used for binding

placeholdersResolver - strategy to resolve any property placeholders

conversionService - the conversion service to convert values (or null to use ApplicationConversionService)

Binder

public Binder(Iterable<ConfigurationPropertySource> sources,
              PlaceholdersResolver placeholdersResolver,
              ConversionService conversionService,
              Consumer<PropertyEditorRegistry> propertyEditorInitializer)

Create a new Binder instance for the specified sources.

Parameters:

sources - the sources used for binding

placeholdersResolver - strategy to resolve any property placeholders

conversionService - the conversion service to convert values (or null to use ApplicationConversionService)

propertyEditorInitializer - initializer used to configure the property editors that can convert values (or null if no initialization is required). Often used to call ConfigurableBeanFactory.copyRegisteredEditorsTo(org.springframework.beans.PropertyEditorRegistry).

Method Detail

bind

public <T> BindResult<T> bind(String name,
                              Class<T> target)

Bind the specified target Class using this binder's property sources.

Type Parameters:

T - the bound type

Parameters:

name - the configuration property name to bind

target - the target class

Returns:

the binding result (never null)

See Also:

bind(ConfigurationPropertyName, Bindable, BindHandler)

bind

public <T> BindResult<T> bind(String name,
                              Bindable<T> target)

Bind the specified target Bindable using this binder's property sources.

Type Parameters:

T - the bound type

Parameters:

name - the configuration property name to bind

target - the target bindable

Returns:

the binding result (never null)

See Also:

bind(ConfigurationPropertyName, Bindable, BindHandler)

bind

public <T> BindResult<T> bind(ConfigurationPropertyName name,
                              Bindable<T> target)

Bind the specified target Bindable using this binder's property sources.

Type Parameters:

T - the bound type

Parameters:

name - the configuration property name to bind

target - the target bindable

Returns:

the binding result (never null)

See Also:

bind(ConfigurationPropertyName, Bindable, BindHandler)

bind

public <T> BindResult<T> bind(String name,
                              Bindable<T> target,
                              BindHandler handler)

Bind the specified target Bindable using this binder's property sources.

Type Parameters:

T - the bound type

Parameters:

name - the configuration property name to bind

target - the target bindable

handler - the bind handler (may be null)

Returns:

the binding result (never null)

bind

public <T> BindResult<T> bind(ConfigurationPropertyName name,
                              Bindable<T> target,
                              BindHandler handler)

Bind the specified target Bindable using this binder's property sources.

Type Parameters:

T - the bound type

Parameters:

name - the configuration property name to bind

target - the target bindable

handler - the bind handler (may be null)

Returns:

the binding result (never null)

bind

protected final <T> T bind(ConfigurationPropertyName name,
                           Bindable<T> target,
                           BindHandler handler,
                           org.springframework.boot.context.properties.bind.Binder.Context context,
                           boolean allowRecursiveBinding)

get

public static Binder get(Environment environment)

Create a new Binder instance from the specified environment.

Parameters:

environment - the environment source (must have attached ConfigurationPropertySources)

Returns:

a Binder instance