org.springframework.boot.bind

Class PropertiesConfigurationFactory<T>

java.lang.Object

org.springframework.boot.bind.PropertiesConfigurationFactory<T>

Type Parameters:

T - The target type

All Implemented Interfaces:

Aware, FactoryBean<T>, InitializingBean, MessageSourceAware

public class PropertiesConfigurationFactory<T>
extends Object
implements FactoryBean<T>, MessageSourceAware, InitializingBean

Validate some Properties (or optionally PropertySources) by binding them to an object of a specified type and then optionally running a Validator over it.

Author:

Dave Syer

Constructor Summary

Constructors

Constructor and Description
PropertiesConfigurationFactory(Class<?> type) Create a new factory for an object of the given type.
PropertiesConfigurationFactory(T target)

Method Summary

Methods

Modifier and Type	Method and Description
void	afterPropertiesSet()
void	bindPropertiesToTarget()
protected void	customizeBinder(DataBinder dataBinder)
T	getObject()
Class<?>	getObjectType()
boolean	isSingleton()
void	setConversionService(ConversionService conversionService)
void	setExceptionIfInvalid(boolean exceptionIfInvalid) Flag to indicate that an exception should be raised if a Validator is available and validation fails.
void	setIgnoreInvalidFields(boolean ignoreInvalidFields) Set whether to ignore invalid fields, that is, whether to ignore bind parameters that have corresponding fields in the target object which are not accessible (for example because of null values in the nested path).
void	setIgnoreNestedProperties(boolean ignoreNestedProperties) Flag to disable binding of nested properties (i.e.
void	setIgnoreUnknownFields(boolean ignoreUnknownFields) Set whether to ignore unknown fields, that is, whether to ignore bind parameters that do not have corresponding fields in the target object.
void	setMessageSource(MessageSource messageSource)
void	setProperties(Properties properties)
void	setPropertySources(PropertySources propertySources)
void	setTargetName(String targetName)
void	setValidator(Validator validator)

Methods inherited from class java.lang.Object

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

Constructor Detail

PropertiesConfigurationFactory

public PropertiesConfigurationFactory(T target)

Parameters:

target - the target object to bind too

See Also:

PropertiesConfigurationFactory(Class)

PropertiesConfigurationFactory

public PropertiesConfigurationFactory(Class<?> type)

Create a new factory for an object of the given type.

Parameters:

type - the target type

See Also:

PropertiesConfigurationFactory(Class)

Method Detail

setIgnoreNestedProperties

public void setIgnoreNestedProperties(boolean ignoreNestedProperties)

Flag to disable binding of nested properties (i.e. those with period separators in their paths). Can be useful to disable this if the name prefix is empty and you don't want to ignore unknown fields.

Parameters:

ignoreNestedProperties - the flag to set (default false)

setIgnoreUnknownFields

public void setIgnoreUnknownFields(boolean ignoreUnknownFields)

Set whether to ignore unknown fields, that is, whether to ignore bind parameters that do not have corresponding fields in the target object.

Default is "true". Turn this off to enforce that all bind parameters must have a matching field in the target object.

Parameters:

ignoreUnknownFields - if unknown fields should be ignored

setIgnoreInvalidFields

public void setIgnoreInvalidFields(boolean ignoreInvalidFields)

Set whether to ignore invalid fields, that is, whether to ignore bind parameters that have corresponding fields in the target object which are not accessible (for example because of null values in the nested path).

Default is "false". Turn this on to ignore bind parameters for nested objects in non-existing parts of the target object graph.

Parameters:

ignoreInvalidFields - if invalid fields should be ignored

setTargetName

public void setTargetName(String targetName)

Parameters:

targetName - the target name to set

setMessageSource

public void setMessageSource(MessageSource messageSource)

Specified by:

setMessageSource in interface MessageSourceAware

Parameters:

messageSource - the messageSource to set

setProperties

public void setProperties(Properties properties)

Parameters:

properties - the properties to set

setPropertySources

public void setPropertySources(PropertySources propertySources)

Parameters:

propertySources - the propertySources to set

setConversionService

public void setConversionService(ConversionService conversionService)

Parameters:

conversionService - the conversionService to set

setValidator

public void setValidator(Validator validator)

Parameters:

validator - the validator to set

setExceptionIfInvalid

public void setExceptionIfInvalid(boolean exceptionIfInvalid)

Flag to indicate that an exception should be raised if a Validator is available and validation fails.

Parameters:

exceptionIfInvalid - the flag to set

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception

Specified by:

afterPropertiesSet in interface InitializingBean

Throws:

Exception

getObjectType

public Class<?> getObjectType()

Specified by:

getObjectType in interface FactoryBean<T>

isSingleton

public boolean isSingleton()

Specified by:

isSingleton in interface FactoryBean<T>

getObject

public T getObject()
            throws Exception

Specified by:

getObject in interface FactoryBean<T>

Throws:

Exception

bindPropertiesToTarget

public void bindPropertiesToTarget()
                            throws BindException

Throws:

BindException

customizeBinder

protected void customizeBinder(DataBinder dataBinder)

Parameters:

dataBinder - the data binder that will be used to bind and validate