org.springframework.boot.context.properties.bind.validation

Class ValidationBindHandler

java.lang.Object

org.springframework.boot.context.properties.bind.AbstractBindHandler

org.springframework.boot.context.properties.bind.validation.ValidationBindHandler

All Implemented Interfaces:

BindHandler

public class ValidationBindHandler
extends AbstractBindHandler

BindHandler to apply Validators to bound results.

Since:

2.0.0

Author:

Phillip Webb, Madhura Bhave

Field Summary

Fields inherited from interface org.springframework.boot.context.properties.bind.BindHandler

DEFAULT

Constructor Summary

Constructors

Constructor and Description
ValidationBindHandler(BindHandler parent, org.springframework.validation.Validator... validators)
ValidationBindHandler(org.springframework.validation.Validator... validators)

Method Summary

Modifier and Type	Method and Description
void	onFinish(ConfigurationPropertyName name, Bindable<?> target, BindContext context, Object result) Called when binding finishes, regardless of whether the property was bound or not.
boolean	onStart(ConfigurationPropertyName name, Bindable<?> target, BindContext context) Called when binding of an element starts but before any result has been determined.
Object	onSuccess(ConfigurationPropertyName name, Bindable<?> target, BindContext context, Object result) Called when binding of an element ends with a successful result.

Methods inherited from class org.springframework.boot.context.properties.bind.AbstractBindHandler

onFailure

Methods inherited from class java.lang.Object

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

Constructor Detail

ValidationBindHandler

public ValidationBindHandler(org.springframework.validation.Validator... validators)

ValidationBindHandler

public ValidationBindHandler(BindHandler parent,
                             org.springframework.validation.Validator... validators)

Method Detail

onStart

public boolean onStart(ConfigurationPropertyName name,
                       Bindable<?> target,
                       BindContext context)

Description copied from interface: BindHandler

Called when binding of an element starts but before any result has been determined.

Specified by:

onStart in interface BindHandler

Overrides:

onStart in class AbstractBindHandler

Parameters:

name - the name of the element being bound

target - the item being bound

context - the bind context

Returns:

true if binding should proceed

onSuccess

public Object onSuccess(ConfigurationPropertyName name,
                        Bindable<?> target,
                        BindContext context,
                        Object result)

Description copied from interface: BindHandler

Called when binding of an element ends with a successful result. Implementations may change the ultimately returned result or perform addition validation.

Specified by:

onSuccess in interface BindHandler

Overrides:

onSuccess in class AbstractBindHandler

Parameters:

name - the name of the element being bound

target - the item being bound

context - the bind context

result - the bound result (never null)

Returns:

the actual result that should be used (may be null)

onFinish

public void onFinish(ConfigurationPropertyName name,
                     Bindable<?> target,
                     BindContext context,
                     Object result)
              throws Exception

Description copied from interface: BindHandler

Called when binding finishes, regardless of whether the property was bound or not.

Specified by:

onFinish in interface BindHandler

Overrides:

onFinish in class AbstractBindHandler

Parameters:

name - the name of the element being bound

target - the item being bound

context - the bind context

result - the bound result (may be null)

Throws:

Exception - if the binding isn't valid