20200103 Spring官方文档（Core 3）

Posted 2021-03-19 流星<。)#)))≦

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了20200103 Spring官方文档（Core 3）相关的知识，希望对你有一定的参考价值。

3.验证，数据绑定和类型转换

考虑将验证作为业务逻辑是有利有弊，Spring提供了一种验证（和数据绑定）设计，但并不排除其中任何一个。具体来说，验证不应与Web层绑定，并且应该易于本地化，并且应该可以插入任何可用的验证器。考虑到这些问题，Spring提出了一个Validator接口，该接口既基本又可以在应用程序的每一层中使用。

数据绑定对于使用户输入动态绑定到应用程序的域模型（或用于处理用户输入的任何对象）非常有用。 Spring提供了恰当地命名为DataBinder的功能。 Validator和DataBinder组成了validation包，该验证包主要用于但不限于MVC框架。

BeanWrapper是Spring框架中的基本概念，并在很多地方使用。但是，您可能不需要直接使用BeanWrapper。

Spring的DataBinder和较低级别的BeanWrapper都使用PropertyEditorSupport实现来解析和格式化属性值。 PropertyEditor和PropertyEditorSupport类型是JavaBeans规范的一部分，本章还将对此进行说明。 Spring 3引入了core.convert包，该包提供了常规的类型转换工具，以及用于格式化UI字段值的高级format包。您可以将这些包用作PropertyEditorSupport实现的更简单替代方案。

从4.0版开始，Spring Framework支持Bean验证1.0（JSR-303）和Bean验证1.1（JSR-349）来提供设置支持，并使它们适应Spring的Validator接口。

应用程序可以选择一次在全局启用Bean验证，并将其专用于所有验证需求。

应用程序还可以为每个DataBinder实例注册其他Spring Validator实例。这对于在不使用注释的情况下插入验证逻辑可能很有用。

3.1。通过使用Spring的Validator接口进行验证

Spring具有Validator接口，可用于验证对象。 Validator接口通过使用Errors对象来工作，以便验证器在验证时可以将验证失败报告给Errors对象。

org.springframework.validation.Validator接口的以下两个方法来提供验证行为：

supports(Class)：Validator是否可以验证提供的实例Class？
validate(Object, org.springframework.validation.Errors)：验证给定的对象，并在出现验证错误的情况下，将给那些Errors对象注册。

@Data
public class Person {
    private String name;
    private int age;
}


public class PersonValidator implements Validator {

    /**
     * This Validator validates only Person instances
     */
    public boolean supports(Class clazz) {
        return Person.class.equals(clazz);
    }

    public void validate(Object obj, Errors e) {
        ValidationUtils.rejectIfEmpty(e, "name", "name.empty");
        Person p = (Person) obj;
        if (p.getAge() < 0) {
            e.rejectValue("age", "negativevalue");
        } else if (p.getAge() > 110) {
            e.rejectValue("age", "too.darn.old");
        }
    }
}

虽然可以实现单个Validator类来验证丰富对象中的每个嵌套对象，但最好在其自己的Validator实现中封装对象的每个嵌套类的验证逻辑。一个对象的简单示例是一个Customer，它由两个String属性（第一个和第二个名称）和一个复杂的Address对象组成。地址对象可以独立于客户对象使用，因此已实现了不同的AddressValidator。如果希望CustomerValidator重用AddressValidator类中包含的逻辑而不求助于复制和粘贴，则可以在CustomerValidator中依赖注入或实例化一个AddressValidator，如以下示例所示：

public class CustomerValidator implements Validator {

    private final Validator addressValidator;

    public CustomerValidator(Validator addressValidator) {
        if (addressValidator == null) {
            throw new IllegalArgumentException("The supplied [Validator] is " +
                "required and must not be null.");
        }
        if (!addressValidator.supports(Address.class)) {
            throw new IllegalArgumentException("The supplied [Validator] must " +
                "support the validation of [Address] instances.");
        }
        this.addressValidator = addressValidator;
    }

    /**
     * This Validator validates Customer instances, and any subclasses of Customer too
     */
    public boolean supports(Class clazz) {
        return Customer.class.isAssignableFrom(clazz);
    }

    public void validate(Object target, Errors errors) {
        ValidationUtils.rejectIfEmptyOrWhitespace(errors, "firstName", "field.required");
        ValidationUtils.rejectIfEmptyOrWhitespace(errors, "surname", "field.required");
        Customer customer = (Customer) target;
        try {
            errors.pushNestedPath("address");
            ValidationUtils.invokeValidator(this.addressValidator, customer.getAddress(), errors);
        } finally {
            errors.popNestedPath();
        }
    }
}

验证错误将报告给传递给验证器的Errors对象。对于Spring Web MVC，可以使用<spring:bind />标记检查错误消息，但也可以自己检查Errors对象。

3.2。将Code解析为错误消息

我们介绍了数据绑定和验证。本节介绍与验证错误相对应的输出消息。在上一节显示的示例中，我们拒绝了名称和年龄字段。如果要使用MessageSource输出错误消息，可以使用拒绝字段时提供的错误代码（在这种情况下为“name”和“age”）来进行输出。当您从Errors接口调用（直接或间接通过使用诸如ValidationUtils类）rejectValue或其他拒绝方法之一时，底层实现不仅注册您传入的代码，还注册许多其他错误代码。 MessageCodesResolver确定Errors接口注册器中的哪个错误代码。默认情况下，使用DefaultMessageCodesResolver，它（例如）不仅使用您提供的代码注册消息，而且还注册包含传递给拒绝方法的字段名称的消息。因此，如果您通过使用rejectValue("age", "too.darn.old")拒绝字段，除了too.darn.old代码外，Spring还会注册too.darn.old.age和too.darn.old .age.int（第一个包含字段名称，第二个包含字段类型）。这样做是为了方便开发人员在定位错误消息时提供帮助。

有关MessageCodesResolver和默认策略的更多信息，可以分别在MessageCodesResolver和DefaultMessageCodesResolver的javadoc中找到。

3.3。Bean操作和BeanWrapper

org.springframework.beans包遵循JavaBeans标准。 JavaBean是具有默认无参数构造函数的类，并且遵循命名约定，在该命名约定下，例如，名为bingoMadness的属性将具有setter方法setBingoMadness(..) 和getter方法getBingoMadness()。

Bean包中的一个非常重要的类是BeanWrapper接口及其相应的实现（BeanWrapperImpl）。就像从Javadoc引用的那样，BeanWrapper提供了以下功能：设置和获取属性值（单独或批量），获取属性描述符以及查询属性以确定它们是否可读或可写。此外，BeanWrapper还支持嵌套属性，从而可以将子属性上的属性设置为无限深度。 BeanWrapper还支持添加标准JavaBeans PropertyChangeListeners和VetoableChangeListeners的功能，而无需在目标类中支持代码。最后但并非最不重要的一点是，BeanWrapper支持设置索引属性。 BeanWrapper通常不直接由应用程序代码使用，而是由DataBinder和BeanFactory使用。

BeanWrapper的工作方式部分由其名称表示：它包装一个Bean，以对该Bean执行操作，例如设置和检索属性。

3.3.1。设置和获取基本和嵌套属性

设置和获取属性是通过使用setPropertyValue，setPropertyValues，getPropertyValue和getPropertyValues方法实现的，这些方法带有一些重载的变体。 Springs javadoc更详细地描述了它们。 JavaBeans规范具有用于指示对象属性的约定。下表显示了这些约定的一些示例：

表达	说明
name	指示与getName()或isName()和setName(..)方法相对应的属性名称。
account.name	指示与（例如）getAccount().setName()或getAccount().getName()方法相对应的属性account的嵌套属性name。
account[2]	指示索引属性account的第三个元素。索引属性的类型可以是数组，列表或其他自然排序的集合。
account[COMPANYNAME]	表示由account的Map属性的COMPANYNAME键索引的map条目的值。

@Data
public class Company {
    private String name;
    private Employee managingDirector;
}

@Data
public class Employee {
    private String name;
    private float salary;
}

public static void main(String[] args) {
    BeanWrapper company = new BeanWrapperImpl(new Company());
    // setting the company name..
    company.setPropertyValue("name", "Some Company Inc.");
    // ... can also be done like this:
    PropertyValue value = new PropertyValue("name", "Some Company Inc.");
    company.setPropertyValue(value);

    // ok, let's create the director and tie it to the company:
    BeanWrapper jim = new BeanWrapperImpl(new Employee());
    jim.setPropertyValue("name", "Jim Stravinsky");
    company.setPropertyValue("managingDirector", jim.getWrappedInstance());

    // retrieving the salary of the managingDirector through the company
    Float salary = (Float) company.getPropertyValue("managingDirector.salary");
}

3.3.2。内置PropertyEditor实现

Spring使用PropertyEditor的概念来实现对象和字符串之间的转换。以不同于对象本身的方式表示属性可能很方便。例如，日期可以用人类可读的方式表示（如String：‘2007-14-09‘），而我们仍然可以将人类可读的形式转换回原始日期（或者更好的是，转换任何日期以人类可读的形式输入到Date对象）。通过注册类型为java.beans.PropertyEditor的自定义编辑器，可以实现此行为。在BeanWrapper上或在特定的IoC容器中注册自定义编辑器，使它具有如何将属性转换为所需类型的知识。有关PropertyEditor的更多信息，请参见Oracle的java.beans包的javadoc。

在Spring中使用属性编辑的两个示例：

通过使用PropertyEditor实现在bean上设置属性。当使用String作为在XML文件中声明的某些bean的属性的值时，Spring（如果相应属性的设置器具有Class参数）将使用ClassEditor尝试将参数解析为Class对象。
在Spring的MVC框架中，通过使用各种PropertyEditor实现来解析HTTP请求参数，您可以在CommandController的所有子类中手动绑定这些实现。

BeanWrapper 接口继承 PropertyEditorRegistry 接口。

Spring具有许多内置的PropertyEditor实现，以简化生活。它们都位于org.springframework.beans.propertyeditors包中。默认情况下，大多数（但不是全部，如下表所示）由BeanWrapperImpl注册。如果可以通过某种方式配置属性编辑器，则仍可以注册自己的变体以覆盖默认变体。下表描述了Spring提供的各种PropertyEditor实现：

类	说明
ByteArrayPropertyEditor	字节数组的编辑器。将字符串转换为其相应的字节表示形式。默认情况下由BeanWrapperImpl注册。
ClassEditor	将代表类的字符串解析为实际类，反之亦然。当找不到类时，将抛出IllegalArgumentException。默认情况下，由BeanWrapperImpl注册。
CustomBooleanEditor	Boolean 属性的可定制属性编辑器。默认情况下，由BeanWrapperImpl注册，但是可以通过将其自定义实例注册为自定义编辑器来覆盖。
CustomCollectionEditor	集合的属性编辑器，可将任何源Collection转换为给定的目标Collection类型。
CustomDateEditor	java.util.Date的可自定义属性编辑器，支持自定义DateFormat。默认未注册。必须根据需要以适当的格式进行用户注册。
CustomNumberEditor	任何Number子类（例如Integer，Long，Float或Double）的可自定义属性编辑器。默认情况下，由BeanWrapperImpl注册，但是可以通过将其自定义实例注册为自定义编辑器来覆盖。
FileEditor	将字符串解析为java.io.File对象。默认情况下，由BeanWrapperImpl注册。
InputStreamEditor	单向属性编辑器，它可以采用字符串并生成（通过中间的ResourceEditor和Resource）一个InputStream，以便可以将InputStream属性直接设置为字符串。请注意，默认用法不会为您关闭InputStream。默认情况下，由BeanWrapperImpl注册。
LocaleEditor	可以将字符串解析为Locale对象，反之亦然（字符串格式为[country][variant]，与Locale的toString()方方法相同）。默认情况下，由BeanWrapperImpl注册。
PatternEditor	可以将字符串解析为java.util.regex.Pattern对象，反之亦然。
PropertiesEditor	可以将字符串（以java.util.Properties类的javadoc中定义的格式格式化）转换为Properties对象。默认情况下，由BeanWrapperImpl注册。
StringTrimmerEditor	修剪字符串的属性编辑器。（可选）允许将空字符串转换为空值。默认情况下未注册—必须是用户注册的。
URLEditor	可以将URL的字符串表示形式解析为实际的URL对象。默认情况下，由BeanWrapperImpl注册。

Spring使用java.beans.PropertyEditorManager设置可能需要的属性编辑器的搜索路径。搜索路径还包括sun.bean.editors，其中包括针对诸如Font，Color和大多数基本类型的类型的PropertyEditor实现。还要注意，如果标准JavaBeans基础结构与它们处理的类在同一包中，并且与该类具有相同的名称，并附加了Editor，则标准JavaBeans基础结构将自动发现PropertyEditor类（无需显式注册它们）。例如，可能具有以下类和包结构，足以使SomethingEditor类被识别并用作Something类型的属性的PropertyEditor。

com
  chank
    pop
      Something
      SomethingEditor // the PropertyEditor for the Something class

参考源码：

org.springframework.beans.BeanUtils#findEditorByConvention

注意，您也可以在此处使用标准的BeanInfo JavaBeans机制。以下示例使用BeanInfo机制使用关联类的属性显式注册一个或多个PropertyEditor实例：

com
  chank
    pop
      Something
      SomethingBeanInfo // the BeanInfo for the Something class

所引用的SomethingBeanInfo类的以下Java源代码将CustomNumberEditor与Something类的age属性相关联：

public class SomethingBeanInfo extends SimpleBeanInfo {

    public PropertyDescriptor[] getPropertyDescriptors() {
        try {
            final PropertyEditor numberPE = new CustomNumberEditor(Integer.class, true);
            PropertyDescriptor ageDescriptor = new PropertyDescriptor("age", Something.class) {
                public PropertyEditor createPropertyEditor(Object bean) {
                    return numberPE;
                };
            };
            return new PropertyDescriptor[] { ageDescriptor };
        }
        catch (IntrospectionException ex) {
            throw new Error(ex.toString());
        }
    }
}

注册其他自定义PropertyEditor实现

当将bean属性设置为字符串值时，Spring IoC容器最终使用标准JavaBeans PropertyEditor实现将这些字符串转换为属性的复杂类型。 Spring预注册了许多自定义的PropertyEditor实现（例如，将表示为字符串的类名称转换为Class对象）。此外，Java的标准JavaBeans PropertyEditor查找机制允许适当地命名类的PropertyEditor，并将其与提供支持的类放在同一包中，以便可以自动找到它。

如果需要注册其他自定义PropertyEditor，则可以使用几种机制。最手动的方法（通常不方便或不建议使用）是使用ConfigurableBeanFactory接口的registerCustomEditor()方法，假设您有BeanFactory引用。另一种（稍微方便些）的机制是使用一种称为CustomEditorConfigurer的特殊bean工厂后处理器。尽管您可以将Bean工厂后处理器与BeanFactory实现一起使用，但CustomEditorConfigurer具有嵌套的属性设置，因此我们强烈建议您将其与ApplicationContext一起使用，在这里可以将其以与其他任何Bean相似的方式进行部署，并且可以在任何位置进行部署。自动检测并应用。

请注意，所有的bean工厂和应用程序上下文通过使用BeanWrapper来处理属性转换，都会自动使用许多内置的属性编辑器。上一节列出了BeanWrapper注册的标准属性编辑器。此外，ApplicationContext还以适合特定应用程序上下文类型的方式重写或添加其他编辑器，以处理资源查找。

标准JavaBeans PropertyEditor实例用于将以字符串表示的属性值转换为该属性的实际复杂类型。您可以使用bean工厂的后处理器CustomEditorConfigurer来方便地将对其他PropertyEditor实例的支持添加到ApplicationContext。

<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer">
    <property name="customEditors">
        <map>
            <entry key="example.ExoticType" value="example.ExoticTypeEditor"/>
        </map>
    </property>
</bean>

使用 PropertyEditorRegistrar

使用Spring容器注册属性编辑器的另一种机制是创建和使用PropertyEditorRegistrar。当需要在几种不同情况下使用同一组属性编辑器时，此接口特别有用。您可以编写相应的Registrar，并在每种情况下重复使用它。 PropertyEditorRegistrar实例与一个名为PropertyEditorRegistry的接口一起工作，该接口由Spring BeanWrapper（和DataBinder）实现。当与CustomEditorConfigurer 结合使用时，PropertyEditorRegistrar实例特别方便，后者公开了一个名为setPropertyEditorRegistrars(..) 的属性。以这种方式添加到CustomEditorConfigurer的PropertyEditorRegistrar实例可以轻松地与DataBinder和Spring MVC控制器共享。此外，它避免了在自定义编辑器上进行同步的需求：PropertyEditorRegistrar应该为每次创建bean的尝试创建新的PropertyEditor实例。

以下示例显示了如何创建自己的PropertyEditorRegistrar实现：

package com.foo.editors.spring;

public final class CustomPropertyEditorRegistrar implements PropertyEditorRegistrar {

    public void registerCustomEditors(PropertyEditorRegistry registry) {

        // it is expected that new PropertyEditor instances are created
        registry.registerCustomEditor(ExoticType.class, new ExoticTypeEditor());

        // you could register as many custom property editors as are required here...
    }
}

另请参见org.springframework.beans.support.ResourceEditorRegistrar作为示例 PropertyEditorRegistrar实现。注意，在该registerCustomEditors(..) 方法的实现中，它如何创建每个属性编辑器的新实例。

下一个示例显示如何配置CustomEditorConfigurer并将实例 CustomPropertyEditorRegistrar注入其中：

<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer">
    <property name="propertyEditorRegistrars">
        <list>
            <ref bean="customPropertyEditorRegistrar"/>
        </list>
    </property>
</bean>

<bean id="customPropertyEditorRegistrar"
    class="com.foo.editors.spring.CustomPropertyEditorRegistrar"/>

最后（对于使用Spring的MVC Web框架的读者来说，与本章的重点有所偏离），将PropertyEditorRegistrars与数据绑定控制器（例如SimpleFormController）结合使用会非常方便。下面的示例在initBinder(..) 方法的实现中使用PropertyEditorRegistrar：

public final class RegisterUserController extends SimpleFormController {

    private final PropertyEditorRegistrar customPropertyEditorRegistrar;

    public RegisterUserController(PropertyEditorRegistrar propertyEditorRegistrar) {
        this.customPropertyEditorRegistrar = propertyEditorRegistrar;
    }

    protected void initBinder(HttpServletRequest request,
            ServletRequestDataBinder binder) throws Exception {
        this.customPropertyEditorRegistrar.registerCustomEditors(binder);
    }

    // other methods to do with registering a User
}

这种PropertyEditor注册方式可以导致代码简洁（实现的initBinder(..)长度只有一行），并且可以将常见的PropertyEditor 注册代码封装在一个类中，然后Controllers根据需要在许多代码之间共享。

3.4. Spring 类型转换

Spring 3引入了core.convert包，该包提供了通用的类型转换系统。系统定义了一个用于实现类型转换逻辑的SPI和一个用于在运行时执行类型转换的API。在Spring容器中，可以使用此系统作为PropertyEditor实现的替代方法，以将外部化的bean属性值字符串转换为所需的属性类型。您还可以在应用程序中需要类型转换的任何地方使用公共API。

3.4.1. Converter SPI

如以下接口定义所示，用于实现类型转换逻辑的SPI非常简单且具有强类型。

package org.springframework.core.convert.converter;

public interface Converter<S, T> {
    T convert(S source);
}

要创建自己的转换器，请实现Converter接口并将S设置为要转换的来源类型，并将T设置为要转换的目标类型。如果还需要注册一个委托数组或集合转换器（默认情况下DefaultConversionService会这样做），则也可以透明地应用此类转换器，如果需要将S的集合或数组转换为T的数组或集合。

对于每次对convert(S)的调用，保证源参数不为null。如果转换失败，您的转换器可能会引发任何未经检查的异常。具体来说，它应该抛出IllegalArgumentException以报告无效的源值。注意确保您的Converter实现是线程安全的。

为了方便起见，在core.convert.support包中提供了几种转换器实现。这些包括从字符串到数字和其他常见类型的转换器。位于org.springframework.core.convert.support包中。

3.4.2。使用ConverterFactory

当需要集中整个类层次结构的转换逻辑时（例如，从转换String为Enum对象时），可以实现 ConverterFactory，如以下示例所示：

package org.springframework.core.convert.converter;

public interface ConverterFactory<S, R> {

    <T extends R> Converter<S, T> getConverter(Class<T> targetType);
}

参数化S为您要转换的类型，参数R为基本类型，R定义可以转换为的类的范围。然后实现getConverter(Class <T>)，其中T是R的子类。

3.4.3。使用GenericConverter

当您需要复杂的Converter实现时，请考虑使用GenericConverter接口。与Converter相比，GenericConverter具有比Converter更灵活但强度不高的签名，支持在多种源类型和目标类型之间进行转换。此外，GenericConverter使您可以在实现转换逻辑时使用可用的源字段和目标字段上下文。这种上下文允许类型转换由字段注释或在字段签名上声明的通用信息驱动。以下清单显示了GenericConverter的接口定义：

package org.springframework.core.convert.converter;

public interface GenericConverter {

    public Set<ConvertiblePair> getConvertibleTypes();

    Object convert(Object source, TypeDescriptor sourceType, TypeDescriptor targetType);
}

要实现GenericConverter，请让getConvertibleTypes() 返回支持的源→目标类型对。然后实现convert(Object，TypeDescriptor，TypeDescriptor)包含您的转换逻辑。源TypeDescriptor提供对包含正在转换的值的源字段的访问。使用目标TypeDescriptor，可以访问要设置转换值的目标字段。

GenericConverter的一个很好的例子是在Java数组和集合之间进行转换的转换器。这样的ArrayToCollectionConverter会对声明目标集合类型的字段进行内省，以解析集合的元素类型。这样就可以在将集合设置到目标字段上之前，将源数组中的每个元素转换为集合元素类型。

由于GenericConverter是一个更复杂的SPI接口，因此仅应在需要时使用它。支持Converter或ConverterFactory以满足基本的类型转换需求。

使用 ConditionalGenericConverter

有时，您希望Converter仅在满足特定条件时才运行。例如，您可能只想在目标字段上时存在特定注释才运行Converter，或者可能仅在目标类上定义了特定方法（例如静态valueOf方法）时才运行Converter。 ConditionalGenericConverter是GenericConverter和ConditionalConverter接口的联合，可让您定义以下自定义匹配条件：

public interface ConditionalConverter {

    boolean matches(TypeDescriptor sourceType, TypeDescriptor targetType);
}

public interface ConditionalGenericConverter extends GenericConverter, ConditionalConverter {
}

ConditionalGenericConverter的一个很好的例子是EntityConverter，它在持久实体标识符和实体引用之间进行转换。仅当目标实体类型声明静态查找器方法（例如findAccount(Long) ）时，此类EntityConverter才可能匹配。您可以在matchs(TypeDescriptor，TypeDescriptor)的实现中执行这种finder方法检查。

3.4.4。ConversionService API

ConversionService定义了一个统一的API，用于在运行时执行类型转换逻辑。转换器通常在以下外观接口后面执行：

package org.springframework.core.convert;

public interface ConversionService {

    boolean canConvert(Class<?> sourceType, Class<?> targetType);

    <T> T convert(Object source, Class<T> targetType);

    boolean canConvert(TypeDescriptor sourceType, TypeDescriptor targetType);

    Object convert(Object source, TypeDescriptor sourceType, TypeDescriptor targetType);

}

大多数ConversionService实现也都实现ConverterRegistry，提供用于注册转换器的SPI。在内部，ConversionService实现委派其注册的转换器执行类型转换逻辑。

core.convert.support软件包中提供了一个强大的ConversionService实现。 GenericConversionService是适用于大多数环境的通用实现。 ConversionServiceFactory提供了一个方便的工厂来创建通用的ConversionService配置。

3.4.5。配置一个ConversionService

ConversionService是无状态对象，旨在在应用程序启动时实例化，然后在多个线程之间共享。在Spring应用程序中，通常为每个Spring容器（或ApplicationContext）配置一个ConversionService实例。当框架需要执行类型转换时，Spring会选择ConversionService并使用它。您也可以将ConversionService注入到您的任何bean中并直接调用它。

如果未向Spring注册任何ConversionService，则使用原始的基于PropertyEditor的系统。

要注册一个默认ConversionService使用Spring，用添加以下bean定义id的conversionService：

<bean id="conversionService"
    class="org.springframework.context.support.ConversionServiceFactoryBean"/>

默认的ConversionService可以在字符串，数字，枚举，集合，映射和其他常见类型之间进行转换。要用您自己的自定义转换器补充或覆盖默认转换器，请设置converters属性。属性值可以实现Converter，ConverterFactory或GenericConverter接口中的任何一个。

<bean id="conversionService"
        class="org.springframework.context.support.ConversionServiceFactoryBean">
    <property name="converters">
        <set>
            <bean class="example.MyCustomConverter"/>
        </set>
    </property>
</bean>

在Spring MVC应用程序中使用ConversionService也很常见。

在某些情况下，您可能希望在转换过程中应用格式设置。有关使用FormattingConversionServiceFactoryBean的详细信息，请参见FormatterRegistry SPI。

3.4.6。以编程方式使用ConversionService

要以编程方式使用ConversionService实例，可以像对待其他任何bean一样注入对该实例的引用。以下示例显示了如何执行此操作：

@Service
public class MyService {

    public MyService(ConversionService conversionService) {
        this.conversionService = conversionService;
    }

    public void doIt() {
        this.conversionService.convert(...)
    }
}

对于大多数用例，可以使用指定targetType的convert方法，但不适用于更复杂的类型，例如参数化元素的集合。例如，如果要以编程方式将Integer List转换为String List，则需要提供源类型和目标类型的正式定义。

幸运的是，如下面的示例所示，TypeDescriptor提供了各种选项来使操作变得简单明了：

DefaultConversionService cs = new DefaultConversionService();

List<Integer> input = ...
cs.convert(input,
    TypeDescriptor.forObject(input), // List<Integer> type descriptor
    TypeDescriptor.collection(List.class, TypeDescriptor.valueOf(String.class)));

请注意，DefaultConversionService自动注册适用于大多数环境的转换器。这包括集合转换器，标量转换器和基本的对象到字符串转换器。您可以使用DefaultConversionService类上的静态addDefaultConverters方法向任何ConverterRegistry注册相同的转换器。

值类型的转换器可重用于数组和集合，因此，假设标准集合处理适当，则无需创建特定的转换器即可将S的集合转换为T的集合。

3.5. Spring Field Formatting

如上一节所述，core.convert是一种通用类型转换系统。它提供了统一的ConversionService API和强类型的Converter SPI，用于实现从一种类型到另一种类型的转换逻辑。 Spring容器使用此系统绑定bean属性值。此外，Spring Expression Language（SpEL）和DataBinder都使用此系统绑定字段值。例如，当SpEL需要强制将Short转换为Long来完成expression.setValue（Object bean，Object value）尝试时，core.convert系统将执行强制转换。

现在考虑典型客户端环境（例如Web或桌面应用程序）的类型转换要求。在这样的环境中，您通常会从String转换为支持客户端回发过程，然后又转换为String以支持视图渲染过程。另外，您通常需要本地化String值。更通用的core.convert Converter SPI不能直接满足此类格式化要求。为了直接解决这些问题，Spring 3引入了方便的Formatter SPI，它为客户端环境提供了PropertyEditor实现的简单而强大的替代方案。

通常，当您需要实现通用类型转换逻辑时（例如，用于在java.util.Date和Long之间进行转换），可以使用Converter SPI。在客户端环境（例如Web应用程序）中工作并且需要解析和打印本地化的字段值时，可以使用Formatter SPI。 ConversionService为两个SPI提供统一的类型转换API。

3.5.1。Formatter SPI

用于实现字段格式化逻辑的Formatter SPI非常简单且类型严格。以下清单显示了Formatter接口定义：

package org.springframework.format;

public interface Formatter<T> extends Printer<T>, Parser<T> {
}

要创建自己的Formatter，请实现前面显示的Formatter接口。将T参数化为您希望格式化的对象的类型（例如java.util.Date）。实现print()操作以打印T的实例以在客户端语言环境中显示。实现parse()操作，以从客户端语言环境返回的格式化表示形式解析T的实例。如果解析尝试失败，则Formatter应该抛出ParseException或IllegalArgumentException。注意确保您的Formatter实现是线程安全的。

format 子包为方便起见提供了几种Formatter实现。number 包提供NumberStyleFormatter，CurrencyStyleFormatter和PercentStyleFormatter使用java.text.NumberFormat来格式化的Number对象。 datetime包提供了一个DateFormatter，使用java.text.DateFormat格式化java.util.Date对象。 datetime.joda包基于Joda-Time库提供了全面的日期时间格式支持。

3.5.2。注释驱动的格式化

可以通过字段类型或注释配置字段格式。要将注释绑定到Formatter，请实现AnnotationFormatterFactory。以下清单显示了AnnotationFormatterFactory接口的定义：

package org.springframework.format;

public interface AnnotationFormatterFactory<A extends Annotation> {

    Set<Class<?>> getFieldTypes();

    Printer<?> getPrinter(A annotation, Class<?> fieldType);

    Parser<?> getParser(A annotation, Class<?> fieldType);
}

要创建一个实现：将A参数化为要与格式逻辑关联的字段注解类型，例如org.springframework.format.annotation.DateTimeFormat。让getFieldTypes()返回可在其上使用注释的字段类型。让getPrinter()返回Printer以打印带注释的字段的值。让getParser()返回Parser以解析带注释字段的clientValue。

以下示例AnnotationFormatterFactory实现将@NumberFormat批注绑定到formatter，以指定数字样式或模式：

public final class NumberFormatAnnotationFormatterFactory
        implements AnnotationFormatterFactory<NumberFormat> {

    public Set<Class<?>> getFieldTypes() {
        return new HashSet<Class<?>>(asList(new Class<?>[] {
            Short.class, Integer.class, Long.class, Float.class,
            Double.class, BigDecimal.class, BigInteger.class }));
    }

    public Printer<Number> getPrinter(NumberFormat annotation, Class<?> fieldType) {
        return configureFormatterFrom(annotation, fieldType);
    }

    public Parser<Number> getParser(NumberFormat annotation, Class<?> fieldType) {
        return configureFormatterFrom(annotation, fieldType);
    }

    private Formatter<Number> configureFormatterFrom(NumberFormat annotation, Class<?> fieldType) {
        if (!annotation.pattern().isEmpty()) {
            return new NumberStyleFormatter(annotation.pattern());
        } else {
            Style style = annotation.style();
            if (style == Style.PERCENT) {
                return new PercentStyleFormatter();
            } else if (style == Style.CURRENCY) {
                return new CurrencyStyleFormatter();
            } else {
                return new NumberStyleFormatter();
            }
        }
    }
}

要触发格式化，可以使用@NumberFormat注释字段，如以下示例所示：

public class MyModel {

    @NumberFormat(style=Style.CURRENCY)
    private BigDecimal decimal;
}

格式化注解API

org.springframework.format.annotation包中存在一个可移植的格式化注释API。您可以使用@NumberFormat格式化数字字段（例如Double和Long），并使用@DateTimeFormat格式化java.util.Date，java.util.Calendar，Long（用于毫秒时间戳）以及JSR-310 java.time和Joda-Time值类型。

以下示例使用@DateTimeFormat将java.util.Date格式化为ISO日期（yyyy-MM-dd）：

public class MyModel {

    @DateTimeFormat(iso=ISO.DATE)
    private Date date;
}

3.5.3。FormatterRegistrySPI

FormatterRegistry是用于注册formatters和converters的SPI。 FormattingConversionService是适用于大多数环境的FormatterRegistry的实现。您可以通过编程方式或声明方式将此变体配置为Spring Bean，例如通过使用FormattingConversionServiceFactoryBean。由于此实现还实现了ConversionService，因此您可以直接将其配置为与Spring的DataBinder和Spring表达式语言（SpEL）一起使用。

以下清单显示了FormatterRegistry SPI：

package org.springframework.format;

public interface FormatterRegistry extends ConverterRegistry {

    void addFormatterForFieldType(Class<?> fieldType, Printer<?> printer, Parser<?> parser);

    void addFormatterForFieldType(Class<?> fieldType, Formatter<?> formatter);

    void addFormatterForFieldType(Formatter<?> formatter);

    void addFormatterForAnnotation(AnnotationFormatterFactory<?> factory);
}

如前面的清单所示，您可以按字段类型或批注注册格式化程序。

FormatterRegistry SPI使您可以集中配置格式设置规则，而不必在控制器之间复制此类配置。例如，您可能要强制所有日期字段以某种方式设置格式或带有特定注释的字段以某种方式设置格式。使用共享的FormatterRegistry，您可以一次定义这些规则，并在需要格式化时应用它们。

3.5.4。FormatterRegistrar SPI

FormatterRegistrar是用于通过FormatterRegistry注册格式器和转换器的SPI。以下清单显示了其接口定义：

package org.springframework.format;

public interface FormatterRegistrar {

    void registerFormatters(FormatterRegistry registry);
}

为给定的格式类别（例如日期格式）注册多个相关的转换器和格式器时，FormatterRegistrar很有用。在声明式注册不充分的情况下它也很有用。例如，当格式化程序需要在不同于其自身<T>的特定字段类型下进行索引时，或者在注册Printer/Parser对时。下一节将提供有关转换器和格式化程序注册的更多信息。

3.5.5。在Spring MVC中配置格式

参见Spring MVC一章中的转换和格式化。

3.6。配置全局日期和时间格式

默认情况下，@DateTimeFormat使用DateFormat.SHORT样式从字符串转换未注释的日期和时间字段。如果愿意，可以通过定义自己的全局格式来更改此设置。

为此，您需要确保Spring不注册默认格式器。相反，您应该手动注册所有格式化程序。使用 org.springframework.format.datetime.joda.JodaTimeFormatterRegistrar或 org.springframework.format.datetime.DateFormatterRegistrar类，具体取决于您是否使用Joda-Time库

例如，以下Java配置注册全局yyyyMMdd 格式（此示例不依赖于Joda-Time库）：

@Configuration
public class AppConfig {

    @Bean
    public FormattingConversionService conversionService() {

        // Use the DefaultFormattingConversionService but do not register defaults
        DefaultFormattingConversionService conversionService = new DefaultFormattingConversionService(false);

        // Ensure @NumberFormat is still supported
        conversionService.addFormatterForFieldAnnotation(new NumberFormatAnnotationFormatterFactory());

        // Register date conversion with a specific global format
        DateFormatterRegistrar registrar = new DateFormatterRegistrar();
        registrar.setFormatter(new DateFormatter("yyyyMMdd"));
        registrar.registerFormatters(conversionService);

        return conversionService;
    }
}

如果您喜欢基于XML的配置，则可以使用 FormattingConversionServiceFactoryBean。以下示例显示了如何执行此操作（这次使用Joda Time）：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd>

    <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
        <property name="registerDefaultFormatters" value="false" />
        <property name="formatters">
            <set>
                <bean class="org.springframework.format.number.NumberFormatAnnotationFormatterFactory" />
            </set>
        </property>
        <property name="formatterRegistrars">
            <set>
                <bean class="org.springframework.format.datetime.joda.JodaTimeFormatterRegistrar">
                    <property name="dateFormatter">
                        <bean class="org.springframework.format.datetime.joda.DateTimeFormatterFactoryBean">
                            <property name="pattern" value="yyyyMMdd"/>
                        </bean>
                    </property>
                </bean>
            </set>
        </property>
    </bean>
</beans>

Joda-Time提供了单独的不同类型来表示日期，时间和日期时间值。 JodaTimeFormatterRegistrar的dateFormatter，timeFormatter和dateTimeFormatter属性应用于为每种类型配置不同的格式。 DateTimeFormatterFactoryBean提供了一种创建formatter的便捷方法。

如果使用Spring MVC，请记住显式配置所使用的转换服务。对于基于Java的@Configuration，这意味着扩展WebMvcConfigurationSupport类并覆盖mvcConversionService()方法。对于XML，应使用mvc:annotation-driven元素的conversion-service属性。

3.7. Spring Validation

Spring 3对其验证支持进行了一些增强。首先，完全支持JSR-303 Bean验证API。其次，当以编程方式使用时，Spring的DataBinder可以验证对象并绑定到它们。第三，Spring MVC支持声明式验证@Controller输入。

3.7.1。JSR-303 Bean验证API概述

有关JSR-303和JSR-349的一般信息，请访问Bean Validation网站。有关默认参考实现的特定功能的信息，请参见Hibernate Validator文档。要学习如何将bean验证提供程序设置为Spring bean，请继续阅读。

Bean Validation网站

Hibernate Validator文档

3.7.2。配置Bean验证提供程序

Spring提供了对Bean验证API的全面支持。这包括对将JSR-303或JSR-349 Bean验证提供程序引导为Spring Bean的便捷支持。这使您可以在应用程序中需要验证的任何地方注入javax.validation.ValidatorFactory或javax.validation.Validator。

您可以使用LocalValidatorFactoryBean将默认的Validator配置为Spring Bean，如以下示例所示：

<bean id="validator"
    class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean"/>

前面示例中的基本配置触发Bean验证以使用其默认引导机制进行初始化。诸如Hibernate Validator之类的JSR-303或JSR-349提供程序应预期存在于类路径中并被自动检测到。

注入验证器

LocalValidatorFactoryBean同时实现javax.validation.ValidatorFactory和javax.validation.Validator以及Spring的org.springframework.validation.Validator。您可以将对这些接口之一的引用注入需要调用验证逻辑的bean中。

如果您希望直接使用Bean Validation API，则可以注入对javax.validation.Validator的引用，如以下示例所示：

import javax.validation.Validator;

@Service
public class MyService {

    @Autowired
    private Validator validator;
}

如果您的bean需要使用Spring Validation API，则可以注入对org.springframework.validation.Validator的引用，如以下示例所示：

import org.springframework.validation.Validator;

@Service
public class MyService {

    @Autowired
    private Validator validator;
}

配置自定义约束

每个bean验证约束由两部分组成：@Constraint注释，用于声明约束及其可配置属性。 javax.validation.ConstraintValidator接口的实现，用于实现约束的行为。

要将声明与实现相关联，每个@Constraint批注都引用一个对应的ConstraintValidator实现类。在运行时，当在域模型中遇到约束注释时，ConstraintValidatorFactory实例化引用的实现。

默认情况下，LocalValidatorFactoryBean配置一个SpringConstraintValidatorFactory，该工厂使用Spring创建ConstraintValidator实例。这使您的自定义ConstraintValidators像其他任何Spring bean一样受益于依赖项注入。

以下示例显示了一个自定义@Constraint声明，后跟一个关联的ConstraintValidator实现，该实现使用Spring进行依赖项注入：

@Target({ElementType.METHOD, ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy=MyConstraintValidator.class)
public @interface MyConstraint {
}

--------------------------------------------------

import javax.validation.ConstraintValidator;

public class MyConstraintValidator implements ConstraintValidator {

    @Autowired;
    private Foo aDependency;

    // ...
}

如前面的示例所示，ConstraintValidator实现可以像其他任何Spring bean一样具有其@Autowired依赖项。

Spring 驱动方法验证

您可以通过MethodValidationPostProcessor Bean定义将Bean Validation 1.1（以及作为自定义扩展，还包括Hibernate Validator 4.3）支持的方法验证功能通过MethodValidationPostProcessor bean定义集成到Spring上下文中，如下所示：

<bean class="org.springframework.validation.beanvalidation.MethodValidationPostProcessor"/>

为了有资格通过Spring驱动的方法验证，所有目标类都必须使用Spring的@Validated注释进行注释。（可选地，您也可以声明要使用的验证组。）有关Hibernate Validator和Bean Validation 1.1提供程序的设置详细信息，请参见MethodValidationPostProcessor javadoc。

其他配置选项

在大多数情况下，默认LocalValidatorFactoryBean配置就足够了。从消息插值到遍历解析，有许多用于各种Bean验证构造的配置选项。有关这些选项的更多信息，请参见LocalValidatorFactoryBean Javadoc。

3.7.3。配置一个DataBinder

从Spring 3开始，您可以使用Validator配置DataBinder实例。配置完成后，您可以通过调用binder.validate()来调用Validator。任何验证错误都会自动添加到binder的BindingResult中。

下面的示例演示如何在绑定到目标对象后，以编程方式使用DataBinder来调用验证逻辑：

Foo target = new Foo();
DataBinder binder = new DataBinder(target);
binder.setValidator(new FooValidator());

// bind to the target object
binder.bind(propertyValues);

// validate the target object
binder.validate();

// get BindingResult that includes any validation errors
BindingResult results = binder.getBindingResult();

您还可以通过dataBinder.addValidators和dataBinder.replaceValidators配置具有多个Validator实例的DataBinder。当将全局配置的bean验证与在DataBinder实例上本地配置的Spring Validator结合使用时，这很有用。请参阅[validation-mvc-configuring]。

3.7.4. Spring MVC 3 Validation

文档链接

以上是关于20200103 Spring官方文档（Core 3）的主要内容，如果未能解决你的问题，请参考以下文章

20200105 Spring官方文档（Core 4）

20191224 Spring官方文档（Core 1.1-1.4）

20191226 Spring官方文档（Core 1.10）

20191225 Spring官方文档（Core 1.6-1.8）

20191225 Spring官方文档（Core 1.5）

如何使用 spring-security-core-ldap 插件在 grails 中实现 LDAP 身份验证？