程序包 org.springframework.boot.context.properties.bind

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

从以下版本开始:

2.0.0

作者:

Phillip Webb, Madhura Bhave

构造器概要

构造器

构造器	说明
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.

方法概要

修饰符和类型	方法	说明
<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 of the specified target Class 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.

从类继承的方法 java.lang.Object

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

构造器详细资料

Binder

public Binder(ConfigurationPropertySource... sources)

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

参数:

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.

参数:

sources - the sources used for binding

Binder

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

Create a new Binder instance for the specified sources.

参数:

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.

参数:

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.

参数:

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.

参数:

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

从以下版本开始:

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.

参数:

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

从以下版本开始:

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.

参数:

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

从以下版本开始:

2.5.0

方法详细资料

bind

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

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

类型参数:

T - the bound type

参数:

name - the configuration property name to bind

target - the target class

返回:

the binding result (never null)

另请参阅:

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

类型参数:

T - the bound type

参数:

name - the configuration property name to bind

target - the target bindable

返回:

the binding result (never null)

另请参阅:

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

类型参数:

T - the bound type

参数:

name - the configuration property name to bind

target - the target bindable

返回:

the binding result (never null)

另请参阅:

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

类型参数:

T - the bound type

参数:

name - the configuration property name to bind

target - the target bindable

handler - the bind handler (may be null)

返回:

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.

类型参数:

T - the bound type

参数:

name - the configuration property name to bind

target - the target bindable

handler - the bind handler (may be null)

返回:

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 of the specified target Class if the result of the binding is null.

类型参数:

T - the bound type

参数:

name - the configuration property name to bind

target - the target class

返回:

the bound or created object

从以下版本开始:

2.2.0

另请参阅:

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

类型参数:

T - the bound type

参数:

name - the configuration property name to bind

target - the target bindable

返回:

the bound or created object

从以下版本开始:

2.2.0

另请参阅:

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

类型参数:

T - the bound type

参数:

name - the configuration property name to bind

target - the target bindable

handler - the bind handler

返回:

the bound or created object

从以下版本开始:

2.2.0

另请参阅:

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

类型参数:

T - the bound or created type

参数:

name - the configuration property name to bind

target - the target bindable

handler - the bind handler (may be null)

返回:

the bound or created object

从以下版本开始:

2.2.0

get

public static Binder get(Environment environment)

Create a new Binder instance from the specified environment.

参数:

environment - the environment source (must have attached ConfigurationPropertySources)

返回:

a Binder instance

get

public static Binder get(Environment environment,
 BindHandler defaultBindHandler)

Create a new Binder instance from the specified environment.

参数:

environment - the environment source (must have attached ConfigurationPropertySources)

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

返回:

a Binder instance

从以下版本开始:

2.2.0