org.springframework.validation.beanvalidation

Class BeanValidationPostProcessor

  • java.lang.Object
    • org.springframework.validation.beanvalidation.BeanValidationPostProcessor
  • All Implemented Interfaces:
    BeanPostProcessor, InitializingBean


    public class BeanValidationPostProcessor
    extends java.lang.Object
    implements BeanPostProcessor, InitializingBean
    Simple BeanPostProcessor that checks JSR-303 constraint annotations in Spring-managed beans, throwing an initialization exception in case of constraint violations right before calling the bean's init method (if any).
    Since:
    3.0
    Author:
    Juergen Hoeller
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method and Description
      void afterPropertiesSet()
      Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.
      protected void doValidate(java.lang.Object bean)
      Perform validation of the given bean.
      java.lang.Object postProcessAfterInitialization(java.lang.Object bean, java.lang.String beanName)
      Apply this BeanPostProcessor to the given new bean instance after any bean initialization callbacks (like InitializingBean's afterPropertiesSet or a custom init-method).
      java.lang.Object postProcessBeforeInitialization(java.lang.Object bean, java.lang.String beanName)
      Apply this BeanPostProcessor to the given new bean instance before any bean initialization callbacks (like InitializingBean's afterPropertiesSet or a custom init-method).
      void setAfterInitialization(boolean afterInitialization)
      Choose whether to perform validation after bean initialization (i.e.
      void setValidator(Validator validator)
      Set the JSR-303 Validator to delegate to for validating beans.
      void setValidatorFactory(ValidatorFactory validatorFactory)
      Set the JSR-303 ValidatorFactory to delegate to for validating beans, using its default Validator.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • BeanValidationPostProcessor

        public BeanValidationPostProcessor()
    • Method Detail

      • setValidator

        public void setValidator(Validator validator)
        Set the JSR-303 Validator to delegate to for validating beans.

        Default is the default ValidatorFactory's default Validator.

      • setValidatorFactory

        public void setValidatorFactory(ValidatorFactory validatorFactory)
        Set the JSR-303 ValidatorFactory to delegate to for validating beans, using its default Validator.

        Default is the default ValidatorFactory's default Validator.

        See Also:
        ValidatorFactory.getValidator()
      • setAfterInitialization

        public void setAfterInitialization(boolean afterInitialization)
        Choose whether to perform validation after bean initialization (i.e. after init methods) instead of before (which is the default).

        Default is "false" (before initialization). Switch this to "true" (after initialization) if you would like to give init methods a chance to populate constrained fields before they get validated.

      • afterPropertiesSet

        public void afterPropertiesSet()
        Description copied from interface: InitializingBean
        Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

        This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

        Specified by:
        afterPropertiesSet in interface InitializingBean
      • postProcessBeforeInitialization

        public java.lang.Object postProcessBeforeInitialization(java.lang.Object bean,
                                                                java.lang.String beanName)
                                                         throws BeansException
        Description copied from interface: BeanPostProcessor
        Apply this BeanPostProcessor to the given new bean instance before any bean initialization callbacks (like InitializingBean's afterPropertiesSet or a custom init-method). The bean will already be populated with property values. The returned bean instance may be a wrapper around the original.

        The default implementation returns the given bean as-is.

        Specified by:
        postProcessBeforeInitialization in interface BeanPostProcessor
        Parameters:
        bean - the new bean instance
        beanName - the name of the bean
        Returns:
        the bean instance to use, either the original or a wrapped one; if null, no subsequent BeanPostProcessors will be invoked
        Throws:
        BeansException - in case of errors
        See Also:
        InitializingBean.afterPropertiesSet()
      • postProcessAfterInitialization

        public java.lang.Object postProcessAfterInitialization(java.lang.Object bean,
                                                               java.lang.String beanName)
                                                        throws BeansException
        Description copied from interface: BeanPostProcessor
        Apply this BeanPostProcessor to the given new bean instance after any bean initialization callbacks (like InitializingBean's afterPropertiesSet or a custom init-method). The bean will already be populated with property values. The returned bean instance may be a wrapper around the original.

        In case of a FactoryBean, this callback will be invoked for both the FactoryBean instance and the objects created by the FactoryBean (as of Spring 2.0). The post-processor can decide whether to apply to either the FactoryBean or created objects or both through corresponding bean instanceof FactoryBean checks.

        This callback will also be invoked after a short-circuiting triggered by a InstantiationAwareBeanPostProcessor.postProcessBeforeInstantiation(java.lang.Class<?>, java.lang.String) method, in contrast to all other BeanPostProcessor callbacks.

        The default implementation returns the given bean as-is.

        Specified by:
        postProcessAfterInitialization in interface BeanPostProcessor
        Parameters:
        bean - the new bean instance
        beanName - the name of the bean
        Returns:
        the bean instance to use, either the original or a wrapped one; if null, no subsequent BeanPostProcessors will be invoked
        Throws:
        BeansException - in case of errors
        See Also:
        InitializingBean.afterPropertiesSet(), FactoryBean