Package 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	Description
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, List<ConversionService> conversionServices, Consumer<PropertyEditorRegistry> propertyEditorInitializer, BindHandler defaultBindHandler, BindConstructorProvider constructorProvider)	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.
Binder(Iterable<ConfigurationPropertySource> sources, PlaceholdersResolver placeholdersResolver, ConversionService conversionService, Consumer<PropertyEditorRegistry> propertyEditorInitializer, BindHandler defaultBindHandler)	Create a new Binder instance for the specified sources.
Binder(Iterable<ConfigurationPropertySource> sources, PlaceholdersResolver placeholdersResolver, ConversionService conversionService, Consumer<PropertyEditorRegistry> propertyEditorInitializer, BindHandler defaultBindHandler, BindConstructorProvider constructorProvider)	Create a new Binder instance for the specified sources.
Binder(ConfigurationPropertySource... sources)	Create a new Binder instance for the specified sources.

Method Summary

Modifier and Type	Method	Description
<T> BindResult<T>	bind(String name, Class<T> target)	Bind the specified target Class using this binder's property sources.
<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(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.
<T> T	bindOrCreate(String name, Class<T> target)	Bind the specified target Class using this binder's property sources or create a new instance using the type of the Bindable if the result of the binding is null.
<T> T	bindOrCreate(String name, Bindable<T> target)	Bind the specified target Bindable using this binder's property sources or create a new instance using the type of the Bindable if the result of the binding is null.
<T> T	bindOrCreate(String name, Bindable<T> target, BindHandler handler)	Bind the specified target Bindable using this binder's property sources or create a new instance using the type of the Bindable if the result of the binding is null.
<T> T	bindOrCreate(ConfigurationPropertyName name, Bindable<T> target, BindHandler handler)	Bind the specified target Bindable using this binder's property sources or create a new instance using the type of the Bindable if the result of the binding is null.
static Binder	get(Environment environment)	Create a new Binder instance from the specified environment.
static Binder	get(Environment environment, BindHandler defaultBindHandler)	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 Details

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

Binder

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

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

defaultBindHandler - the default bind handler to use if none is specified when binding

Since:

2.2.0

Binder

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

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

defaultBindHandler - the default bind handler to use if none is specified when binding

constructorProvider - the constructor provider which provides the bind constructor to use when binding

Since:

2.2.1

Binder

public Binder(Iterable<ConfigurationPropertySource> sources,
 PlaceholdersResolver placeholdersResolver,
 List<ConversionService> conversionServices,
 Consumer<PropertyEditorRegistry> propertyEditorInitializer,
 BindHandler defaultBindHandler,
 BindConstructorProvider constructorProvider)

Create a new Binder instance for the specified sources.

Parameters:

sources - the sources used for binding

placeholdersResolver - strategy to resolve any property placeholders

conversionServices - the conversion services 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).

defaultBindHandler - the default bind handler to use if none is specified when binding

constructorProvider - the constructor provider which provides the bind constructor to use when binding

Since:

2.5.0

Method Details

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)

bindOrCreate

public <T> T bindOrCreate(String name,
 Class<T> target)

Bind the specified target Class using this binder's property sources or create a new instance using the type of the Bindable if the result of the binding is null.

Type Parameters:

T - the bound type

Parameters:

name - the configuration property name to bind

target - the target class

Returns:

the bound or created object

Since:

2.2.0

See Also:

• bind(ConfigurationPropertyName, Bindable, BindHandler)

bindOrCreate

public <T> T bindOrCreate(String name,
 Bindable<T> target)

Bind the specified target Bindable using this binder's property sources or create a new instance using the type of the Bindable if the result of the binding is null.

Type Parameters:

T - the bound type

Parameters:

name - the configuration property name to bind

target - the target bindable

Returns:

the bound or created object

Since:

2.2.0

See Also:

• bindOrCreate(ConfigurationPropertyName, Bindable, BindHandler)

bindOrCreate

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

Bind the specified target Bindable using this binder's property sources or create a new instance using the type of the Bindable if the result of the binding is null.

Type Parameters:

T - the bound type

Parameters:

name - the configuration property name to bind

target - the target bindable

handler - the bind handler

Returns:

the bound or created object

Since:

2.2.0

See Also:

• bindOrCreate(ConfigurationPropertyName, Bindable, BindHandler)

bindOrCreate

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

Bind the specified target Bindable using this binder's property sources or create a new instance using the type of the Bindable if the result of the binding is null.

Type Parameters:

T - the bound or created type

Parameters:

name - the configuration property name to bind

target - the target bindable

handler - the bind handler (may be null)

Returns:

the bound or created object

Since:

2.2.0

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

get

public static Binder get(Environment environment,
 BindHandler defaultBindHandler)

Create a new Binder instance from the specified environment.

Parameters:

environment - the environment source (must have attached ConfigurationPropertySources)

defaultBindHandler - the default bind handler to use if none is specified when binding

Returns:

a Binder instance

Since:

2.2.0