1 Formatting

在Spring中用于格式化数据及根据地域展示不同格式的数据。

图 Formatting接口 UML

1.1 注解驱动Formatting

自定义像“@DateTimeFormat”注解来对相关字段格式化的步骤为：

1. 自定义注解。
2. 定义一个实现AnnotationFormatterFactory接口的工厂类。
3. 往容器注册步骤二创建的工厂类。

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface CustomTimeFormatter {
}

public class CustomTimeFormatterAnnotationFormatterFactory implements AnnotationFormatterFactory<CustomTimeFormatter> {

    private final SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd mm:hh");

    @Override
    public Set<Class<?>> getFieldTypes() {
        Set<Class<?>> classSet = new HashSet<>();
        classSet.add(String.class);
        return classSet;
    }

    @Override
    public Printer<?> getPrinter(CustomTimeFormatter annotation, Class<?> fieldType) {
        return new Printer<Date>() {
            @Override
            public String print(Date date, Locale locale) {
                return dateFormat.format(date);
            }
        };
    }

    @Override
    public Parser<?> getParser(CustomTimeFormatter annotation, Class<?> fieldType) {
        return new Parser<Date>() {
            @Override
            public Date parse(String text, Locale locale) throws ParseException {
                return dateFormat.parse(text);
            }
        };
    }
}

1.2 FormatterRegistry

继承于ConverterRegistry，是用来注册Formatter及Converter的接口。

图 FormatterRegistry

1.2.1 FormatterRegistry 的实现

图 FormattingConversionService

FormattingConversionService 是FormatterRegistry 的默认实现，其继承于GenericConversionService。该类主要工作是把Formatter 注册 转化为PrinterConverter 和ParserConverter两种转化的注册。通过其PrinterConverter、ParserConverter、AnnotationPrinterConverter及AnnotationParserConverter等内部类，把Formatter的Printer及Parser 转化成GenericConverter或ConditionalGenericConverter。

private static class ParserConverter implements GenericConverter {

		private final Class<?> fieldType;

		private final Parser<?> parser;

		private final ConversionService conversionService;

		public ParserConverter(Class<?> fieldType, Parser<?> parser, ConversionService conversionService) {
			this.fieldType = fieldType;
			this.parser = parser;
			this.conversionService = conversionService;
		}

		@Override
		public Set<ConvertiblePair> getConvertibleTypes() {
			return Collections.singleton(new ConvertiblePair(String.class, this.fieldType));
		}

		@Override
		@Nullable
		public Object convert(@Nullable Object source, TypeDescriptor sourceType, TypeDescriptor targetType) {
			String text = (String) source;
			if (!StringUtils.hasText(text)) {
				return null;
			}
			Object result;
			try {
				result = this.parser.parse(text, LocaleContextHolder.getLocale());
			}
			catch (IllegalArgumentException ex) {
				throw ex;
			}
			catch (Throwable ex) {
				throw new IllegalArgumentException("Parse attempt failed for value [" + text + "]", ex);
			}
			TypeDescriptor resultType = TypeDescriptor.valueOf(result.getClass());
			if (!resultType.isAssignableTo(targetType)) {
				result = this.conversionService.convert(result, resultType, targetType);
			}
			return result;
		}

		@Override
		public String toString() {
			return (String.class.getName() + " -> " + this.fieldType.getName() + ": " + this.parser);
		}
	}

1.3 FormattingConversionServiceFactoryBean

用于创建默认的FormattingConversionService，及配置自定义Formatter及Conversion。

而FormatterRegistar 这是Formatter注册器。用于为FormatterRegistry注册Formatter。

2 Validation

org.springframework.validation.Validator 是用来验证对象实例属性的接口。

图 Spring Validator UML

JSR 303（Bean Validation） 规范定义了一套用于JavaBean参数校验的标准。javax.validation.Validator 也是用于对指定的对象进行校验。

图 JSR 303 Validator UML

2.1 SpringValidatorAdapter 适配器模式

图 SpringValidatorAdapter UML

该适配器使用JSR 的Validator 来适配Spring 的Validator，其同时实现了JSR与Spring的Validator的接口。（即是对象适配器也是类适配器。）

2.1.1 自定义Validator注解

步骤为：1）自定义Constraint注解（该注解需要有@Constraint注解来标识校验类）。2）自定义校验类并实现ConstraintValidator接口。

图 ConstraintValidator UML

javax.validation.ConstraintValidator 是 Java Bean Validation 规范（JSR 303/JSR 380）中的一个核心接口。该接口用于实现自定义的约束验证逻辑。当你创建一个自定义的验证注解时，你需要提供一个实现了 ConstraintValidator 接口的类来定义如何验证该注解所标注的元素。

2.1.2 ConstraintValidator 与 Validator的关系

ConstraintValidator 是验证逻辑（比如自定义验证注解）的具体实现。而javax.validation.Validator 则是用来执行这些验证逻辑。

当需要对某个字段进行验证时，javax.validation.Validator  会找到这个字段所有的ConstraintValidator ，并执行其isValid方法。

2.1.3 LocalValidatorFactoryBean

图 LocalValidatorFactoryBean UML

是在Spring 上下文中使用JSR 的Validator的核心类。 其继承于Spring 及JSR Validator的适配器，并实现了Validator 工厂类接口（能创建已初始化的的Validator）。

可以用来在Spring中定义默认的Validator：

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