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, Validator... validators)
ValidationBindHandler(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(Validator... validators)

ValidationBindHandler

public ValidationBindHandler(BindHandler parent,
                             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